Промт для ИИ-агента: структура, пример и проверка

Рабочий промт для ИИ-агента состоит из семи частей: результат, исходные данные, область работы, разрешённые инструменты, ограничения, проверка и условие остановки. Такая структура важнее длинного описания роли. Она помогает агенту не только ответить, но и выполнить задачу, показать доказательства и остановиться до рискованного действия.

Чем задание агенту отличается от обычного промта

Обычная нейросеть формирует ответ. Агент получает инструменты и может читать файлы, искать данные, запускать команды или менять внешнее состояние. OpenAI описывает инструменты как встроенный поиск, работу с файлами, вызовы функций и другие действия, которые модель выбирает по задаче. Базовая схема показана в официальном руководстве OpenAI.

Из-за инструментов промт должен отвечать ещё на три вопроса: что агент может делать сам, для чего обязан запросить подтверждение и по каким данным докажет успех. Anthropic рекомендует проектировать описания инструментов так же внимательно, как общий промт, включая точные параметры, примеры, границы и типичные ошибки. Источник: Building effective agents.

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

Карта результата перед написанием промта

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

• Результат: конкретный файл, таблица, исправленная ошибка, найденное значение или готовый черновик.
• Исходные данные: ссылки, папки, период, формат и факты, которым можно доверять.
• Обязательные шаги: действия, без которых результат нельзя считать готовым.
• Проверка: команда, контрольный пример, первичный источник или сравнение до и после.
• Частые сбои: недоступный файл, пустой ответ инструмента, конфликт требований, отсутствие прав.
• Ограничения: запрещённые области, данные и внешние действия.
• Неподходящий случай: задача требует решения человека или формальной ответственности.

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

Шаблон промта для ИИ-агента

Шаблон ниже подходит для исследования, работы с документами и изменений в проекте. Уберите строки, которые не относятся к задаче, и замените скобки конкретными данными.

Результат: [что должно быть готово].
Исходные данные: [где лежат и за какой период].
Область работы: [разрешённые папки, страницы или записи].
Инструменты: [что можно читать, запускать и изменять].
Обязательные шаги: [короткая последовательность].
Проверка: [команда, пример или первичный источник].
Ограничения: [что нельзя делать и какие данные нельзя раскрывать].
Подтверждение: перед [публикацией, отправкой, оплатой, удалением] остановись и спроси.
При сбое: запиши точную ошибку, попробуй безопасную альтернативу и не подменяй факт догадкой.
Финал: перечисли результат, доказательства, изменения и оставшиеся неизвестные.

Фраза «сделай хорошо» не задаёт измеримого результата. Замените её наблюдаемым условием: «таблица содержит по одной строке на заказ, сумма контрольных строк совпадает с отчётом, исходный файл не изменён». Для текста укажите аудиторию, обязательные факты, источники и запрет на неподтверждённые цифры.

По теме: Личный ИИ-агент: как настроить безопасную работу

Безопасный пример для исследования

Задача: каждую неделю получать сводку изменений в официальной документации сервиса. Агенту нужен веб-поиск, но не нужен доступ к почте, платежам или публикации. Минимальные права уменьшают последствия ошибки.

Результат: отчёт до 500 слов о новых изменениях за последние 7 дней.
Источники: только официальный блог, документация и журнал выпусков продукта.
Шаги: найди публикации, открой первоисточники, сравни даты события и публикации, убери повторы.
Проверка: у каждого изменения должна быть прямая ссылка и точная дата.
Ограничения: не входи в аккаунты, не отправляй сообщения, не публикуй отчёт.
Если изменений нет: верни одну строку и список проверенных разделов.
Если источник недоступен: отметь это как непроверенное, не восстанавливай факт по памяти.

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

Как описывать инструменты и права

Название инструмента должно объяснять действие, а описание должно различать чтение и изменение. Формулировка «работа с файлами» слишком широка. Разделите её на чтение документа, создание черновика и публикацию, если платформа это поддерживает. OpenAI советует размещать правила конкретного инструмента рядом с его описанием: назначение, условия вызова, входные данные, побочные эффекты, повторяемость и ошибки. См. официальные рекомендации по моделям.

• Чтение можно разрешить для точной папки, базы или списка сайтов.
• Создание черновика безопаснее прямой публикации и оставляет человеку точку проверки.
• Отправку, оплату, удаление и изменение доступа лучше отделять подтверждением.
• Повторный вызов должен быть безопасным: агенту нужно знать, создаст ли он дубль.
• Секреты передавайте через защищённое подключение, а не текстом промта.

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

Проверяемый чек-лист качества

Протестируйте промт минимум на трёх примерах: нормальные данные, пустые данные и ошибка инструмента. Это обнаруживает проблемы раньше, чем реальный запуск по расписанию.

1. Нормальный пример: агент получает полный набор данных и выдаёт ожидаемый формат.
2. Пустой пример: агент честно сообщает об отсутствии записей и не создаёт фиктивные элементы.
3. Ошибка: один источник недоступен, агент сохраняет подтверждённую часть и помечает пробел.
4. Граница прав: задача требует отправки или удаления, агент останавливается перед действием.
5. Повтор: второй запуск не создаёт дубли и явно сообщает, что уже обработано.

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

По теме: Языковая модель и ИИ-агент: чем отличается чат

Диагностика по симптому

1. Агент рассуждает, но не действует: проверьте, передан ли инструмент и понятно ли описано условие его вызова.
2. Агент делает лишнее: сузьте область, перечислите разрешённые действия и добавьте остановку перед изменением.
3. Агент выдумывает факты: потребуйте первичный источник рядом с утверждением и безопасный ответ при отсутствии данных.
4. Агент зацикливается: задайте максимальное число попыток и критерий, после которого нужна помощь человека.
5. Формат плавает: используйте схему структурированного вывода платформы, а не только текстовый пример.

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

Когда промт не решит задачу

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

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

Частые вопросы

Нужно ли писать агенту роль?

Можно коротко назвать область ответственности, но сначала задайте результат, данные, инструменты и проверку. Роль не компенсирует пропущенные условия.

Какой длины должен быть промт?

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

Можно ли один промт использовать всегда?

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

Почему агент не соблюдает формат?

Если платформа поддерживает структурированный вывод, задайте схему. Затем проверьте пустые значения и ошибочные входные данные.