API връзки

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 връзки на конструктора (Създайте агент). Списъкът показва кои агенти използват всяка връзка, така че с един поглед да видите какво засяга дадена промяна.

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