Топ-10 промптов для агентских workflow и tool-calling

<p>Агентский workflow отличается от обычного чата тем, что модель не просто отвечает, а планирует шаги, вызывает инструменты, хранит состояние и решает, когда нужен человек. Ниже — 10 промптов-шаблонов для практической сборки таких сценариев. Их нельзя считать универсально правильными: результат зависит от модели, доступных инструментов, качества входных данных и правил вашей системы. Любой вывод ИИ требует человеческой проверки, особенно если действие влияет на деньги, данные клиентов или публикации.</p><h2>Как выбрать промпт</h2><table><thead><tr><th>Задача</th><th>Подходит</th><th>Главный риск</th></tr></thead><tbody><tr><td>Разбить цель на шаги</td><td>Промпт 1</td><td>План без проверок</td></tr><tr><td>Выбрать API или tool</td><td>Промпт 2</td><td>Лишний вызов инструмента</td></tr><tr><td>Вести состояние</td><td>Промпт 3</td><td>Потеря контекста</td></tr><tr><td>Запросить подтверждение</td><td>Промпт 4</td><td>Автоматическое опасное действие</td></tr><tr><td>Обработать сбой</td><td>Промпт 5</td><td>Бесконечные повторы</td></tr><tr><td>Проверить входные данные</td><td>Промпт 6</td><td>Галлюцинации вместо уточнений</td></tr><tr><td>Свести результаты tools</td><td>Промпт 7</td><td>Смешение фактов и предположений</td></tr><tr><td>Передать задачу человеку</td><td>Промпт 8</td><td>Поздняя эскалация</td></tr><tr><td>Записать журнал действий</td><td>Промпт 9</td><td>Невоспроизводимость</td></tr><tr><td>Финальная проверка</td><td>Промпт 10</td><td>Преждевременное завершение</td></tr></tbody></table><h2>Планирование и выбор инструментов</h2><h3>Промпт 1</h3><p><strong>Когда использовать:</strong> в начале агентского процесса, когда есть цель, но нет последовательности действий.</p><blockquote>Ты агент-планировщик. Цель: {цель}. Ограничения: {ограничения}. Доступные инструменты: {инструменты}. Составь план максимум из {N} шагов. Для каждого шага укажи: действие, нужен ли tool-call, входные данные, критерий успеха, условие остановки. Не выполняй действия, только планируй.</blockquote><p><strong>Переменные:</strong> {цель}, {ограничения}, {инструменты}, {N}. <strong>Ожидаемый вывод:</strong> нумерованный план с критериями. <strong>Проверка качества:</strong> каждый шаг проверяем и не требует скрытых данных. <strong>Частый сбой:</strong> модель сразу предлагает финальный ответ вместо плана.</p><h3>Промпт 2</h3><p><strong>Когда использовать:</strong> перед вызовом API, поиском, CRM, базы данных или другого инструмента.</p><blockquote>Реши, нужен ли вызов инструмента для задачи: {задача}. Инструменты: {список_tools}. Если инструмент нужен, выбери один, объясни причину, подготовь аргументы в формате ключ: значение. Если данных недостаточно, задай один уточняющий вопрос. Не выдумывай результаты инструмента.</blockquote><p><strong>Переменные:</strong> {задача}, {список_tools}. <strong>Ожидаемый вывод:</strong> решение «вызывать/не вызывать», выбранный tool и аргументы. <strong>Проверка качества:</strong> аргументы соответствуют схеме инструмента. <strong>Частый сбой:</strong> выбор дорогого или внешнего tool там, где хватает контекста.</p><h2>Состояния, память и входные данные</h2><h3>Промпт 3</h3><p><strong>Когда использовать:</strong> после каждого шага workflow, чтобы не потерять контекст.</p><blockquote>Обнови состояние задачи. Текущее состояние: {state}. Последнее действие: {action}. Наблюдение или результат: {observation}. Верни только: краткое состояние, выполненные шаги, открытые вопросы, следующие допустимые действия, риски.</blockquote><p><strong>Переменные:</strong> {state}, {action}, {observation}. <strong>Ожидаемый вывод:</strong> компактная карточка состояния. <strong>Проверка качества:</strong> нет противоречий с предыдущими фактами. <strong>Частый сбой:</strong> включение в состояние неподтвержденных предположений.</p><h3>Промпт 4</h3><p><strong>Когда использовать:</strong> перед отправкой письма, платежом, публикацией, удалением, изменением прав или записью в CRM.</p><blockquote>Проверь, требует ли действие подтверждения человека. Действие: {действие}. Последствия: {последствия}. Политики: {политики}. Если риск низкий — объясни почему. Если риск средний или высокий — сформируй запрос подтверждения с кратким резюме, данными для проверки и вариантами: подтвердить, изменить, отменить.</blockquote><p><strong>Переменные:</strong> {действие}, {последствия}, {политики}. <strong>Ожидаемый вывод:</strong> решение по подтверждению и текст запроса. <strong>Проверка качества:</strong> пользователь понимает, что именно будет сделано. <strong>Частый сбой:</strong> слишком общее «подтвердите действие» без деталей.</p><h3>Промпт 5</h3><p><strong>Когда использовать:</strong> когда tool вернул ошибку, таймаут, пустой ответ или конфликт данных.</p><blockquote>Обработай сбой инструмента. Инструмент: {tool}. Запрос: {request}. Ошибка: {error}. Попытка номер: {attempt}. Лимит попыток: {limit}. Выбери стратегию: повторить, изменить запрос, использовать альтернативный инструмент, запросить человека, безопасно остановиться. Объясни коротко и дай следующий шаг.</blockquote><p><strong>Переменные:</strong> {tool}, {request}, {error}, {attempt}, {limit}. <strong>Ожидаемый вывод:</strong> стратегия восстановления. <strong>Проверка качества:</strong> есть предел повторов и безопасная остановка. <strong>Частый сбой:</strong> бесконечный retry без изменения условий.</p><h2>Валидация и интерпретация результатов</h2><h3>Промпт 6</h3><p><strong>Когда использовать:</strong> до старта workflow, если входные данные неполные или неоднозначные.</p><blockquote>Проверь входные данные для задачи: {задача}. Данные: {данные}. Найди пропуски, неоднозначности и поля, которые нельзя проверять без внешнего источника. Верни: что можно делать сейчас, что нужно уточнить, один самый важный вопрос пользователю.</blockquote><p><strong>Переменные:</strong> {задача}, {данные}. <strong>Ожидаемый вывод:</strong> список блокеров и один вопрос. <strong>Проверка качества:</strong> вопрос действительно разблокирует следующий шаг. <strong>Частый сбой:</strong> модель задает много вопросов вместо одного приоритетного.</p><h3>Промпт 7</h3><p><strong>Когда использовать:</strong> после нескольких tool-call, когда нужно собрать факты без искажений.</p><blockquote>Сведи результаты инструментов. Результаты: {tool_results}. Раздели вывод на: подтвержденные факты, противоречия, вероятные предположения, что нельзя утверждать. Не добавляй сведений, которых нет в результатах. Для каждого ключевого факта укажи источник из результатов.</blockquote><p><strong>Переменные:</strong> {tool_results}. <strong>Ожидаемый вывод:</strong> структурированная сводка. <strong>Проверка качества:</strong> каждый факт привязан к источнику. <strong>Частый сбой:</strong> красивая, но недоказанная интерпретация.</p><h2>Эскалация, аудит и завершение</h2><h3>Промпт 8</h3><p><strong>Когда использовать:</strong> если агент уперся в риск, нехватку прав, конфликт инструкций или неуверенность.</p><blockquote>Оцени, нужно ли передать задачу человеку. Контекст: {контекст}. Проблема: {проблема}. Возможные действия агента: {действия}. Если нужна эскалация, подготовь короткую записку: что произошло, что уже проверено, какие варианты решения, какой выбор требуется от человека.</blockquote><p><strong>Переменные:</strong> {контекст}, {проблема}, {действия}. <strong>Ожидаемый вывод:</strong> решение об эскалации и записка. <strong>Проверка качества:</strong> человеку не нужно перечитывать весь лог. <strong>Частый сбой:</strong> агент продолжает действовать при явном конфликте правил.</p><h3>Промпт 9</h3><p><strong>Когда использовать:</strong> для аудита, отладки и последующего анализа качества агента.</p><blockquote>Сформируй журнал шага workflow. Шаг: {step}. Вход: {input}. Решение агента: {decision}. Вызванный инструмент: {tool_or_none}. Результат: {result}. Следующее состояние: {next_state}. Запиши кратко, без персональных данных сверх необходимых для аудита.</blockquote><p><strong>Переменные:</strong> {step}, {input}, {decision}, {tool_or_none}, {result}, {next_state}. <strong>Ожидаемый вывод:</strong> воспроизводимый лог. <strong>Проверка качества:</strong> по журналу понятно, почему принято решение. <strong>Частый сбой:</strong> лог превращается в пересказ без решений и параметров.</p><h3>Промпт 10</h3><p><strong>Когда использовать:</strong> перед финальным ответом пользователю или завершением автоматизации.</p><blockquote>Проведи финальную проверку workflow. Цель: {цель}. План: {план}. Выполненные шаги: {шаги}. Состояние: {state}. Проверь: достигнута ли цель, есть ли неподтвержденные действия, ошибки tools, открытые вопросы, необходимость человеческой проверки. Верни итог: завершить, продолжить или эскалировать.</blockquote><p><strong>Переменные:</strong> {цель}, {план}, {шаги}, {state}. <strong>Ожидаемый вывод:</strong> решение о завершении и список остаточных рисков. <strong>Проверка качества:</strong> нет незакрытых критичных пунктов. <strong>Частый сбой:</strong> агент объявляет успех, хотя часть шагов не выполнена.</p><h2>Как внедрять эти промпты</h2><ul><li>Начинайте с одного простого workflow и логируйте каждый вызов инструмента.</li><li>Разделяйте роли: планировщик, исполнитель, проверяющий и обработчик сбоев.</li><li>Определите действия, которые всегда требуют подтверждения человека.</li><li>Храните состояние отдельно от длинной переписки, чтобы снижать шум.</li><li>Тестируйте на ошибках: пустой ответ API, неверный формат, дубликаты, конфликт данных.</li></ul><h2>Launch checklist</h2><ol><li>Описаны доступные tools и их схемы аргументов.</li><li>Есть лимит повторов и правило безопасной остановки.</li><li>Опасные действия требуют подтверждения.</li><li>Состояние обновляется после каждого важного шага.</li><li>Финальный ответ отделяет факты от предположений.</li><li>Логи не содержат лишних персональных данных.</li><li>Человек проверяет результаты перед внешней отправкой или публикацией.</li></ol><h2>FAQ</h2><p><strong>Можно ли использовать один промпт для всего агента?</strong> Можно, но обычно надежнее разбить workflow на промпты для планирования, tool-calling, состояния и проверки.</p><p><strong>Нужно ли просить модель объяснять каждый tool-call?</strong> Для продакшена полезно иметь краткое обоснование в журнале, но не обязательно показывать его пользователю.</p><p><strong>Почему агент ошибается даже с хорошим промптом?</strong> Промпт не заменяет тестирование, валидацию данных, ограничения прав и человеческий контроль.</p><h2>Источники и ограничения</h2><p>Материал подготовлен как практический редакционный шаблон COMRAD404, а не как гарантия корректной работы конкретной модели. Полезные справочные материалы: <a href="https://help.openai.com/en/articles/10032626-prompt-engineering-best-practices-for-chatgpt">OpenAI: best practices for prompting</a>, <a href="https://zapier.com/blog/ai-prompt-templates/">Zapier: AI prompt templates</a>, <a href="https://help.zapier.com/hc/en-us/articles/36532133250317-How-to-prompt-AI-in-Zapier-products">Zapier: prompting in products</a>. Вывод ИИ требует human review и зависит от модели, системных инструкций, доступных инструментов и входных данных.</p>