Описание инструмента (Tool Description)

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