Навчити агента діяти

На цій сторінці ви дасте агентові першу дію — щоб він не лише розповідав, а й робив, — і перевірите її кнопкою тесту.

Що таке дія простими словами

Дія — це те, що агент уміє виконати у ваших системах прямо в розмові:

• оформити заявку в CRM;
• перевірити стан замовлення й назвати клієнтові дату доставки;
• забронювати столик на конкретну дату;
• записати клієнта на послугу.

Різниця з знаннями проста. Знання — це те, про що агент може розповісти. Дія — те, що він може зробити.

Агент сам вирішує, коли час виконати дію: він читає ваш опис («Забронювати столик на дату й кількість гостей»), розуміє з розмови потрібні значення, виконує дію й продовжує розмову з тим, що отримав у відповідь.

Відкрийте агента → Дії. Тут три способи додати дію й список того, що агент уже вміє.

Дії налаштовує адміністратор

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

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

Найшвидший спосіб. Популярні сервіси вже описані — від вас потрібні лише дані доступу.

1. Блок Готові інтеграції — оберіть потрібну плитку.
2. Під плиткою розгорнеться форма з полями саме цього сервісу. Заповніть їх — поруч із кожним полем є підказка, де взяти значення.
3. Натисніть Підключити.

Підключена інтеграція позначається як підключено.

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

Взяти з документації

Якщо готової інтеграції немає, але у вашого сервісу є документація, дії можна дістати з неї.

1. Блок Взяти з документації → Відкрити.
2. Вставте Посилання на документацію й натисніть Знайти дії. Або перетягніть файли документації — приймаються .md, .txt і формальні описи (.json, .yaml), до 10 файлів за раз.
3. Якщо в документації вказані лише шляхи без адреси сервера, заповніть Базова адреса сервісу.
4. З'явиться перелік знайденого. Відмітьте лише те, що агентові дозволено виконувати.
5. У полі Доступ до сервісу впишіть рядок виду Ключ: значення — так само, як у документації вашого сервісу. Він додається до кожного виклику цих дій.
6. Натисніть Додати обрані.

Знімайте галочки з небезпечного

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

Описати дію вручну

Якщо ні готової інтеграції, ні документації немає — натисніть Описати дію вручну.

Заповніть форму Нова дія:

Поле	Що писати
Ім'я дії (латиницею)	коротке ім'я без пробілів, напр. book_table
Спосіб запиту	«надіслати дані» або «отримати дані»
Коли її викликати	опис звичайною мовою: «Забронювати столик на дату й кількість гостей»
Адреса	адреса вашого сервісу, куди піде звернення
Доступ до сервісу	рядки виду Ключ: значення, по одному на рядок

Поле «Коли її викликати» — найважливіше

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

Значення, які підставляє агент

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

Натисніть + значення й заповніть рядок: назву, куди підставити (тіло запиту, адреса після «?», у самому шляху, заголовок), тип (текст, ціле число, число, так/ні), опис «що це» і чи воно обов'язкове.

Якщо дія нічого не приймає — залиште порожнім.

Робота, яка триває довго

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

Знадобиться заповнити, що бачить клієнт, адресу перевірки стану й назви полів, у яких приходять номер завдання, стан, результат і причина невдачі. Стани «готово» й «не вдалося» перелічуються через кому; будь-який інший стан читається як «ще працює».

Лише для підтверджених

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

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

Підтвердження налаштовує розробник

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

Натисніть Зберегти дію.

Перевірити дію

Найважливіший крок. До появи перевірки перший справжній виклик відбувався б уже в розмові з клієнтом — і помилковий ключ виявлявся б найгіршим із можливих способів.

1. У блоці Наявні дії натисніть Перевірити біля потрібної.
2. Заповніть значення, які дія приймає.
3. Натисніть Виконати.

Дія виконається по-справжньому

Так само, як під час розмови з клієнтом. Якщо дія створює заявку — заявка створиться. Перевіряйте на тестових даних.

Результат показує:

• позначку немає відповіді — адреса недосяжна, перевірте її;
• або код відповіді й фразу «Сервіс прийняв виклик» / «Сервіс відхилив виклик», а поруч — час виконання;
• Відповідь сервісу — те, що ваш сервіс віддав;
• Що з цього побачить агент — те, з чим агент продовжить розмову. Якщо тут порожньо, агент нічого корисного з відповіді не візьме.

Керувати наявними діями

Кожен рядок у блоці Наявні дії показує назву дії, її опис і адресу.

Кнопка	Що робить
Перевірити	тестовий виклик, описаний вище
Обмежити / Відкрити всім	вмикає й вимикає режим «лише для підтверджених»
Видалити	агент одразу перестає пропонувати дію

Видалення не чіпає ваш сервіс — зникає лише вміння агента до нього звертатись.

Далі

Хід агента: що він робить крок за кроком — якщо ви хочете змінити сам порядок роботи агента.