Connect tools & data

Conexiuni API

Transformați orice API HTTP într-o funcție pe care agentul dumneavoastră o poate apela în timpul conversației: lipiți o comandă cURL, iar asistentul creează definiția instrumentului, parametrii și autentificarea.

Conexiunile API sunt funcții HTTP personalizate pe care agenții dumneavoastră le pot apela în timpul unei conversații — pentru a căuta o comandă, a crea un tichet, a prelua starea contului din propriul backend. Definiți endpointul o singură dată în Conexiuni → API-uri (/dashboard/api-connections); agenții care au conexiunea atașată o pot invoca apoi ori de câte ori conversația o necesită.

Există două modalități de a crea una: lipiți ceva ce asistentul poate analiza sau configurați conexiunea manual.

Calea rapidă: lipiți și analizați#

1. Faceți clic pe Conexiune API nouă

   Fereastra de dialog se deschide în asistent. Lipiți o mostră de comandă cURL, specificație OpenAPI/Swagger, export Postman, interfață TypeScript sau schemă Zod în casetă.

2. Faceți clic pe Analizare

   ThunderPhone deduce întreaga conexiune din conținutul lipit — URL-ul, metoda, anteturile și o schemă de parametri derivată din parametrii de interogare și corpul cererii pe care le-a găsit. Anteturile pe care le-ați lipit (inclusiv anteturile de autentificare) sunt transferate în configurația endpointului.

3. Confirmați câmpurile evidențiate

   Configurația dedusă se deschide cu câmpurile estimate evidențiate pentru revizuire. Ajustați numele, descrierile și tipurile parametrilor, astfel încât agentul să înțeleagă când și cum să apeleze funcția — descrierea este ceea ce citește modelul.

4. Validați și salvați

   Salvarea execută mai întâi o cerere de test live către endpointul dumneavoastră. Dacă cererea eșuează, conexiunea nu este salvată — corectați URL-ul, anteturile de autentificare sau corpul și încercați din nou. Dacă reușește, conexiunea este stocată cu insigna Validată.

Dacă asistentul nu poate găsi un URL de cerere în conținutul lipit, vă va informa — includeți un endpoint http(s) complet și încercați din nou.

Configurare manuală#

Faceți clic pe Configurați manual → în asistent (sau pe Doriți ca AI să deducă aceasta? Încercați asistentul → pentru a reveni). Creatorul manual are două editoare:

• Vizual — câmpuri de formular pentru numele afișat, numele funcției, URL-ul cererii, metoda (POST, GET, PUT, PATCH, DELETE), anteturile personalizate și schema de parametri (Adăugați proprietate pentru fiecare argument pe care agentul îl poate furniza).
• JSON — aceeași definiție ca JSON brut, pentru lipirea sau ajustarea directă a unei specificații de instrument.

Un panou Cerere de test (opțional) vă permite să trimiteți cererea configurată înainte de salvare și afișează starea, latența și o previzualizare a răspunsului. Validați și salvați execută întotdeauna acest test și salvează numai dacă reușește.

Gestionați conexiunile#

Fiecare rând de conexiune afișează starea validării — Validată, Netestată sau Eroare — numele funcției și agenții care o utilizează. Din meniul de acțiuni al rândului puteți:

• Edita — redeschide configurația.
• Clona — duplicați-o ca punct de plecare (copia începe ca Netestată).
• Istoric revizii — vizualizați versiunile anterioare și restaurați una în editor.
• Transfera — copiați sau mutați conexiunea într-o altă organizație din care faceți parte. Mutarea o elimină de aici; agenții care o utilizau pot necesita reconfigurare.
• Șterge — permanent; agenții care utilizează conexiunea vor trebui reconfigurați.

Atașați-o la un agent#

Adăugați conexiunea la un agent în secțiunea de conexiuni API a creatorului (Creați un agent). Lista afișează ce agenți utilizează fiecare conexiune, astfel încât puteți vedea dintr-o privire ce afectează o modificare.

Pașii următori#