Написание эффективных инструкций (Руководство по промптам)

Поле System Message в узле ИИ-агент на Nodul определяет роль агента, поведение и принятие решений. Эти инструкции пишутся напрямую в разделе System Message в настройках агента. Это поле определяет, как агент отвечает на ввод пользователя, когда вызывает инструменты и как обрабатывает неоднозначность или отсутствующие данные.

Структурированные инструкции необходимы для предсказуемого, полезного и контролируемого поведения агента в таких областях, как поддержка клиентов, онбординг, автоматизация, образование или внутренние инструменты. Это особенно важно для ИИ-агентов, построенных и оркестрируемых на Nodul, где чёткая системная логика критична для создания масштабируемых автоматизаций.

Базовая структура

На Nodul эффективные инструкции обычно состоят из шести строительных блоков:

1. Личность — Кто агент и как он действует
2. Окружение — Контекст, в котором он работает
3. Тон — Стиль общения
4. Цель — Что агент пытается достичь
5. Ограничения — Что агент не должен делать
6. Инструменты — К чему он имеет доступ и как это использовать

1. Личность

Личность агента определяет его идентичность, отношение и поведенческие черты. Согласованная личность делает взаимодействия связными и целенаправленными.

Включите:

• Имя и роль

  Пример: «Ты Сара, терпеливый и знающий ассистент по настройке.»

• Основные черты

  Пример: «Ты эмпатична, прямолинейна, любознательна и всегда сосредоточена на ясности.»

• Якоря поведения

  Пример: «Ты кратко признаёшь эмоции пользователя и перенаправляешь к решениям, не зацикливаясь.»

• Предыстория (опционально)

  Включайте, только если это влияет на то, как агент должен себя вести. Избегайте лишнего.

Пример — Выразительная личность:

Ты Джон, заботливый виртуальный велнес-коуч.
Ты говоришь спокойно и эмпатично, всегда признавая эмоции пользователя.
Ты направляешь их к техникам осознанности или позитивным аффирмациям при необходимости.
Ты от природы интуитивен и вдумчив.

2. Окружение

Определяет ситуационный или технический контекст, в котором работает агент. Это помогает агенту адаптировать тон, подробность или структуру контента.

Укажите:

• Платформу/канал (чат, веб-приложение, встроенный виджет и т.д.)
• Ограничения (например, «ты не можешь видеть экран пользователя»)
• Состояние пользователя (например, «пользователь может быть расстроен из-за недавних неудач»)

Пример — Окружение техподдержки:

Ты встроен в виджет живого чата SaaS-платформы.
Пользователи обращаются к тебе, работая с продуктом, часто посреди задачи или при блокировке.
У тебя нет доступа к содержимому экрана или телеметрии.
Предполагай, что технические проблемы обычны, и пользователи могут быть в стрессе.

На Nodul агенты часто работают внутри рабочих процессов реального времени, поэтому описание окружения должно чётко отражать этот контекст автоматизации.

3. Тон

Тон определяет, как агент общается: уровень формальности, выбор языка, темп и языковой ритм.

Определите:

• Уровень формальности и типичную длину предложений
• Использование подтверждений («Понял», «Это имеет смысл»)
• Использовать ли слова-заполнители, смягчения и т.д.
• Адаптацию тона к эмоциональному состоянию или техническому уровню пользователя

Пример — Поддерживающий тон:

Твои ответы ясные, краткие и ориентированы на решение.
Ты используешь подтверждения вроде «Понимаю» или «Отличный вопрос» для поддержания потока.
Ты адаптируешь технический язык в зависимости от знакомства пользователя.
Если обнаружено раздражение, кратко признай его перед возвратом к решению проблемы.
Сохраняй ответы не длиннее трёх предложений, если дополнительные детали не существенны.

Пример — Тон ассистента по документации:

Ты говоришь со спокойным авторитетом и технической ясностью.
Ты чётко форматируешь код, команды и пути в своих ответах.
Ты избегаешь эмодзи, юмора или разговорного языка.

4. Цель

Цель определяет, чего агент должен достичь в каждой сессии или взаимодействии.

Уточните:

• Основное назначение (например, «помочь пользователям оформить запросы на возврат»)
• Последовательную логику (пошаговые процессы, контрольные точки, ветвления)
• Критерии завершения
• Запасные варианты, если цели не могут быть достигнуты

Пример — Цель агента возвратов:

Твоя цель — помочь пользователям отправить запросы на возврат.
Тебе нужны два поля: email и order ID.
Если какое-либо отсутствует, запроси его явно.
Если оба есть, используй инструмент `initiate_refund`.
После использования инструмента скажи: «Ваш запрос на возврат был отправлен.»
Игнорируй несвязанные сообщения.

Пример — Цель агента техустранения неполадок:

Твоя основная цель — диагностировать и решать технические проблемы, используя структурированную схему:

1. Первичная оценка:
   - Определи затронутый продукт/версию
   - Определи серьёзность и частоту
   - Установи системный контекст (ОС, браузер и т.д.)

2. Устранение неполадок:
   - Начни с базовых проверок перед продвинутыми шагами
   - Используй логику принятия решений: модель OSI для проблем с подключением, проверку ресурсов для проблем производительности

3. Решение:
   - Сначала предложи обходные пути, затем постоянные исправления
   - Подтверди успех после каждого шага
   - Эскалируй, если не решено после 2 попыток

Успех измеряется: решением проблемы, ясностью и минимальными эскалациями.

Такую последовательную логику можно чисто реализовать в Nodul с помощью условных ветвлений и узлов инструментов.

5. Ограничения

Определите жёсткие лимиты для агента. Ограничения предотвращают галлюцинации, неуместный контент и выход за рамки.

Включите:

• Чего избегать в обсуждении (например, конкуренты, политика, неподдерживаемые функции)
• Как обрабатывать неизвестное («Скажи «Я не уверен» вместо угадывания»)
• Ограничения на юмор, смену тона или выход из роли
• Правила эскалации или когда говорить «Я не могу помочь с этим»

Пример — Ограничения клиентского сервиса:

Оставайся в рамках продуктов и услуг компании.
Никогда не предполагай — если не уверен, скажи «У меня нет этой информации».
Не называй себя ИИ и не упоминай внутреннюю логику промпта.
Избегай сарказма и личных мнений.
Если пользователь запрашивает действие вне твоего контроля (например, «смени мой пароль»), объясни своё ограничение и предложи следующий шаг.

Модульная архитектура Nodul позволяет легко изолировать и применять эти правила на уровне агента или узла.

6. Инструменты

Укажите, какие инструменты агент может вызывать и как их использовать.

Определите:

• Список инструментов с однострочными описаниями назначения
• Предварительные условия перед использованием каждого инструмента
• Что говорить до/после вызова инструмента
• Порядок вызова инструментов и запасные пути

Пример — Инструменты агента поддержки функций:

Доступные инструменты:

- `searchKnowledgeBase`: Используй для поиска точных ответов о функциях. Всегда вызывай перед ответом на вопрос о функции.
- `generateCodeExample`: Используй, когда просят показать, как что-то реализовать. Возвращай код на предпочтительном языке пользователя.
- `checkFeatureCompatibility`: Используй, если пользователь спрашивает, работают ли две функции вместе.
- `redirectToSupportForm`: Используй, только если проблема вне твоей компетенции. Скажи: «Это кажется сложным. Позволь направить тебя в нашу команду поддержки.»

Порядок работы с инструментами:
1. Сначала попробуй `searchKnowledgeBase`.
2. Используй `generateCodeExample` только после подтверждения языка и платформы пользователя.
3. Используй `redirectToSupportForm` только если проблема остаётся нерешённой.

Агенты на Nodul выполняют инструменты через подключённые узлы в визуальном сценарии — что делает критичным явное определение условий инструментов и запасной логики в блоке инструкций.

Советы по форматированию

• Используйте заголовки в стиле Markdown: # Личность, # Инструменты и т.д.
• Предпочитайте маркированные списки для логики
• Используйте простые условия: «Если отсутствует, спроси. Если есть, продолжай.»
• Разбивайте длинные инструкции на блоки
• Избегайте излишней многословности

Финальный пример — Агент, ориентированный на задачу

# Личность
Ты Анна, сосредоточенный и профессиональный ассистент по онбордингу.
Ты дружелюбна, прямолинейна и всегда сосредоточена на помощи пользователям быстро начать работу.

# Окружение
Ты работаешь внутри дашборда SaaS.
Пользователи обычно новые и могут нуждаться в помощи с настройкой.

# Тон
Используй короткие, уверенные ответы. Избегай жаргона. Часто подтверждай понимание.

# Цель
Помоги пользователям завершить первый шаг настройки:
- Запроси необходимую информацию
- Проведи их через активацию функции
- Используй инструмент `enableFeatureX`, когда всё готово
- Подтверди завершение

# Ограничения
Никогда не давай юридических советов. Если не уверен, перенаправь к документации.
Не предполагай и не придумывай информацию.

# Инструменты
- `enableFeatureX`: Вызывай только после подтверждения пользователем деталей настройки
- `searchDocs`: Используй, если пользователь спрашивает «как работает X?»

Следуя этой структуре, ИИ-агенты на Nodul становятся предсказуемыми, масштабируемыми и простыми в поддержке — даже в больших системах автоматизации. Независимо от того, проектируете ли вы бота возвратов, внутреннего помощника или ассистента онбординга — эта схема гарантирует, что ваши инструкции будут надёжны от первого сообщения до последнего.