Медичні заклади щодня тонуть у рутині: запис пацієнтів, обробка направлень, нагадування про прийоми, узгодження страхових випадків — усе це забирає години дорогоцінного часу персоналу. Agentic AI — це не просто чат-бот, а автономний агент, який самостійно виконує ланцюжки завдань без постійного втручання людини. Цей туторіал покаже, як налаштувати першого AI-агента для медичного закладу за 2–3 години роботи. Для старту вам потрібен доступ до інтернету, базові навички роботи з веб-інтерфейсами та обліковий запис у хмарному сервісі.
🛠️ Що знадобиться
- n8n Cloud або self-hosted n8n — основна платформа для побудови агентних workflow; є безкоштовний план для старту, self-hosted версія повністю безкоштовна
- OpenAI API (GPT-4o або o3) — мозок агента, обробляє медичні запити та приймає рішення; платний, ~$0.01–0.03 за 1000 токенів
- Google Calendar API або Microsoft Graph API — для управління розкладом лікарів та запису пацієнтів; безкоштовно в межах квот
- Twilio або Infobip — відправлення SMS-нагадувань пацієнтам; від $0.01 за повідомлення
- Airtable або Supabase — база даних для зберігання інформації про пацієнтів та статусів задач; Airtable має безкоштовний план
- Make (колишній Integromat) — опціонально — альтернатива n8n з візуальним інтерфейсом; є безкоштовний план на 1000 операцій/місяць
📋 Покрокова інструкція
Крок 1: Визначення процесу та архітектури агента
Перед тим як відкривати будь-який інструмент, чітко опишіть один конкретний процес — наприклад, автоматичний запис пацієнта на прийом. Відкрийте Google Docs або Notion і намалюйте схему: тригер (вхідний запит від пацієнта) → перевірка вільних слотів → підтвердження запису → відправлення нагадування за 24 години. Агент має знати три речі: що він вміє робити (tools), яка мета (system prompt) і коли зупинитися (exit condition). Запишіть ці три пункти текстом — це стане основою вашого system prompt для AI.

Крок 2: Налаштування n8n та підключення OpenAI
Зайдіть на n8n.io, натисніть “Get started free” та створіть обліковий запис. Після входу в панель керування натисніть кнопку “New Workflow” у верхньому правому куті. У пошуку нод введіть “AI Agent” та перетягніть ноду на полотно. Клацніть по ноді двічі, щоб відкрити налаштування, перейдіть у поле “Credential” → натисніть “Create new” → оберіть “OpenAI API” → вставте ваш API ключ з platform.openai.com (розділ API Keys). У полі “Model” оберіть “gpt-4o” та у вкладці “System Prompt” вставте підготовлений на першому кроці опис ролі агента, наприклад: “Ти — медичний асистент клініки. Твоє завдання: записувати пацієнтів на прийом, перевіряти розклад лікарів та відправляти підтвердження.”
Крок 3: Підключення інструментів (tools) для агента
Агент без інструментів — це просто чат-бот. У тій самій ноді AI Agent прокрутіть вниз до розділу “Tools” та натисніть “Add Tool”. Додайте перший інструмент: натисніть “HTTP Request Tool”, назвіть його “check_calendar”, у поле URL вставте ендпоінт Google Calendar API: https://www.googleapis.com/calendar/v3/calendars/{calendarId}/events, метод — GET. Додайте другий інструмент “create_appointment” з методом POST на той самий API. Третій інструмент — “send_sms”: підключіть Twilio через “HTTP Request Tool”, URL https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Messages.json, метод POST. Кожен інструмент описуйте в полі “Description” простою мовою — агент читає ці описи, щоб вирішити, коли який інструмент використовувати.
Крок 4: Налаштування тригера та тестування агента
Поверніться на полотно та додайте тригерну ноду: натисніть “+” → знайдіть “Webhook” → перетягніть на полотно та з’єднайте стрілкою з нодою AI Agent. Натисніть на ноду Webhook, скопіюйте згенерований URL (він матиме вигляд https://your-instance.n8n.cloud/webhook/abc123). Тепер відкрийте інший браузер або Postman, відправте POST-запит на цей URL із тілом: {"patient_name": "Іван Петренко", "request": "Хочу записатися до терапевта на завтра о 10:00"}. Повернувшись у n8n, натисніть “Execute Workflow” — ви побачите, як агент крок за кроком викликає інструменти: спочатку перевіряє календар, потім створює запис. У лівій панелі з’явиться лог виконання з повними деталями кожного кроку.
Крок 5: Додавання логіки обробки помилок та запуск у продакшн
Медичні дані — це критична зона, тому агент має коректно обробляти відмови. Додайте ноду “Error Trigger” з полотна — вона спрацьовує при будь-якій помилці в workflow. З’єднайте її з нодою “Send Email” (налаштуйте Gmail або SMTP) та напишіть шаблон сповіщення для адміністратора. Після цього активуйте workflow, натиснувши тумблер “Active” у верхньому правому куті — він зміниться на зелений. Тепер підключіть реальний канал введення: у медичних закладах це зазвичай форма на сайті або Telegram-бот — додайте відповідну тригерну ноду замість Webhook. Кінцевий результат: пацієнт надсилає запит, агент автономно перевіряє розклад, записує та відправляє SMS-підтвердження протягом 30 секунд без участі реєстратора.
⚠️ Типові помилки та як їх уникнути
- Агент потрапляє в нескінченний цикл — завжди встановлюйте параметр “Max Iterations” у ноді AI Agent (рекомендовано 10–15); без цього агент може нескінченно викликати інструменти, витрачаючи API-кредити
- Передача персональних даних пацієнтів у хмару без шифрування — налаштуйте self-hosted версію n8n на власному сервері або використовуйте Data Masking: замінюйте реальні імена та ІПН на токени перед відправкою до OpenAI; це критично для відповідності GDPR та українському законодавству про захист персональних даних
- Відсутність підтвердження від людини для критичних дій — для операцій на кшталт скасування операції або зміни медикаментів додавайте ноду “Wait for Approval” — агент зупиняється і чекає підтвердження від лікаря через email або Telegram перед виконанням
- Неправильний system prompt без медичного контексту — без чіткого опису обмежень агент може давати медичні поради; завжди додавайте в prompt: “Ти НЕ надаєш медичних діагнозів. При медичних питаннях направляй до лікаря”
💡 Поради для кращого результату
Використовуйте structured outputs у OpenAI. У налаштуваннях моделі увімкніть “JSON Mode” — агент повертатиме дані в чіткому форматі, що унеможливить помилки парсингу при записі в базу даних. Це заощаджує до 40% часу на дебагінг.
Логуйте кожну дію агента в Airtable. Створіть таблицю з колонками: timestamp, patient_id, action, result, duration_ms. Підключіть ноду Airtable після кожного виклику інструменту — через тиждень ви матимете реальну статистику, де агент “гальмує” або помиляється.
Тестуйте граничні випадки з реальними сценаріями. Надішліть агенту запити типу “запишіть мене вчора” або “хочу до лікаря якого не існує” — подивіться, як він реагує, і допрацюйте prompt до того, як систему побачать реальні пацієнти.
Впроваджуйте агента поступово. Перший місяць запускайте в режимі “shadow mode”: агент готує відповідь, але реєстратор вручну перевіряє та підтверджує кожну дію. Це дозволяє навчити систему на реальних кейсах без ризику для пацієнтів.
❓ Часті запитання (FAQ)
1. Чи є agentic AI безпечним для медичних даних пацієнтів?
Так, якщо налаштовано правильно. Використовуйте self-hosted n8n на сертифікованому сервері, шифруйте дані перед відправкою до зовнішніх API та підписуйте Data Processing Agreement з OpenAI. В Україні це регулюється Законом “Про захист персональних даних” та наказом МОЗ № 1338.

2. Скільки коштує запуск такої системи для невеликої клініки?
Мінімальний стек: n8n self-hosted (безкоштовно на VPS за ~$10/місяць) + OpenAI API (~$30–50/місяць при 500 запитах/день) + Twilio (~$15/місяць). Загалом $55–75 на місяць проти зарплати додаткового реєстратора від $400/місяць — окупність очевидна.
3. Чи може агент замінити лікаря або медсестру?
Ні, і це принципово важливо. Agentic AI автоматизує адміністративні та логістичні процеси: запис, нагадування, маршрутизацію документів. Клінічні рішення — діагностика, призначення лікування — залишаються виключно за медичним персоналом. Це не лише етична, а й юридична вимога.
4. Що робити, якщо агент дає неправильну відповідь пацієнту?
Налаштуйте “human-in-the-loop” для всіх відповідей, що стосуються медичних питань: агент готує чернетку, а медичний персонал затверджує перед відправкою. Паралельно ведіть журнал усіх помилок і щотижня переглядайте system prompt для корекції поведінки.
5. Як інтегрувати агента з існуючою медичною інформаційною системою (МІС)?
Більшість сучасних МІС (наприклад, Helsi, DoDoc, або eZdorov) мають REST API або HL7 FHIR інтерфейс. У n8n додайте ноду “HTTP Request” з відповідними ендпоінтами вашої МІС та API-ключем — агент зможе читати та записувати дані безпосередньо у вашу систему без ручного переносу.
🏁 Підсумок
Ви дізналися, як спроектувати агентний AI-workflow для медичного закладу: від визначення процесу до підключення реальних інструментів — календаря, SMS та бази даних. Результат — автономна система, що обробляє запити пацієнтів 24/7, звільняючи персонал для справді важливої роботи з людьми.
Починайте з найпростішого процесу — автоматичного нагадування пацієнтам за день до прийому. Це займе 1 годину, дасть відчутний результат (скорочення неявок на 20–30%) і навчить вас працювати з платформою без ризику. Зайдіть у n8n прямо зараз, створіть перший workflow і запустіть тестове нагадування — перший реальний агент у вашій клініці може запрацювати ще сьогодні.
РОЗСИЛКА
📬 Щотижневий AI-дайджест
Найкращі статті про ШІ та автоматизацію — без спаму, лише суть
Без спаму · Відписатись будь-коли

