n8n AI Agent Tool: узел для делегирования задач другим AI-агентам

Что такое n8n AI Agent Tool

AI Agent Tool — узел n8n для многоагентной оркестрации. Корневой агент может делегировать ему отдельную задачу, после чего использовать полученный результат в своём workflow. В документации узел описан как способ подключать других агентов в качестве инструментов без усложнения контекста и переменных, характерного для отдельных sub-workflows. Подагенты могут быть вложены в несколько уровней, если процесс действительно требует такой структуры.

Чем он отличается от обычного инструмента

Обычный инструмент выполняет конкретное действие или обращается к внешнему сервису. AI Agent Tool передаёт задачу другому агенту, который специализируется на определённой роли и может иметь собственные инструкции и формат ответа.

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

В n8n также есть Tools Agent, который использует внешние инструменты и API. Это другой уровень задачи: Tools Agent подключает действия и сервисы, а AI Agent Tool позволяет одному агенту вызывать другого агента.

Какие параметры нужно настроить

В AI Agent Tool задаются:

• Description — описание назначения и зоны ответственности подагента для корневой модели;
• Prompt (User Message) — инструкция, какие действия выполнить и что вернуть;
• Require Specific Output Format — требование определённого формата с подключением output parser;
• System Message — сообщение, передаваемое агенту до начала разговора;
• Max Iterations — максимальное число попыток модели сформировать ответ;
• Return Intermediate Steps — включение промежуточных шагов в итоговый результат;
• Enable Fallback Model — подключение резервной модели, если основная недоступна или завершилась ошибкой;
• Automatically Passthrough Binary Images — управление передачей бинарных изображений как сообщений с изображениями;
• Batch Processing — пакетная обработка с настройками размера пакета и задержки между пакетами.

Описания и prompt лучше формулировать так, чтобы подагент решал одну узкую задачу. Это рекомендация по проектированию, а не свойство, автоматически обеспечиваемое n8n.

Ограничение sub-node при работе с несколькими items

AI Agent Tool относится к sub-nodes. В документации n8n указано, что выражение в sub-node при нескольких входных items разрешается по первому item, тогда как обычные root nodes обрабатывают входные items иначе.

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

Как проверить AI Agent Tool на практике

1. Выберите одну задачу с понятным результатом: например, определить категорию обращения и вернуть её вместе с кратким обоснованием.
2. Составьте описание подагента: что он обрабатывает, какие данные игнорирует и в каком формате отвечает.
3. Подготовьте тестовые входы: обычный запрос, неполные данные, неоднозначный запрос и запрос вне зоны ответственности.
4. Запустите workflow с корневым агентом и проверьте, был ли выбран нужный AI Agent Tool.
5. Сверьте ответ с ожидаемым форматом и содержанием. Если используется несколько items, отдельно проверьте соответствие результата каждому item.
6. Повторите тест после изменения prompt, модели или Max Iterations — эти изменения могут повлиять на поведение.
7. Перед подключением действий, меняющих данные или отправляющих сообщения, подготовьте тестовую среду и добавьте ручную проверку там, где ошибка имеет последствия.

Рекомендация Paramiko: на первом этапе оставьте узкий read-only сценарий, зафиксируйте примеры ошибок и только затем расширяйте права или количество подагентов.

Когда структура с несколькими агентами оправдана

AI Agent Tool полезен, когда задачу действительно удобно разделить на независимые роли: например, извлечение данных, классификация и подготовка ответа. Если процесс состоит из нескольких предсказуемых преобразований, обычные узлы workflow могут быть понятнее и проще для контроля.

Не добавляйте подагентов только ради усложнения схемы. Для каждого из них заранее определите вход, ожидаемый результат, условия ошибки и действие человека при спорном ответе. Это предлагаемая практика проектирования, а не заявленная функция n8n.

Безопасность действий и ручное подтверждение

Если агент может отправлять сообщения, изменять записи или удалять данные, результат его выбора не следует считать достаточным основанием для автоматического действия. В документации n8n для Tools Agent описан human review: workflow может приостановиться и запросить одобрение или отказ через настроенный канал перед выполнением подключённого инструмента.

Рекомендация Paramiko: до запуска проверьте права, тестовые данные и маршрут эскалации. Сгенерированный или выбранный моделью результат может потребовать проверки человеком; зафиксируйте, какие действия запрещены без подтверждения.