Дизайн инструментов
для агента
Инструмент - это функция, которую агент вызывает сам: веб-поиск, чтение файла, запрос к API, отправка письма. Когда и с какими аргументами её звать, агент решает по описанию. Значит, качество описания напрямую решает, насколько надёжно работает агент. Этот гайд - о том, как описать инструмент так, чтобы агент не ошибался.
для кого этот курс
программа курса
Что такое инструмент агента
Инструмент - функция, которую агент вызывает сам: веб-поиск, чтение файла, запрос к API, письмо. Агент решает, когда и с какими аргументами её звать, опираясь на описание. Почему описание критично.
Имя и описание
Ясное имя - глагол плюс объект (search_orders, а не do_stuff). Описание - что инструмент делает и когда его использовать (и когда не использовать). Примеры плохо и хорошо.
Параметры и возврат
Понятные аргументы с описанием и типом, разумные дефолты, примеры значений. Чистый возврат по делу, без мусора. Обрезка и пагинация больших ответов, чтобы не жечь контекст.
Ошибки и меньше - лучше
Понятное сообщение об ошибке как подсказка для самокоррекции агента. Не давать 50 инструментов - агент путается. Группировать, убирать дубли, оставлять нужное.
Откуда берутся инструменты
Встроенные у агента и подключённые через MCP-серверы. Как набор инструментов - часть обвязки вокруг модели (tool layer, harness).
Шпаргалка
Чек-лист хорошего инструмента, антипаттерны (мусорный возврат, размытое описание, гора инструментов) и глоссарий на одной странице.