ThunderPhone v3 вече е тук.Започнете самостоятелно — от 2 цента/мин.Прочетете съобщението

Connect tools & data

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 за поставяне или прецизна настройка на спецификация на инструмент директно.

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

Панелът също показва размера на отговора в знаци и приблизителни токени. Вашият агент прочита отново резултата от инструмент при всеки ход на разговора, затова за отговор над 20 000 знака се показва предупреждение с начини за намаляване на размера му, а отговор над 100 000 знака се маркира, защото агентът вижда само началото му. Вижте Инструментът връща твърде много данни.

Стойностите на заглавките са само за запис. След като бъдат запазени, те се криптират и никога повече не се показват нито в таблото за управление, нито в API. Когато редактирате връзка, запазената заглавка показва името си с точки вместо стойността и бележка Запазено: оставете я без промяна, за да запазите съхранената стойност, или въведете нова, за да я замените. Тестовите заявки и активните обаждания използват запазената стойност. Клониране копира запазените стойности в новата връзка.

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

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

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

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

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

Имената на функциите трябва да са уникални само в рамките на един агент. Две връзки могат да споделят едно и също име, например save_information за всеки от два агента, които записват на различни места, но един агент не може да има и двете: запазването на агент с два инструмента с едно и също име се отказва, както и преименуването на връзка на име, което друг инструмент на някой от неговите агенти вече използва.

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