У спільноті AI‑інженерів дедалі частіше говорять не про те, як «зробити ще одного бота», а про те, як побудувати корисного агента, якого можна контролювати й розуміти. Саме на це спрямований воркшоп розробника‑євангеліста n8n Ліама МакҐарріґла: учасники крок за кроком збирають у n8n агента, який керує Gmail та Google Calendar, але залишається прозорим і «людиноцентричним» — з людиною в циклі ухвалення рішень.
Цей матеріал розбирає практичну сторону такого агента: як організовано чат‑інтерфейс, як налаштований вузол AI Agent, як звичайні Gmail‑ і Calendar‑вузли перетворюються на інструменти для ШІ, і як усе це під’єднується до Google через OAuth.
Від тригерів до діалогу: чому головним інтерфейсом стає чат
Класичний n8n, який з’явився ще у 2019 році, будувався навколо тригерів: подія у формі, вебхук, розклад, вхідний лист — і далі ланцюжок дій. У світі агентів логіка зміщується: користувачеві зручніше не запускати сценарій за розкладом чи HTTP‑запитом, а просто написати повідомлення «перенеси мій завтрашній дзвінок на п’ятницю і підтверди клієнту листом».
Саме тому базою демонстраційного воркфлоу стає не вебхук і не крон‑розклад, а Chat Trigger. У новому воркфлоу першим елементом на канвасі додається вузол «Chat trigger» — він перетворює будь‑який текстовий запит користувача на вхідні дані для всієї подальшої логіки.
Цей підхід вирішує одразу кілька завдань.
По‑перше, він дає природний інтерфейс: користувач не думає про структуру форм чи параметри API, а просто формулює намір. По‑друге, він уніфікує доступ до агента: той самий воркфлоу можна буде пізніше «підвісити» до Slack, інших месенджерів чи зовнішніх систем, але базова модель взаємодії — діалог — не зміниться. По‑третє, чат‑тригер зручний для розробки: прямо в інтерфейсі n8n можна надсилати тестові повідомлення й одразу бачити, як вони проходять через вузли.
У межах воркшопу Slack‑інтеграція та інші канали лишаються «домашнім завданням» для учасників. Для основного прикладу достатньо вбудованого чату n8n, який дозволяє зосередитися на логіці агента, а не на налаштуванні зовнішніх сервісів.
ChatHub: як увімкнути вбудований чат‑клієнт для агента
Щойно Chat Trigger додано на канвас, під ним з’являється невелике вікно для введення тексту — це локальний чат для тестування. Але n8n має ще один рівень — повноцінний інтерфейс ChatHub, який перетворює воркфлоу на «чат‑бота» всередині самої платформи.
Щоб це запрацювало, потрібно зробити кілька кроків у конфігурації:
у налаштуваннях вузла Chat Trigger є прапорець «Make available in ChatHub». Його активація сигналізує n8n, що цей воркфлоу можна показувати в глобальному чат‑інтерфейсі;
воркфлоу має бути опублікований. Поки він у статусі чернетки, ChatHub його не підхоплює;
після публікації в лівій панелі n8n з’являється іконка чату. Перехід до відповідної вкладки відкриває ChatHub, де в списку доступних чатів буде й щойно налаштований агент.
У ChatHub користувач бачить звичний чат‑інтерфейс: поле введення, історію повідомлень, статуси виконання. Кожне повідомлення, надіслане тут, запускає виконання воркфлоу з Chat Trigger як точкою входу. У вкладці «Executions» самого воркфлоу можна побачити кожен запуск, вхідний текст і те, як далі працювали вузли.
Це важливий елемент концепції «людина в циклі». Користувач не лише спілкується з агентом, а й має змогу заглянути «під капот» — подивитися, які саме кроки були виконані, які дані пройшли через Gmail‑ чи Calendar‑вузли, де могла статися помилка. Агент не перетворюється на чорну скриньку, навіть якщо взаємодія з ним відбувається в зручному чат‑форматі.
AI Agent як мозок воркфлоу: модель, інструменти, пам’ять
Чат‑тригер дає агента «вуха», але не «мозок». Інтелектуальна частина воркфлоу реалізується через спеціальний вузол n8n AI Agent. На канвасі він виглядає інакше, ніж звичайні вузли: замість одного виходу збоку має кілька «ніжок» унизу, що відображає його роль як оркестратора, який може викликати інші інструменти.
AI Agent очікує три основні компоненти, з яких обов’язковим є лише один.
Перший — це чат‑модель, тобто конкретна LLM, яка генерує відповіді. n8n дозволяє під’єднати різних провайдерів. Якщо потрібного сервісу немає в списку, часто достатньо взяти вузол «OpenAI‑сумісна модель» і змінити базовий URL на адресу іншого сумісного API — це типовий сценарій для проксі‑рішень в ентерпрайз‑середовищах.
У воркшопі як провайдера обрано OpenRouter, а з його каталогу — модель Claude Sonnet 4.6. Учасникам надається тимчасовий API‑ключ OpenRouter у Notion‑конспекті, який планують відкликати після події, тож вони можуть одразу запускати агента без додаткової реєстрації в сторонніх сервісах.
Другий компонент — інструменти. Саме тут AI Agent отримує змогу не лише відповідати текстом, а й виконувати дії: читати пошту, створювати події, змінювати статус листів. Інструментами стають інші вузли n8n, які агент може викликати автономно, коли вважає це потрібним для виконання запиту користувача.
Третій компонент — пам’ять. AI Agent підтримує кілька бекендів пам’яті, включно з вбудованою опцією Simple memory. У цьому режимі історія діалогу зберігається всередині n8n, а розмір контекстного вікна — тобто кількість останніх повідомлень, які модель «бачить» при кожному новому запиті, — можна налаштувати. За замовчуванням це п’ять повідомлень. Для інтеграції з існуючою інфраструктурою передбачено варіанти на базі Postgres і Redis, але в демонстраційному агенті достатньо простого локального зберігання.
У підсумку AI Agent стає центральною точкою прийняття рішень: він отримує текст із Chat Trigger, аналізує його за допомогою обраної LLM, вирішує, які інструменти викликати, і формує відповідь користувачу, спираючись на результати цих викликів і на історію діалогу.
Перетворення Gmail і Calendar на інструменти для ШІ
Ключова ідея воркшопу — показати, як звичайні інтеграційні вузли n8n перетворюються на «руки» агента. Будь‑який стандартний вузол, зокрема Gmail чи Google Calendar, можна позначити як AI tool. Після цього AI Agent отримує право викликати його самостійно в межах діалогу.
У прикладі з Gmail‑ та Calendar‑агентом набір інструментів підібрано так, щоб покрити типові сценарії роботи з поштою та розкладом.
Для Gmail додаються вузли, які дозволяють читати вхідні листи, шукати повідомлення за критеріями, архівувати непотрібне й надсилати нові листи. Це дає змогу агенту, наприклад, знайти лист із запрошенням на зустріч, зафіксувати час у календарі, а потім надіслати підтвердження або пропозицію перенести зустріч.
Для Google Calendar додаються вузли створення й керування подіями. Агент може створити нову подію на основі текстового запиту, змінити час або опис уже існуючої, скасувати зустріч чи знайти вільний слот у розкладі користувача.
Технічно перетворення вузла на інструмент відбувається через його конфігурацію. У режимі AI tool кожне поле, яке модель має право заповнювати, потрібно явно позначити як «from AI». Це критичний елемент безпеки й контрольованості: агент не може довільно змінювати будь‑який параметр вузла, лише ті, які власник воркфлоу дозволив. Наприклад, можна дозволити моделі задавати тему й тіло листа, але зафіксувати адресу відправника або обмежити список можливих одержувачів.
Такий підхід поєднує гнучкість і керованість. З одного боку, агент може автономно вирішувати, коли й як викликати Gmail‑ чи Calendar‑інструменти, щоб виконати запит користувача. З іншого — розробник чітко визначає межі повноважень: які дії дозволені, які поля можна змінювати, які параметри залишаються під повним людським контролем.
У результаті користувач у ChatHub може написати щось на кшталт «знайди всі листи від цього клієнта за останній тиждень, заплануй з ним дзвінок на завтра після обіду і надішли йому запрошення», а агент, використовуючи інструменти Gmail і Calendar, виконає послідовність дій, не перетворюючи при цьому воркфлоу на непрозору «магію».
Google OAuth: як під’єднати пошту й календар до агента
Щоб агент міг працювати з реальними даними користувача, Gmail‑ і Calendar‑вузли мають отримати доступ до відповідних акаунтів Google. У n8n це реалізовано через стандартний OAuth‑процес «Sign in with Google», вбудований у конфігурацію облікових даних.
Під час налаштування вузла Gmail або Google Calendar користувач відкриває діалог конфігурації креденшалів і обирає варіант авторизації через Google. Далі запускається знайомий потік: вікно входу в Google, вибір акаунта, перелік запитуваних дозволів, підтвердження. Після успішного завершення n8n зберігає OAuth‑токен і може від імені користувача виконувати дії в Gmail та Calendar у межах наданих прав.
Цей підхід має кілька практичних наслідків для агента.
По‑перше, він працює з реальними робочими обліковими записами, а не з тестовими «пісочницями». Це дозволяє одразу перевіряти сценарії, близькі до бойових: справжні листи, реальний календар, живі клієнти.
По‑друге, доступ можна тонко обмежувати на рівні Google‑дозволів. Якщо організація не готова давати агенту право видаляти події чи листи, відповідні скоупи просто не включаються в OAuth‑запит.
По‑третє, у поєднанні з проєктами n8n (на хмарних та enterprise‑планах) можна розділяти креденшали між різними середовищами й командами. Хоча ця ширша тема виходить за межі конкретного воркшопу, саме вона робить можливим сценарій, коли один і той самий агентний воркфлоу існує в кількох проєктах із різними наборами облікових даних — наприклад, для тестового та продакшн‑середовища.
У демонстраційному агенті все зводиться до простого для учасника кроку: відкрити конфігурацію Gmail‑вузла, натиснути «Sign in with Google», пройти авторизацію, повторити те саме для Calendar‑вузла — і після цього агент отримує змогу читати пошту, створювати події та надсилати листи в реальному акаунті.
Людина в циклі: контроль, спостережуваність і розширення
Хоча воркшоп зосереджений на технічному складанні Gmail‑ та Calendar‑агента, його концептуальний центр — саме «human‑in‑the‑loop». Ідея полягає не в тому, щоб повністю віддати керування поштою й календарем моделі, а в тому, щоб зробити агента потужним, але спостережуваним і керованим.
Цьому сприяє кілька рішень у самій архітектурі воркфлоу.
По‑перше, чат як інтерфейс дозволяє людині формулювати завдання й одразу бачити, що агент робить у відповідь. Кожен крок можна перевірити, а в разі потреби — скоригувати наступні інструкції.
По‑друге, AI‑інструменти мають чітко окреслені поля «from AI», тож модель не може вийти за межі дозволених дій. Якщо агент має право лише читати й архівувати листи, але не видаляти їх, це гарантується конфігурацією вузлів, а не лише «надією на добру поведінку» моделі.
По‑третє, історія виконань у n8n дозволяє розбиратися з помилками й небажаною поведінкою постфактум. Якщо агент неправильно інтерпретував запит і створив подію не в той день, розробник може відкрити відповідне виконання, подивитися, які саме дані пройшли через вузли, і скоригувати підказки або обмеження інструментів.
Нарешті, сам формат воркшопу передбачає, що побудований агент — це лише відправна точка. У Notion‑конспекті учасники отримують «домашні завдання»: під’єднати Slack як альтернативний тригер, винести частину логіки в підворкфлоу, додати спеціалізовані субагенти для складніших сценаріїв. Але фундамент залишається тим самим: чат‑інтерфейс, AI Agent як мозок, Gmail‑ і Calendar‑інструменти як руки, OAuth як міст до реальних даних і людина, яка бачить і контролює кожен крок.
Висновок: практичний агент замість демонстраційного бота
Прикладів «агентів», які вміють лише відповідати в чаті, сьогодні безліч. Цінність демонстрації n8n у тому, що тут агент одразу працює з реальними робочими інструментами — поштою й календарем — і водночас залишається прозорим і керованим.
Чат‑тригер і ChatHub роблять взаємодію природною й зручною, AI Agent надає гнучкий інтелектуальний шар, а перетворення Gmail‑ і Calendar‑вузлів на інструменти дозволяє моделі виконувати конкретні дії в межах чітко окреслених повноважень. OAuth‑підключення до Google забезпечує доступ до реальних даних без порушення звичних для користувача механізмів безпеки.
У підсумку виходить не чергова демонстрація можливостей LLM, а робочий шаблон: як із візуального конструктора n8n, кількох вузлів і мінімуму коду зібрати агента, який реально допомагає керувати робочим днем — і при цьому не перетворюється на неконтрольовану чорну скриньку.