Open in
API везе
Претворите било који HTTP API у функцију коју Ваш агент може да позове усред разговора: налепите cURL команду, а чаробњак ће направити дефиницију алатке, параметре и аутентификацију.
API везе су прилагођене HTTP функције које Ваши агенти могу да позивају током
разговора — да потраже поруџбину, креирају захтев или преузму статус налога
из Вашег сопственог позадинског система. Крајњу тачку дефинишете једном у
оквиру Везе → API-ји (/dashboard/api-connections); агенти којима је
веза придружена могу затим да је позову кад год то разговор захтева.
Постоје два начина да је направите: налепите нешто што чаробњак може да анализира или ручно подесите везу.
Брзи начин: налепите и анализирајте
- Кликните на Нова API веза
Дијалог се отвара у чаробњаку. У поље налепите пример cURL команде, OpenAPI/Swagger спецификације, Postman извоза, TypeScript интерфејса или Zod шеме.
- Кликните на Анализирај
ThunderPhone закључује целу везу на основу налепљеног садржаја — URL, метод, заглавља и шему параметара изведену из параметара упита и тела захтева које је пронашао. Заглавља која сте налепили (укључујући заглавља за аутентификацију) преносе се у конфигурацију крајње тачке.
- Потврдите истакнута поља
Изведена конфигурација се отвара са истакнутим претпостављеним пољима ради прегледа. Прилагодите називе, описе и типове параметара како би агент разумео када и како да позове функцију — опис је оно што модел чита.
- Проверите и сачувајте
Чувањем се најпре покреће тест захтев уживо према Вашој крајњој тачки. Ако захтев не успе, веза се не чува — исправите URL, заглавља за аутентификацију или тело и покушајте поново. По успешном завршетку, веза се чува са ознаком Потврђено.
Ако чаробњак не може да пронађе URL захтева у налепљеном садржају, обавестиће Вас
о томе — укључите пуну http(s) крајњу тачку и покушајте поново.
Ручно подешавање
Кликните на Подесите ручно → у чаробњаку (или на Желите да AI ово закључи? Испробајте чаробњак → да се вратите). Ручни алат за израду има два уређивача:
- Визуелно — поља обрасца за приказани назив, назив функције, захтев
URL, метод (
POST,GET,PUT,PATCH,DELETE), прилагођена заглавља и шему параметара (Додај својство за сваки аргумент који агент може да наведе). - JSON — иста дефиниција као сирови JSON, за лепљење или директно фино подешавање спецификације алатке.
Панел Тест захтева (опционално) Вам омогућава да пошаљете конфигурисани захтев пре чувања и приказује статус, кашњење и преглед одговора. Проверите и сачувајте увек покреће овај тест и чува само ако је успешан.
Панел такође приказује величину одговора, у знаковима и приближном броју токена. Ваш агент поново чита резултат алатке при сваком кораку позива, па се за одговор дужи од 20.000 знакова приказује упозорење са начинима за његово скраћивање, а одговор дужи од 100.000 знакова се означава јер агент види само његов почетак. Погледајте Алатка враћа превише података.
Вредности заглавља су само за упис. Када се сачувају, шифрују се и више се никада не приказују, ни на контролној табли ни у API-ју. Када уређујете везу, сачувано заглавље приказује свој назив са тачкама уместо вредности и напомену Сачувано: оставите га тако да бисте задржали сачувану вредност или унесите нову да бисте је заменили. Тестни захтеви и позиви уживо користе сачувану вредност. Клонирајте копира сачуване вредности у нову везу.
Управљајте својим везама
Сваки ред везе приказује њен статус провере — Потврђено, Нетестирано или Грешка — назив функције и који агенти је користе. Из менија радњи у реду можете:
- Уредите — поново отворите конфигурацију.
- Клонирајте — дуплирате је као почетну тачку (копија почиње као Нетестирано).
- Историја ревизија — прегледате раније верзије и вратите једну у уређивач.
- Пренесите — копирате или преместите везу у другу организацију којој припадате. Премештањем се она уклања одавде; агенти који су је користили можда ће захтевати поновну конфигурацију.
- Избришите — трајно; агенти који користе везу мораће поново да се конфигуришу.
Придружите је агенту
Додајте везу агенту у одељку API веза алата за израду (Направите агента). Листа приказује који агенти користе сваку везу, тако да на први поглед можете да видите на шта промена утиче.
Називи функција морају бити јединствени само у оквиру једног агента. Две везе могу делити исти назив, на пример save_information за сваки од два агента који чувају податке на различитим местима, али један агент не може имати обе: чување агента са два алата истог назива биће одбијено, као и преименовање везе у назив који већ користи други алат неког од његових агената.