Що агент уміє робити

Дія — це те, що відрізняє помічника, який розповідає, від помічника, який робить: заводить клієнта в базу, перевіряє замовлення, дописує рядок у таблицю, надсилає вам повідомлення.

У розмові дія робиться так само, як усе інше: ви кажете, що має статися.

Хай, коли клієнт лишає заявку, ти записуєш його в мою CRM

Назвіть сервіс, а не посилання

Не шукайте документацію свого сервісу — назвіть його. Конструктор спершу піде подивиться сам:

Хочу, щоб бот міг перевірити відправлення в Новій Пошті

Він перевірить, чи є в цього сервісу машинний опис (специфікація API), сторінка документації або готовий сервер MCP, і скаже, що знайшов. Якщо не знайшов нічого — так і скаже, а не вигадає адресу. Вигадана адреса виглядає як робоча дія й ламається аж у клієнта.

Якщо документація у вас під рукою, дайте посилання — з неї конструктор витягне одразу перелік дій:

Ось документація нашої системи бронювання: booking.example.com/api/docs — візьми звідти те, що треба для запису на столик

Ключі й токени

Ключі доступу з документації не приходять — їх доведеться дати вам. Конструктор попросить прямо й пояснить, звідки взяти.

Ключ зберігається окремо, під іменем (як CRM_TOKEN), і більше ніколи не читається — зокрема й самим конструктором. Це не перестраховка: бот, якого попросили пояснити помилку авторизації, охоче процитував би ключ у розмову.

• Ключ під новим іменем записується одразу.
• Ключ поверх наявного — конструктор спитає, бо старе значення прочитати неможливо й «скасувати» тут нічого не поверне.
• Загубили ключ — випустіть новий у тому сервісі, де брали. Дістати збережений неможливо.

Дія, що читає, і дія, що пише

Це різні речі, і платформа ставиться до них по-різному.

• Читає (перевірити статус, подивитись залишок) — конструктор додає одразу.
• Пише (оформити, створити, видалити) — спитає: наслідок буде у вашій системі, і агент зможе покликати цю дію сам.

Якщо сервіс переїхав

Чужі API міняють версію, домен або шлях. Дію через це не треба збирати заново — скажіть, куди вона тепер ходить:

CRM переїхала на /api/v2/leads — поміняй адресу в дії create_lead

Ключі доступу при цьому лишаються на місці. Це головне: якби ви прибрали дію й створили нову, разом із нею зникли б і її заголовки, і ключ від чужого сервісу — а дістати збережений ключ неможливо.

Конструктор спитає згоди: дія й далі називається так само й описана так само, а піде в інше місце — клієнти побачать це першими. Після зміни він запропонує перевірити: нова адреса може приймати не те, що стара.

Прибрати зайву дію

Скажіть просто в розмову:

Прибери дію get_balance — вона дублює get_me

Конструктор спитає згоди, і на це є причина: разом із дією зникають її заголовки й ключі доступу до чужого сервісу. Повернути її можна лише створивши заново.

Це особливо стається в пари з імпортом: чужа специфікація приносить десяток дій, серед них дублікати й зайве. Прибирати їх поштучно в розмові — нормальний спосіб, у панель для цього заходити не треба.

Кожну дію він одразу перевіряє

Створивши дію, конструктор пропонує виконати її один раз із прикладом даних — поза розмовою з клієнтом. Погоджуйтесь: інакше хибний ключ чи адреса спливуть тоді, коли агент відповідатиме живій людині.

Перевірка — це справжній виклик

Вона по-справжньому піде у вашу систему: може створити тестове замовлення або надіслати листа. Тому конструктор питає згоди перед нею.

Якщо перевірка каже «не відповів вчасно» — сервіс, найімовірніше, не зламаний, а просто думає довше за відведений дії час. Скажіть про це:

Дай цій дії більше часу — вона важка

Коли сервіс думає хвилинами (звіт, велика вибірка, генерація), у розмові з клієнтом такого не дочекаються. Такій роботі місце в розкладі, і конструктор скаже це прямо.

Готові інтеграції

У платформі описані чотири готові інтеграції — з них не треба вигадувати адреси й параметри, потрібні лише ваші дані доступу:

Інтеграція	Що робить	Що знадобиться від вас
SkyService — картка клієнта	заводить клієнта у вашу базу SkyService: ім’я й телефон із розмови	токен API і ID компанії з вашого кабінету SkyService
Telegram — сповіщення менеджеру	надсилає повідомлення у ваш чат: нова заявка, важливе питання	токен окремого бота від @BotFather і ID чату
Google Таблиці — рядок	дописує рядок у вашу таблицю	адреса опублікованого скрипта Apps Script (https://script.google.com/macros/s/…/exec)
Вебхук	надсилає подію на будь-яку вашу адресу: Zapier, Make, n8n, власний сервіс	адреса вебхука

Просто скажіть, що хочете підключити:

Підключи Google Таблиці, ось адреса скрипта: https://script.google.com/macros/s/…/exec

Конструктор бачить перелік готових інтеграцій і знає, чого для кожної бракує, — тож спитає рівно те, що з правої колонки. Спитає й згоди: агент почне ходити у вашу систему від вашого імені й робитиме це сам.

Той самий рух міняє протухлий ключ

Підключення тієї самої інтеграції вдруге оновлює її, а не додає другу копію дій. Саме так замінюють ключ, у якого скінчився строк: скажіть підключити ще раз із новим значенням.

Google Таблиці потребують кількох хвилин налаштування на боці Google, і зробити це має людина:

1. Відкрийте таблицю → меню Розширення → Apps Script.
2. Напишіть функцію doPost(e), яка додає рядок в аркуш.
3. Розгорнути → Новий розгорнутий проєкт → тип Веб-застосунок, доступ Усі.
4. Скопіюйте адресу вигляду https://script.google.com/macros/s/…/exec.

Ця адреса — і є ключ доступу до таблиці. Не публікуйте її.

Своя дія

Якщо вашого сервісу в переліку немає, опишіть словами, що має статися, і дайте конструкторові адресу та ключ:

Треба, щоб бот міг створити заявку в нашій системі. Адреса — https://crm.example.com/api/leads, метод POST, ключ ось такий: …

Він створить дію, назве її, опише, коли її кликати, і одразу запропонує перевірити.

Ми не вдаємо, що це підключається саме

Це та частина, де доведеться попрацювати або покликати того, хто налаштовував вам цю систему.

Готові набори інструментів (MCP)

Якщо у вашій компанії вже є Jira, GitHub чи інша система з готовим сервером MCP, агент може дістати її інструменти цілим набором — не описуючи кожен виклик окремо.

У нас є MCP-сервер для Jira, ось адреса й токен

Конструктор спитає згоди: агент діятиме в чужій системі від імені власника. Перед підключенням платформа перевіряє, що сервер справді відповідає й віддає перелік інструментів.

Один агент може доручати роботу іншому

Якщо задача розпадається на різні ролі, не обов’язково вантажити все в одного помічника:

Хай помічник на сайті питає про рахунки в бухгалтерського агента

Це не новий крок у ході, а сусід, до якого він звертається. Доручення витрачає ваші кредити так само, як звичайна робота.

Три межі, які варто знати наперед:

• кликати можна лише перелічених. Коло окреслюєте ви, а не модель у розмові;
• ланцюг має одну ланку. Агент, покликаний агентом, уже нікого не кличе — інакше два помічники, які згадали один одного, крутили б коло до вичерпання гаманця;
• виконавець працює правами замовника. Якщо в бота на сайті питає клієнт, колега зробить рівно те, що дозволено в розмові з клієнтом, — а не все, що вміє від вашого імені.

Коли дія торкається людей

Три речі, про які просять словами, а платформа виконує їх як межу, а не як прохання. Різниця важлива: правило, вписане в характер агента, він може обійти; ці три — ні.

«Хай я спершу підтверджую»

Лист клієнту хай іде тільки з мого дозволу

Дія перестає виконуватись сама: агент готує її й зупиняється. У панелі зʼявляється «1 дія чекає вашого дозволу», і поки ви не натиснули — у світі не сталося нічого. Ви бачите, кому й що саме піде, можете виправити текст перед відправкою або відхилити.

Картка живе добу. Схвалене через тиждень «передзвонимо сьогодні» гірше за нічого, тож прострочене видно окремо — це не ваша відмова, а те, що черга росте швидше, ніж її розбирають.

Це варто вмикати для всього, що йде назовні від імені компанії: листи, публікації, оплати. Передумали — скажіть «більше не питай мене щоразу», і дія знову працюватиме сама.

«Не більше двадцяти з кожного акаунта»

Публікуй не більше 15 на добу з кожної сторінки

Банять акаунт, а не дію. Якщо в одній дії кілька акаунтів — три сторінки, два номери відправника, — назвіть параметр, у якому лежить «від кого» (quota_param), і денна межа рахуватиметься на кожного окремо. Спільна межа на трьох або спиняє роботу втричі раніше, або втричі перевищує безпечну частоту на кожному.

«Не пиши тим, хто відмовився»

Якщо людина попросила не писати — більше ніколи. І не частіше ніж раз на три дні одній людині, і не більше двадцяти на добу

Стоп-лист веде сам агент: коли людина в розмові просить її не турбувати, він записує це одразу. Ви теж можете внести контакт — і викреслити, якщо він помилився.

Стоп-лист про людину, а не про дію: він діє на всі способи, якими агент міг би до неї звернутись. Написання будь-яке — «+38 (067) 111-00-00» і «0671110000» це та сама людина.

А якщо людина передумає. Вона скаже це агентові — більше нікому. Повернути її він не може: якби міг, стоп-лист обходився б однією фразою в чат. Тому він записує прохання і чесно каже: «передам власнику, рішення за ним». Ви побачите його одразу — сповіщенням, рядком «Просять повернути» в панелі й самим проханням у переліку, її словами. Кнопка на такому рядку зветься «Повернути».

Перед тим як щось комусь пообіцяти, агент дивиться в стоп-лист: обіцянка, яку мовчки зупинить межа, гірша за чесне «вас позначено як таку, що не хоче листів».

Чому це не варто писати в характер агента

Правило в характері — це прохання. Агент не бачить, скільки листів пішло вчора, і не памʼятає, кому вже відмовили: на сотому листі розсилки він просто не має цього перед очима. Межа ж рахується платформою й не дає виклику статись.

«Хай пише з акаунта клієнта, а не з мого»

Хай публікує в інстаграмі клієнта, а не в нашому

Ключ у дії — це ви: ваш рахунок, ваші дані. Щоб агент зробив щось у чужому акаунті, його власник має дати згоду в самому сервісі — і тоді агент дістає доступ саме до нього.

Робиться це у два кроки, і другий робить не ви:

1. конструктор налаштовує звʼязок і дає посилання;
2. це посилання відкриває та людина, чий акаунт підключаємо, і натискає «дозволити».

Поки другий крок не зроблено, у панелі стоїть «підключення без згоди» — звʼязок виглядає налаштованим і не працює, і ми кажемо це прямо, а не чекаємо, поки зламається дія в клієнта.

Після «дозволити» людина потрапляє на сторінку, яка каже, що доступ підключено, — вона не наш користувач, і форма входу їй ні до чого. Якщо посилання застаріло (воно живе пʼять хвилин), там же сказано, що робити: попросити нове.

Права рівно ті, які попросили. Агент робить у чужому акаунті не «що завгодно», а рівно ті дії, які ви описали, і в межах наданих прав. Коли людина відкликає доступ у себе, ви дізнаєтесь про це рядком у сповіщеннях, а не з дії, що мовчки перестала працювати.

Доступ оновлюється сам. Якщо сервіс не дав ключа оновлення, агент напише вам одразу: такий доступ скінчиться сам за годину-дві.

Скільки дій у нього зараз

Рядок Дії в панелі. Або спитайте: «які дії він уміє?».

Далі

• Де агент відповідає — щоб дією нарешті скористались клієнти.
• Коли щось зламалось — що робити, коли дія перестала працювати.