Connect tools & data

Підключення API

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

API-підключення — це користувацькі HTTP-функції, які ваші агенти можуть викликати під час розмови: знайти замовлення, створити тікет, отримати статус облікового запису з вашого бекенду. Ви визначаєте кінцеву точку один раз у розділі Підключення → API (/dashboard/api-connections); агенти, до яких прикріплено це підключення, зможуть викликати його щоразу, коли цього потребує розмова.

Є два способи створити підключення: вставити дані, які майстер може проаналізувати, або налаштувати підключення вручну.

Швидкий спосіб: вставте й проаналізуйте#

1. Натисніть «Нове API-підключення»

   Відкриється діалогове вікно майстра. Вставте в поле приклад команди cURL, специфікації OpenAPI/Swagger, експорту Postman, інтерфейсу TypeScript або схеми Zod.

2. Натисніть «Аналізувати»

   ThunderPhone визначить усе підключення з ваших даних — URL, метод, заголовки та схему параметрів на основі параметрів запиту й тіла запиту, які він знайде. Вставлені вами заголовки (зокрема заголовки автентифікації) буде перенесено до конфігурації кінцевої точки.

3. Підтвердьте виділені поля

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

4. Перевірити й зберегти

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

Якщо майстер не може знайти URL запиту у вставлених даних, він повідомить про це — додайте повну кінцеву точку http(s) і спробуйте ще раз.

Налаштування вручну#

Натисніть Налаштувати вручну → у майстрі (або Хочете, щоб це визначив ШІ? Спробуйте майстер →, щоб повернутися). Конструктор ручного налаштування має два редактори:

• Візуальний — поля форми для відображуваної назви, назви функції, URL запиту, методу (POST, GET, PUT, PATCH, DELETE), користувацьких заголовків і схеми параметрів (Додати властивість для кожного аргументу, який може передати агент).
• JSON — те саме визначення у форматі необробленого JSON для вставлення або точного налаштування специфікації інструмента безпосередньо.

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

Керуйте підключеннями#

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

• Редагувати — повторно відкрити конфігурацію.
• Клонувати — створити дублікат як початкову точку (копія матиме статус «Не перевірено»).
• Історія версій — переглянути попередні версії та відновити одну з них у редакторі.
• Передати — скопіювати або перемістити підключення до іншої організації, до якої ви належите. Переміщення видаляє його тут; агентам, які його використовували, може знадобитися повторне налаштування.
• Видалити — остаточна дія; агентів, які використовують підключення, потрібно буде налаштувати повторно.

Прикріпіть його до агента#

Додайте підключення до агента в розділі API-підключень конструктора (Створення агента). Список показує, які агенти використовують кожне підключення, тож ви одразу побачите, на що вплине зміна.

Наступні кроки#