Claude Код 👁 3

Описание инструмента ИИ-агента

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

Промпт Запустить →
Напиши описание инструмента для ИИ-агента. Агент видит только это описание и по нему решает, звать инструмент или нет — значит текст должен отвечать на «когда», а не рассказывать, как инструмент устроен внутри.

Что делает инструмент: [ИНСТРУМЕНТ: ищет запись клиента в базе по фамилии или номеру телефона]
Что принимает: [ПАРАМЕТРЫ: строка поиска — фамилия целиком или телефон из 11 цифр]
Что возвращает: [ВОЗВРАТ: карточка клиента с историей обращений или пустой ответ]
Рядом есть похожие: [СОСЕДИ: поиск по сделкам и поиск по задачам — агент их путает]

Что нужно:

1. Первая строка — что инструмент делает, одним предложением, глаголом в настоящем времени. Без «этот инструмент предназначен для».
2. Вторая — когда звать. С примером запроса пользователя, по которому видно, что нужен именно он.
3. Третья — когда НЕ звать, с указанием на соседей: агент путает похожие инструменты именно потому, что у каждого описано только своё назначение и ни у кого не описаны границы.
4. Описание каждого параметра: что подставлять и в каком виде. Если формат жёсткий, скажи об этом прямо — модель охотно передаёт обрезанный номер и получает пустой ответ, после чего уверенно сообщает, что клиента нет.
5. Что делать с пустым результатом: переспросить пользователя или сообщить, что не найдено. Выбери одно.

Отсечка. Не описывай внутреннее устройство, таблицы и запросы — агенту это не нужно, а токены на описание тратятся при каждом обращении. Не дублируй сюда правила из системного сообщения: при правке они разъедутся. Не делай описание длиннее пяти строк.

Проверка перед выдачей: придумай два запроса пользователя — один для этого инструмента, другой для соседнего — и проверь по своему же тексту, что агент их различит. Если не различит, допиши строку про границы и скажи, что исправил.
Запустить промпт →

Пример результата

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

Похожие промпты

Рефакторинг легаси-модуля в Kimi: карта, план, код по шагам
Kimi
Рефакторинг легаси-модуля в Kimi: карта, план, код по шагам
Kimi
Сайт-визитка с 3D одним промптом — Kimi K3
DeepSeek
Телеграм-бот на n8n в DeepSeek: схема нод, которую можно собрать за вечер
DeepSeek
DeepSeek: объяснить чужой/легаси код по строкам

Полезные статьи

ИИ-агенты в n8n: промт, сборка агента и грабли запуска
Промты для Kling: видео из фото и 14 готовых промптов
Промт с котом: 4 провала нейросети и 14 промптов

Все гайды →