Skip to main content
Ви вже зробили агента доступним через реальні телефонні дзвінки. Тепер зробимо його корисним під час розмови. Ваш агент вміє вести розмову. Але чи може він перевірити замовлення чи правильно відповісти на питання про політику компанії? Саме про це ця сторінка. Є два способи підключити реальну інформацію до агента. Інструмент — для всього живого: дані, що змінюються, або дії, які потрібно виконати, наприклад перевірити замовлення чи наявність. База знань — для всього записаного: політика повернення, FAQ — того, що не змінюється від дзвінка до дзвінка. Приклад нижче: агент підтримки замовлень на імʼя Майя, для магазину QuickMart. Клієнт може запитати, що в його кошику, і Майя викликає API, щоб перевірити. Клієнт також може поставити питання про політику, і Майя відповідає на основі завантаженого документа.

​
Крок 1: Створіть інструмент

Відкрийте вузол, де відбувається основна частина розмови — у цьому прикладі головний вузол підтримки Майї. Прокрутіть униз і натисніть Створити інструмент, оберіть Зовнішній HTTP API. Назвіть його get_cart_details.
Опис тут важливіший за все інше. Саме його читає агент, щоб вирішити, коли викликати інструмент. Пишіть просто: “Використовуй цей інструмент, коли абонент питає про вміст кошика. Він повертає товари в кошику, кількість, суму й суму зі знижкою.”
Для ендпоінта цей приклад використовує dummyjson.com — публічний тестовий API. Скопіюйте цей URL і перевірте самостійно, бекенд не потрібен:
Без автентифікації, без параметрів. Це GET-запит, бо ви отримуєте інформацію, а не змінюєте щось. У власному налаштуванні тут була б ваша CRM чи система замовлень. Збережіть інструмент.

​
Крок 2: Приєднайте інструмент до вузла

Самого створення інструменту недостатньо. Поверніться до вузла Майї й оберіть get_cart_details у розділі “Інструменти”, потім збережіть.
Інструмент стає доступним лише після того, як його приєднано до потрібного вузла. Якщо пропустити цей крок, інструмент існуватиме, але агент ніколи його не викличе.

​
Крок 3: Завантажте документ бази знань

Натисніть Завантажити документ або перейдіть одразу до Файли бази знань. Оберіть документ, з якого має читати агент — політика повернення, FAQ з доставки, що завгодно, про що реально питають ваші клієнти. Платформа запитає, як видобувати дані з цього документа:
  • Повний документ найкраще підходить для невеликих файлів, де агент бачить усе одразу. Не потребує моделі embeddings.
  • Пошук по фрагментах — для великих документів, де агент має отримувати лише релевантну частину. Перед вибором цього режиму налаштуйте модель embeddings, інакше обробка чи пошук по документу не спрацює.
Короткий документ політики — це випадок “Повний документ”. Завантажте його й дочекайтесь статусу Завершено.

​
Крок 4: Приєднайте документ до вузла

Те саме правило, що й для інструменту. Поверніться до вузла Майї, прокрутіть до Документи бази знань і приєднайте файл.
Самого завантаження недостатньо. Документ має бути приєднаний до вузла, де агент повинен ним користуватись.

​
Крок 5: Поясніть агенту, коли що використовувати

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

​
Крок 6: Перевірте

Запустіть Web Call і спробуйте обидва варіанти:
  • “Привіт Майє, що в моєму кошику?” Слідкуйте за транскриптом. Майя вирішує, що інструмент релевантний, викликає API і відповідає на основі результату, а не вгадує.
  • “Яка у вас політика повернення?” Майя отримує відповідь з документа й відповідає на основі цього контексту.
Ось у чому різниця: для деталей кошика Майя використовує інструмент, бо дані змінюються від дзвінка до дзвінка. Для політики повернення вона використовує базу знань, бо ця відповідь живе в документі й не змінюється. Інструменти зʼєднують агента із системами. База знань — з документами. Разом агент починає відчуватися повʼязаним з вашим реальним бізнесом, а не просто відтворює сценарій.

​
Далі

У вас тепер є повний цикл: дзвінки запускаються автоматично, дані рухаються туди й назад, номер підключено, а агент вміє діяти на основі живих даних і власних документів.
  • Повний довідник інструментів: типи параметрів, автентифікація й найкращі практики в HTTP API-інструментах.
  • Повний довідник бази знань: поведінка при розбитті на фрагменти й налаштування embeddings у Базі знань.