Агентский workflow отличается от обычного чата тем, что модель не просто отвечает, а планирует шаги, вызывает инструменты, хранит состояние и решает, когда нужен человек. Ниже — 10 промптов-шаблонов для практической сборки таких сценариев. Их нельзя считать универсально правильными: результат зависит от модели, доступных инструментов, качества входных данных и правил вашей системы. Любой вывод ИИ требует человеческой проверки, особенно если действие влияет на деньги, данные клиентов или публикации.
Как выбрать промпт
| Задача | Подходит | Главный риск |
|---|---|---|
| Разбить цель на шаги | Промпт 1 | План без проверок |
| Выбрать API или tool | Промпт 2 | Лишний вызов инструмента |
| Вести состояние | Промпт 3 | Потеря контекста |
| Запросить подтверждение | Промпт 4 | Автоматическое опасное действие |
| Обработать сбой | Промпт 5 | Бесконечные повторы |
| Проверить входные данные | Промпт 6 | Галлюцинации вместо уточнений |
| Свести результаты tools | Промпт 7 | Смешение фактов и предположений |
| Передать задачу человеку | Промпт 8 | Поздняя эскалация |
| Записать журнал действий | Промпт 9 | Невоспроизводимость |
| Финальная проверка | Промпт 10 | Преждевременное завершение |
Планирование и выбор инструментов
Промпт 1
Когда использовать: в начале агентского процесса, когда есть цель, но нет последовательности действий.
Ты агент-планировщик. Цель: {цель}. Ограничения: {ограничения}. Доступные инструменты: {инструменты}. Составь план максимум из {N} шагов. Для каждого шага укажи: действие, нужен ли tool-call, входные данные, критерий успеха, условие остановки. Не выполняй действия, только планируй.
Переменные: {цель}, {ограничения}, {инструменты}, {N}. Ожидаемый вывод: нумерованный план с критериями. Проверка качества: каждый шаг проверяем и не требует скрытых данных. Частый сбой: модель сразу предлагает финальный ответ вместо плана.
Промпт 2
Когда использовать: перед вызовом API, поиском, CRM, базы данных или другого инструмента.
Реши, нужен ли вызов инструмента для задачи: {задача}. Инструменты: {список_tools}. Если инструмент нужен, выбери один, объясни причину, подготовь аргументы в формате ключ: значение. Если данных недостаточно, задай один уточняющий вопрос. Не выдумывай результаты инструмента.
Переменные: {задача}, {список_tools}. Ожидаемый вывод: решение «вызывать/не вызывать», выбранный tool и аргументы. Проверка качества: аргументы соответствуют схеме инструмента. Частый сбой: выбор дорогого или внешнего tool там, где хватает контекста.
Состояния, память и входные данные
Промпт 3
Когда использовать: после каждого шага workflow, чтобы не потерять контекст.
Обнови состояние задачи. Текущее состояние: {state}. Последнее действие: {action}. Наблюдение или результат: {observation}. Верни только: краткое состояние, выполненные шаги, открытые вопросы, следующие допустимые действия, риски.
Переменные: {state}, {action}, {observation}. Ожидаемый вывод: компактная карточка состояния. Проверка качества: нет противоречий с предыдущими фактами. Частый сбой: включение в состояние неподтвержденных предположений.
Промпт 4
Когда использовать: перед отправкой письма, платежом, публикацией, удалением, изменением прав или записью в CRM.
Проверь, требует ли действие подтверждения человека. Действие: {действие}. Последствия: {последствия}. Политики: {политики}. Если риск низкий — объясни почему. Если риск средний или высокий — сформируй запрос подтверждения с кратким резюме, данными для проверки и вариантами: подтвердить, изменить, отменить.
Переменные: {действие}, {последствия}, {политики}. Ожидаемый вывод: решение по подтверждению и текст запроса. Проверка качества: пользователь понимает, что именно будет сделано. Частый сбой: слишком общее «подтвердите действие» без деталей.
Промпт 5
Когда использовать: когда tool вернул ошибку, таймаут, пустой ответ или конфликт данных.
Обработай сбой инструмента. Инструмент: {tool}. Запрос: {request}. Ошибка: {error}. Попытка номер: {attempt}. Лимит попыток: {limit}. Выбери стратегию: повторить, изменить запрос, использовать альтернативный инструмент, запросить человека, безопасно остановиться. Объясни коротко и дай следующий шаг.
Переменные: {tool}, {request}, {error}, {attempt}, {limit}. Ожидаемый вывод: стратегия восстановления. Проверка качества: есть предел повторов и безопасная остановка. Частый сбой: бесконечный retry без изменения условий.
Валидация и интерпретация результатов
Промпт 6
Когда использовать: до старта workflow, если входные данные неполные или неоднозначные.
Проверь входные данные для задачи: {задача}. Данные: {данные}. Найди пропуски, неоднозначности и поля, которые нельзя проверять без внешнего источника. Верни: что можно делать сейчас, что нужно уточнить, один самый важный вопрос пользователю.
Переменные: {задача}, {данные}. Ожидаемый вывод: список блокеров и один вопрос. Проверка качества: вопрос действительно разблокирует следующий шаг. Частый сбой: модель задает много вопросов вместо одного приоритетного.
Промпт 7
Когда использовать: после нескольких tool-call, когда нужно собрать факты без искажений.
Сведи результаты инструментов. Результаты: {tool_results}. Раздели вывод на: подтвержденные факты, противоречия, вероятные предположения, что нельзя утверждать. Не добавляй сведений, которых нет в результатах. Для каждого ключевого факта укажи источник из результатов.
Переменные: {tool_results}. Ожидаемый вывод: структурированная сводка. Проверка качества: каждый факт привязан к источнику. Частый сбой: красивая, но недоказанная интерпретация.
Эскалация, аудит и завершение
Промпт 8
Когда использовать: если агент уперся в риск, нехватку прав, конфликт инструкций или неуверенность.
Оцени, нужно ли передать задачу человеку. Контекст: {контекст}. Проблема: {проблема}. Возможные действия агента: {действия}. Если нужна эскалация, подготовь короткую записку: что произошло, что уже проверено, какие варианты решения, какой выбор требуется от человека.
Переменные: {контекст}, {проблема}, {действия}. Ожидаемый вывод: решение об эскалации и записка. Проверка качества: человеку не нужно перечитывать весь лог. Частый сбой: агент продолжает действовать при явном конфликте правил.
Промпт 9
Когда использовать: для аудита, отладки и последующего анализа качества агента.
Сформируй журнал шага workflow. Шаг: {step}. Вход: {input}. Решение агента: {decision}. Вызванный инструмент: {tool_or_none}. Результат: {result}. Следующее состояние: {next_state}. Запиши кратко, без персональных данных сверх необходимых для аудита.
Переменные: {step}, {input}, {decision}, {tool_or_none}, {result}, {next_state}. Ожидаемый вывод: воспроизводимый лог. Проверка качества: по журналу понятно, почему принято решение. Частый сбой: лог превращается в пересказ без решений и параметров.
Промпт 10
Когда использовать: перед финальным ответом пользователю или завершением автоматизации.
Проведи финальную проверку workflow. Цель: {цель}. План: {план}. Выполненные шаги: {шаги}. Состояние: {state}. Проверь: достигнута ли цель, есть ли неподтвержденные действия, ошибки tools, открытые вопросы, необходимость человеческой проверки. Верни итог: завершить, продолжить или эскалировать.
Переменные: {цель}, {план}, {шаги}, {state}. Ожидаемый вывод: решение о завершении и список остаточных рисков. Проверка качества: нет незакрытых критичных пунктов. Частый сбой: агент объявляет успех, хотя часть шагов не выполнена.
Как внедрять эти промпты
- Начинайте с одного простого workflow и логируйте каждый вызов инструмента.
- Разделяйте роли: планировщик, исполнитель, проверяющий и обработчик сбоев.
- Определите действия, которые всегда требуют подтверждения человека.
- Храните состояние отдельно от длинной переписки, чтобы снижать шум.
- Тестируйте на ошибках: пустой ответ API, неверный формат, дубликаты, конфликт данных.
Launch checklist
- Описаны доступные tools и их схемы аргументов.
- Есть лимит повторов и правило безопасной остановки.
- Опасные действия требуют подтверждения.
- Состояние обновляется после каждого важного шага.
- Финальный ответ отделяет факты от предположений.
- Логи не содержат лишних персональных данных.
- Человек проверяет результаты перед внешней отправкой или публикацией.
FAQ
Можно ли использовать один промпт для всего агента? Можно, но обычно надежнее разбить workflow на промпты для планирования, tool-calling, состояния и проверки.
Нужно ли просить модель объяснять каждый tool-call? Для продакшена полезно иметь краткое обоснование в журнале, но не обязательно показывать его пользователю.
Почему агент ошибается даже с хорошим промптом? Промпт не заменяет тестирование, валидацию данных, ограничения прав и человеческий контроль.
Источники и ограничения
Материал подготовлен как практический редакционный шаблон COMRAD404, а не как гарантия корректной работы конкретной модели. Полезные справочные материалы: OpenAI: best practices for prompting, Zapier: AI prompt templates, Zapier: prompting in products. Вывод ИИ требует human review и зависит от модели, системных инструкций, доступных инструментов и входных данных.