Human in the Loop в n8n: додавання кроку погодження до AI-агента
Покроково додайте перевірку human-in-the-loop у n8n: призупиніть ризиковий виклик інструмента AI-агента для погодження та коректно обробіть схвалення й відмову.
Перевірено за наведеними джерелами .
Передумови та мета
Перевірка human-in-the-loop у n8n дозволяє призупинити ризиковий крок усередині воркфлоу AI-агента, щоб людина могла схвалити або відхилити його перед виконанням, згідно з офіційною документацією n8n. Перш ніж це налаштовувати, вам потрібен вузол AI Agent із щонайменше одним уже підключеним інструментом: незалежні нотатки з практики в блозі практика зазначають, що вузол AI Agent у n8n наразі вимагає щонайменше одного підключеного підвузла-інструмента, тож почніть із цього, якщо у вашого агента його ще немає.
Вам також знадобиться готовий до налаштування канал погодження — наприклад, чат або месенджер, через який крок перевірки зможе надсилати запити та отримувати рішення. Мета цього туторіалу вузька: оберіть один виклик інструмента у своєму воркфлоу, який достатньо ризикований, щоб потребувати ще одного погляду — надсилання повідомлення, видалення запису, оформлення замовлення — і вимагайте рішення людини перед виконанням саме цього виклику.
Sources: Human-in-the-loop for tools | Build | n8n Docs, n8n AI Agent Node: Plain-English Docs + a Real Build (2026)
Налаштування кроку перевірки людиною на панелі інструментів
Це налаштування повністю відбувається на панелі інструментів (Tools Panel) вузла AI Agent, у три кроки, взятих з офіційної документації n8n.
Додавання кроку перевірки людиною до AI-агента
- Відкрийте панель інструментів: Натисніть на конектор Tools на вузлі AI Agent, щоб відкрити панель, де налаштовуються інструменти та крок перевірки.
- Додайте крок перевірки людиною: У розділі Human review панелі інструментів оберіть канал погодження та налаштуйте його облікові дані й параметри.
- Підключіть інструменти, що потребують погодження: Прикріпіть інструменти, які мають вимагати погодження, до конектора кроку перевірки людиною, налаштувавши кожен зі звичайним способом.
Після підключення погодження вимагатимуть лише інструменти, прив'язані до кроку перевірки людиною, — інші інструменти на вузлі AI Agent, як і раніше, працюватимуть автоматично, тож ви можете вибірково визначати, які дії потребують додаткового погляду. Документація n8n не деталізує налаштування облікових даних для кожного окремого каналу погодження, тому дотримуйтеся власних інструкцій n8n для обраного каналу, наприклад Slack, Telegram чи Gmail.
Sources: Human-in-the-loop for tools | Build | n8n Docs
Що відбувається, коли рецензент схвалює або відхиляє
Коли крок погодження human-in-the-loop у n8n підключено, виконання воркфлоу тепер призупиняється в цій точці: документація n8n описує, що воркфлоу зупиняється та очікує на дію людини, перш ніж виклик інструмента піде далі.
| Дія рецензента | Що відбувається | Результат виклику інструмента |
|---|---|---|
| Схвалити | Воркфлоу продовжується | Інструмент виконується з параметрами, обраними ШІ |
| Відхилити | Воркфлоу продовжується | Дію скасовано, вона не виконується, згідно з документацією n8n |
Різниця між двома результатами полягає в тому, чи справді виконується інструмент: схвалення дозволяє запустити його з параметрами, обраними ШІ, тоді як відмова скасовує дію, згідно з документацією n8n. Те, як агенту повідомляють про відмову, визначає, чи він коректно відновиться, чи заплутається, тому системний промпт має значення — про це йдеться в наступному розділі.
Sources: Human-in-the-loop for tools | Build | n8n Docs
Написання зручного для рецензента повідомлення про погодження та оновлення системного промпту
Рецензент, який бачить лише голу кнопку «схвалити або відхилити» у кроці human-in-the-loop n8n, змушений вгадувати, що саме він погоджує. Практичний прийом, вартий випробування — сприймайте його як пропозицію для адаптації, а не обов'язкове налаштування — це побудова повідомлення про погодження навколо назви інструмента та параметрів, обраних ШІ, щоб рецензент бачив точно, що буде виконано, перш ніж ухвалити рішення.
Документація n8n також рекомендує описувати налаштування інструментів і крок перевірки людиною безпосередньо в системному промпті AI-агента. Без цього контексту відмова може збити модель з пантелику, змусивши її повторювати той самий запит або видавати незрозумілу відповідь, тож чітке пояснення того, що певні інструменти потребують погодження — і що робити в разі відмови — допомагає агенту коректно відновлюватися.
Sources: Human-in-the-loop for tools | Build | n8n Docs
Як це вписується в роботу команд, що стандартизують AI-агентні воркфлоу n8n
Один крок погодження — гарна відправна точка, але команди, які запускають кілька AI-агентних воркфлоу n8n у продакшн, зазвичай хочуть застосовувати той самий підхід послідовно, а не винаходити його заново для кожного воркфлоу. Просунуті завдання n8n Balloon Challenges безпосередньо охоплюють цю тему, опрацьовуючи агентів, що використовують інструменти, погодження людиною та стійку автоматизацію як практичні сценарії, а не читання документації.
Якщо ви відповідаєте за те, як команда створює й перевіряє агентні воркфлоу, це саме той тип підходу, якому варто навчати команду разом, а не залишати кожного розробника розбиратися самостійно.
