Проектирование инструментов для ИИ-агентов

Обзор

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

Цепочка узлов как инструмент

Инструментом может быть цепочка узлов, подключённая к ИИ-агенту, а не только один узел. Имя инструмента и Tool Description для модели задаются на первом узле цепочки; возвращаемый в агент результат рекомендуется задавать узлом AI Agent Tool Response. Подробности и пример см. в разделе «Цепочка узлов как инструмент» на странице Узел ИИ-агент.

Именование

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

✅ Хорошо:

• create_event_tool
• send_email_draft
• retrieve_calendar_tool

❌ Плохо:

• Node 3
• tempTool
• doStuff

Рекомендации по поведению

• Инструменты должны быть детерминированными и возвращать согласованные результаты
• Если инструмент выполняет необратимые действия (например, отправка письма, бронирование встречи), убедитесь, что логика агента подтверждает намерение перед его вызовом
• Инструменты должны возвращать понятные ошибки при отсутствии или невалидности обязательного ввода — в формате, который агент может интерпретировать

Описания инструментов

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

✅ Хорошо:

create_event_tool: «Создаёт новое событие в календаре, используя название, время и список участников.»

❌ Плохо:

«Делает что-то с календарём»

"Test tool"

Сохраняйте описания короткими, конкретными и ориентированными на действие. Пишите их для агента — не только для людей.

Тестирование

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

• Выполняется надёжно с реальным вводом
• Возвращает используемые результаты
• Корректно обрабатывает ошибки при необходимости