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

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

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

Основная структура

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

Личность – Кто агент и как он действует

Окружение – Контекст, в котором он работает

Тон – Стиль коммуникации

Цель – Что агент пытается достичь

Ограничения – Что агент не должен делать

Инструменты – К чему он может получить доступ и как

1. Личность

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

Включите:

Имя и роль

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

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

Пример: "Вы эмпатичны, прямолинейны, любопытны и всегда сосредоточены на ясности."

Поведенческие якоря

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

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

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

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

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

2. Окружение

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

Укажите:

Платформу/канал (чат, веб-приложение, встроенный виджет и т.д.)

Ограничения (например, "вы не можете видеть экран пользователя")

Состояние пользователя (например, "пользователь может быть расстроен из-за недавних неудач")

Пример – Окружение технической поддержки:

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

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

3. Тон

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

Определите:

Уровень формальности и типичную длину предложений

Использование подтверждений ("Понятно", "Это имеет смысл")

Использовать ли слова-заполнители, хеджирование и т.д.

Адаптацию тона к эмоциональному состоянию пользователя или техническому фону

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

Ваши ответы четкие, краткие и ориентированные на решение.
Вы используете подтверждения вроде "Я понимаю" или "Отличный вопрос" для поддержания потока.
Вы адаптируете технический язык в зависимости от знакомости пользователя.
Если обнаружено разочарование, кратко признайте его перед возвращением к решению проблем.
Держите ответы в пределах трех предложений, если дополнительные детали не критичны.

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

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

4. Цель

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

Уточните:

Основную цель (например, "помочь пользователям завершить запросы на возврат")

Последовательную логику (пошаговые процессы, контрольные точки, ветвления)

Критерии завершения

Запасные варианты, если цели не могут быть достигнуты

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

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

Пример – Цель агента технической диагностики:

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

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

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

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

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

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

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

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

Включите:

Что избегать обсуждать (например, конкуренты, политика, неподдерживаемые функции)

Как обрабатывать неизвестное ("Скажите 'Я не уверен' вместо угадывания")

Лимиты на юмор, смену тона или выход из роли

Правила эскалации или когда сказать "Я не могу помочь с этим"

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

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

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

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

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

Определите:

Список инструментов с однострочными сводками назначения

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

Что сказать до/после вызова инструмента

Порядок вызова инструментов и запасные пути

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

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

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

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

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

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

Используйте заголовки в стиле Markdown: # Личность, # Инструменты и т.д.

Предпочитайте маркированные списки для логики

Используйте простые условия: "Если отсутствует, спросите. Если присутствует, продолжайте."

Разбивайте длинные инструкции на блоки

Избегайте излишней многословности

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

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

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

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

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

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

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

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