раздел 05

Шпаргалка

Всё главное про дизайн инструментов на одной странице.

Чек-лист хорошего инструмента

  • Имя - глагол плюс объект, понятное человеку (search_orders, а не do_stuff).
  • Описание говорит, что инструмент делает, когда его использовать и когда нет.
  • У каждого параметра: понятное имя, описание, тип, разумный дефолт, пример значения.
  • Возврат чистый - только нужное, без служебного мусора.
  • Большие ответы обрезаны или пагинированы.
  • Сообщения об ошибках понятные, с подсказкой что делать дальше.
  • Инструментов немного, без дублей, каждый закрывает свою задачу.

Антипаттерны

Мусорный возврат
Инструмент вываливает всё подряд. Контекст забит, агент отвлекается на лишнее.
Размытое описание
«Ищет заказы» в одно слово. Агент не знает границ и зовёт инструмент не там.
Гора инструментов
50 похожих инструментов. Агент путается в выборе и берёт не тот.

Если агент «тупит» с инструментом - сначала почините текст: имя, описание, параметры, возврат. Это почти всегда эффективнее смены модели.

Глоссарий

ТерминЧто это
Tool (инструмент)Функция, которую агент может вызвать сам: поиск, чтение файла, запрос к API.
ПараметрАргумент инструмента - что агент передаёт внутрь (запрос, дата, лимит).
СхемаФормальное описание инструмента: имя, параметры и их типы. То, что видит агент.
MCPПротокол, по которому к агенту подключают внешние наборы инструментов через серверы.

Куда дальше