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

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