n8n: первый ИИ-агент без единой строки кода
Чем AI Agent-нода в n8n отличается от обычной цепочки шагов и на что смотреть, когда агент застрял в цикле
Вы собрали в n8n цепочку из десяти нод: письмо → вложение → парсинг → таблица. Работает ровно до того письма, где вложение приходит в неожиданном формате — и цепочка встаёт, потому что этот вариант заранее не предусмотрели. Обычный workflow не умеет решать на ходу, что делать дальше. Агент — умеет.
Агент — это не ещё одна нода в цепочке, а цикл вокруг модели
В обычном workflow ноды идут одна за другой в порядке, который вы нарисовали сами. AI Agent-нода устроена иначе: внутри неё модель на каждом шаге сама решает, какой инструмент вызвать и вызывать ли его вообще. Так и написано в документации n8n: нода получает чат-модель и один или несколько инструментов, а какой из них применить для конкретной задачи — решает агент. Это тот же принцип, что и в теории агентов: цикл оправдан там, где шаги заранее неизвестны. Вложение может прийти zip-архивом, картинкой или просто ссылкой — агент сам выберет инструмент вместо того, чтобы вы прописывали ветку под каждый случай.
Собирается мышкой: чат-модель плюс инструменты, ни строчки кода
На холсте это выглядит так: перетаскиваете AI Agent-ноду, сбоку подключаете к ней под-ноду с моделью и одну или несколько под-нод-инструментов — HTTP-запрос, поиск по векторной базе, калькулятор, даже отдельный workflow целиком. Документация n8n прямо требует: к агенту нужно подключить хотя бы один инструмент, иначе нода не заработает. До версии 1.82 в n8n можно было выбирать один из нескольких типов агента; сейчас это упростили, и любая AI Agent-нода работает как Tools Agent — тип, который и раньше был самым используемым.
У ноды есть счётчик внутренних попыток — на него и смотреть при отладке
Агент не обязан ответить с первого раза: внутри цикла модель может пробовать несколько раз, прежде чем выдать финальный ответ. За это отвечает параметр Max Iterations, по умолчанию 10. Если агент упирается в этот лимит и не отвечает по делу, проблема обычно не в модели, а в том, что инструменты плохо описаны или их описания пересекаются. Включите опцию Return Intermediate Steps — в результате выполнения появится весь путь агента: что он вызвал, в каком порядке, что получил в ответ. То же самое, но нагляднее, показывает вкладка Logs у ноды: пошаговый список того, что происходило внутри цикла, с входом и выходом на каждом шаге.
Первый практический шаг — не тащить агента сразу в боевой сценарий. Откройте страницу n8n про AI Agent-ноду, соберите минимальный агент с одним инструментом (подойдёт калькулятор или HTTP-запрос) и сразу включите Return Intermediate Steps. Тогда цикл будет виден с первого запуска, а не в тот момент, когда что-то сломается.
