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) и опитайте отново.

Ръчна настройка#

Щракнете върху Ръчна настройка → в съветника (или върху Искате AI да изведе това? Опитайте съветника →, за да се върнете). Ръчният конструктор има два редактора:

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

Панелът Тестова заявка (незадължителен) ви позволява да изпратите конфигурираната заявка преди запазване и показва статуса, закъснението и предварителен преглед на отговора. Потвърждаване и запазване винаги изпълнява този тест и запазва само при успех.

Управление на вашите връзки#

Всеки ред за връзка показва статуса на потвърждаване — Потвърдена, Нетествана или Грешка — името на функцията и кои агенти я използват. От менюто с действия на реда можете да:

• Редактиране — отворите отново конфигурацията.
• Клониране — дублирате я като начална точка (копието започва като Нетествано).
• Хронология на редакциите — прегледате по-ранни версии и възстановите една в редактора.
• Прехвърляне — копирате или преместите връзката в друга организация, към която принадлежите. Преместването я премахва тук; агентите, които са я използвали, може да се нуждаят от преконфигуриране.
• Изтриване — окончателно; агентите, които използват връзката, ще трябва да бъдат преконфигурирани.

Добавяне към агент#

Добавете връзката към агент в раздела за API връзки на конструктора (Създаване на агент). Списъкът показва кои агенти използват всяка връзка, така че с един поглед можете да видите какво засяга дадена промяна.

Следващи стъпки#