Open in
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
- 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.
- 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.
- 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.
- 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.
Ploča također prikazuje veličinu odgovora, u znakovima i približnom broju tokena. Vaš agent ponovno čita rezultat alata pri svakom koraku poziva, pa odgovor dulji od 20.000 znakova dobiva upozorenje s načinima kako ga smanjiti, a odgovor dulji od 100.000 znakova označen je jer agent vidi samo njegov početak. Pogledajte Alat vraća previše podataka.
Vrijednosti zaglavlja mogu se samo upisivati. Nakon spremanja šifriraju se i više se nikada ne prikazuju, ni na nadzornoj ploči ni putem API-ja. Kada uređujete vezu, spremljeno zaglavlje prikazuje svoj naziv s točkama umjesto vrijednosti i oznakom Spremljeno: ostavite ga nepromijenjenim da zadržite spremljenu vrijednost ili upišite novu vrijednost da je zamijenite. Testni zahtjevi i pozivi uživo koriste spremljenu vrijednost. Kloniraj kopira spremljene vrijednosti u novu vezu.
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.
Nazivi funkcija moraju biti jedinstveni samo unutar jednog agenta. Dvije veze mogu dijeliti isti naziv, primjerice save_information za svakog od dva agenta koji spremaju na različita mjesta, ali jedan agent ne može imati obje: spremanje agenta s dva alata istog naziva bit će odbijeno, kao i preimenovanje veze u naziv koji drugi alat jednog od njegovih agenata već koristi.