К содержимому
Блог

Промпты для AI-агентов: цель, ограничения и остановка

Промпты для AI-агентов: цель, ограничения и остановка

Промпт для AI-агента похож на короткое техническое задание. Чат может ответить и передать ход человеку. Агент продолжает вызывать инструменты, поэтому ему нужны границы, критерий готовности и причина остановиться.

Коротко

  • Цель описывает наблюдаемый результат, а не желаемый стиль поведения.

  • Ограничения перечисляют доступные данные, инструменты и запретные действия.

  • Условие остановки спасает от бесконечного поиска и случайных действий после успеха.

Из каких частей собрать агентный промпт?

Первая часть, цель. Она отвечает, какой артефакт нужен и как понять, что он готов. «Разберись с ошибкой» оставляет агенту слишком много вариантов. «Найди первую причину ответа 500 в этом логе, приложи строку, время и следующий проверочный шаг» можно проверить.

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

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

text
Цель: подготовить список изменений для исправления ошибки в обработчике оплаты.
Готово, когда: указан файл, условие сбоя, тест и безопасный порядок правки.
Разрешено: читать каталог payments и запускать адресный тест.
Запрещено: менять миграции, отправлять запросы во внешние сервисы, раскрывать секреты.
Остановись и спроси: если причина вне каталога payments или нужна правка схемы данных.
Формат: до пяти пунктов, каждый с путём файла и проверкой.

В таком тексте нет пустых слотов, которые агент должен угадывать. Конкретное имя каталога и ожидаемый формат сокращают число лишних шагов.

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

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

Плохое описаниеРабочее описание
get_order«Ищет заказ по числовому ID. Вернёт статус и сумму либо not_found. Не меняет данные.»
deploy«Создаёт черновой релиз в тестовой среде. Требует SHA и подтверждение человека. При ошибке вернёт ссылку на лог.»
send_message«Отправляет текст после явного подтверждения. Не вызывай для черновика или при неизвестном получателе.»

Эти подробности не украшают промпт. Они уменьшают произвольные вызовы и дают агенту способ отличить отказ от пустого результата.

Нужно ли прописывать весь маршрут заранее?

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

Оставьте место для вопроса. Хороший агентный промпт разрешает сказать «данных недостаточно» и назвать, чего не хватает. Это дешевле, чем ложное исправление, которое позже найдёт ревьюер.

Разберите частые ошибки

«Сделай качественно» не содержит критерия. «Будь автономным» без пределов даёт агенту разрешение пробовать всё подряд. «Исправь все ошибки» связывает разные причины в один неопределённый комок. Каждый из этих текстов можно улучшить вопросом: какой результат примет человек и где агент обязан остановиться?

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

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

Проверьте промпт до запуска

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

Первый запуск делайте на безопасном примере. Смотрите на финальный ответ и последовательность вызовов. При временной ошибке используйте ограниченный повтор по x-should-retry и Retry-After, как описано в документации ошибок. Случайный бесконечный цикл часто начинается с одной расплывчатой фразы.

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

Сравните слабый и рабочий запрос

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

Рабочий запрос: «В каталоге billing найди причину падения указанного теста. Прочитай только связанные файлы. Добавь один тест, который падает на неверной ветке. Не меняй миграции и конфигурацию. Остановись, если причина вне billing, и верни путь, факты и вопрос». Такой текст не гарантирует успех, но делает следующий шаг проверяемым.

Разница не в количестве слов. Второй запрос называет границы, критерий и остановку. Когда задача меняется, обновляйте их вместе. Старое ограничение часто опаснее отсутствующего: агент честно исполняет правило, которое уже не относится к задаче.

Версия инструкции нужна для отладки

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

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

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

Нужно ли писать в промпте формат ответа?

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

Что делать, когда агент не может выполнить задачу?

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

Сколько правил помещать в один промпт?

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

Создать аккаунт для агента

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.