API veze

Pretvorite bilo koji HTTP API u funkciju koju vaš agent može pozvati usred razgovora: zalijepite cURL naredbu, a čarobnjak će izraditi definiciju alata, parametre i autentifikaciju.

API veze prilagođene su HTTP funkcije koje vaši agenti mogu pozvati tijekom razgovora — pronaći narudžbu, izraditi tiket, dohvatiti status računa iz vlastitog pozadinskog sustava. Krajnju točku definirate jednom u odjeljku Veze → API-ji (/dashboard/api-connections); agenti kojima je veza priložena zatim je mogu pozvati kad god to razgovor zahtijeva.

Postoje dva načina za izradu: zalijepite sadržaj koji čarobnjak može analizirati ili ručno postavite vezu.

Brzi način: zalijepite i analizirajte#

1. Kliknite Nova API veza

   Dijaloški okvir otvara se u čarobnjaku. U okvir zalijepite primjer cURL naredbe, OpenAPI/Swagger specifikacije, Postman izvoza, TypeScript sučelja ili Zod sheme.

2. Kliknite Analizirajte

   ThunderPhone iz vašeg zalijepljenog sadržaja zaključuje cijelu vezu — URL, metodu, zaglavlja i shemu parametara izvedenu iz parametara upita i tijela zahtjeva koje je pronašao. Zaglavlja koja ste zalijepili (uključujući zaglavlja za autentifikaciju) prenose se u konfiguraciju krajnje točke.

3. Potvrdite istaknuta polja

   Zaključena konfiguracija otvara se s istaknutim pretpostavljenim poljima radi pregleda. Prilagodite nazive, opise i vrste parametara kako bi agent razumio kada i kako pozvati funkciju — opis je ono što model čita.

4. Provjerite i spremite

   Spremanje najprije pokreće stvarni testni zahtjev prema vašoj krajnjoj točki. Ako zahtjev ne uspije, veza se ne sprema — ispravite URL, zaglavlja za autentifikaciju ili tijelo i pokušajte ponovno. Nakon uspjeha veza se sprema s oznakom Potvrđeno.

Ako čarobnjak u zalijepljenom sadržaju ne može pronaći URL zahtjeva, obavijestit će vas o tome — uključite potpunu http(s) krajnju točku i pokušajte ponovno.

Ručno postavljanje#

U čarobnjaku kliknite Postavite ručno → (ili Želite da AI to zaključi? Isprobajte čarobnjak → za povratak). Ručni alat za izradu ima dva uređivača:

• Vizualno — polja obrasca za prikazni naziv, naziv funkcije, zahtjev URL, metodu (POST, GET, PUT, PATCH, DELETE), prilagođena zaglavlja i shemu parametara (Dodajte svojstvo za svaki argument koji agent može navesti).
• JSON — ista definicija kao neobrađeni JSON, za izravno lijepljenje ili fino podešavanje specifikacije alata.

Ploča Testni zahtjev (nije obavezna) omogućuje slanje konfiguriranog zahtjeva prije spremanja te prikazuje status, kašnjenje i pretpregled odgovora. Provjerite i spremite uvijek pokreće ovaj test i sprema samo nakon uspjeha.

Upravljajte svojim vezama#

Svaki red veze prikazuje status provjere — Potvrđeno, Nije testirano ili Pogreška — naziv funkcije i agente koji je koriste. Iz izbornika radnji retka možete:

• Urediti — ponovno otvoriti konfiguraciju.
• Klonirati — duplicirati je kao početnu točku (kopija počinje sa statusom Nije testirano).
• Povijest revizija — pregledati ranije verzije i vratiti jednu u uređivač.
• Prenijeti — kopirati ili premjestiti vezu u drugu organizaciju kojoj pripadate. Premještanje je ovdje uklanja; agenti koji su je koristili možda će trebati ponovnu konfiguraciju.
• Izbrisati — trajno; agente koji koriste vezu bit će potrebno ponovno konfigurirati.

Priložite je agentu#

Dodajte vezu agentu u odjeljku API veze alata za izradu (Izradite agenta). Popis prikazuje koji agenti koriste svaku vezu, tako da na prvi pogled možete vidjeti na što promjena utječe.

Sljedeći koraci#