API veze

API veze prilagođene su HTTP funkcije koje Vaši agenti mogu pozvati tijekom razgovora — provjeriti narudžbu, izraditi zahtjev za podršku, 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 nešto što č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 unosa 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 za pregled. 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 Provjereno.

Ako čarobnjak u Vašem unosu ne može pronaći URL zahtjeva, obavijestit će Vas o tome — uključite punu 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 lijepljenje ili izravno fino prilagođavanje specifikacije alata.

Ploča Testni zahtjev (neobavezno) omogućuje Vam slanje konfiguriranog zahtjeva prije spremanja te prikazuje status, latenciju i pregled odgovora. Provjerite i spremite uvijek pokreće ovaj test i sprema samo nakon uspjeha.

Upravljajte svojim vezama

Svaki redak veze prikazuje status provjere — Provjereno, Netestirano ili Pogreška — naziv funkcije i agente koji je koriste. Iz izbornika radnji retka možete:

• Uredite — ponovno otvoriti konfiguraciju.
• Klonirajte — duplicirati je kao početnu točku (kopija je u početku netestirana).
• Povijest revizija — pregledati ranije verzije i vratiti jednu u uređivač.
• Prenesite — kopirati ili premjestiti vezu u drugu organizaciju kojoj pripadate. Premještanjem se uklanja ovdje; agenti koji su je koristili možda će trebati ponovnu konfiguraciju.
• Izbrišite — trajno; agente koji koriste vezu bit će potrebno ponovno konfigurirati.

Priložite je agentu

Dodajte vezu agentu u odjeljku API veza 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