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 веза градитеља (Направите агента). Листа приказује који агенти користе сваку везу, тако да на први поглед можете видети на шта промена утиче.

Следећи кораци