Povezave API

Pretvorite kateri koli HTTP API v funkcijo, ki jo lahko vaš agent pokliče med pogovorom: prilepite ukaz cURL, čarovnik pa ustvari definicijo orodja, parametre in preverjanje pristnosti.

API-povezave so prilagojene funkcije HTTP, ki jih lahko vaši agenti pokličejo med pogovorom — poiščejo naročilo, ustvarijo zahtevek ali pridobijo stanje računa iz vaše lastne zaledne storitve. Končno točko enkrat določite v razdelku Povezave → API-ji (/dashboard/api-connections); agenti, ki imajo povezavo dodano, jo lahko nato uporabijo, kadar to zahteva potek pogovora.

Povezavo lahko ustvarite na dva načina: prilepite nekaj, kar lahko čarovnik analizira, ali pa povezavo nastavite ročno.

Hitra pot: prilepite in analizirajte#

1. Kliknite Nova API-povezava

   Pogovorno okno se odpre v čarovniku. V polje prilepite vzorčni ukaz cURL, specifikacijo OpenAPI/Swagger, izvoz Postman, vmesnik TypeScript ali shemo Zod.

2. Kliknite Analizirajte

   ThunderPhone iz vašega prilepljenega besedila razbere celotno povezavo — URL, metodo, glave in shemo parametrov, izpeljano iz parametrov poizvedbe in telesa zahteve, ki ju najde. Glave, ki ste jih prilepili (vključno z avtentikacijskimi glavami), se prenesejo v konfiguracijo končne točke.

3. Potrdite označena polja

   Razbrana konfiguracija se odpre s predvidenimi polji, označenimi za pregled. Prilagodite imena, opise in vrste parametrov, da agent razume, kdaj in kako naj pokliče funkcijo — opis je tisto, kar bere model.

4. Preverite in shranite

   Ob shranjevanju se najprej izvede preizkusna zahteva v živo proti vaši končni točki. Če zahteva ne uspe, povezava ni shranjena — popravite URL, avtentikacijske glave ali telo in poskusite znova. Ob uspehu se povezava shrani z oznako Validirano.

Če čarovnik v vašem prilepljenem besedilu ne najde URL-ja zahteve, vas bo o tem obvestil — vključite celotno končno točko http(s) in poskusite znova.

Ročna nastavitev#

V čarovniku kliknite Nastavite ročno → (ali Želite, da to razbere AI? Preizkusite čarovnika →, da se vrnete). Ročno orodje ima dva urejevalnika:

• Vizualno — polja obrazca za prikazno ime, ime funkcije, zahtevo URL, metodo (POST, GET, PUT, PATCH, DELETE), prilagojene glave in shemo parametrov (Dodajte lastnost za vsak argument, ki ga lahko posreduje agent).
• JSON — enaka definicija kot neobdelan JSON za neposredno lepljenje ali natančno prilagajanje specifikacije orodja.

Plošča Preizkusite zahtevo (izbirno) omogoča, da konfigurirano zahtevo pošljete pred shranjevanjem, ter prikaže stanje, zakasnitev in predogled odgovora. Preverite in shranite vedno izvede ta preizkus in shrani le ob uspehu.

Upravljajte svoje povezave#

Vsaka vrstica povezave prikazuje stanje preverjanja — Validirano, Nepreverjeno ali Napaka — ime funkcije in agente, ki jo uporabljajo. V meniju dejanj vrstice lahko:

• Uredite — znova odprete konfiguracijo.
• Klonirajte — podvojite povezavo kot izhodišče (kopija je sprva Nepreverjena).
• Zgodovina revizij — ogledate si prejšnje različice in eno obnovite v urejevalniku.
• Prenesite — kopirate ali premaknete povezavo v drugo organizacijo, ki ji pripadate. Premik jo odstrani tukaj; agenti, ki so jo uporabljali, bodo morda potrebovali ponovno konfiguracijo.
• Izbrišite — trajno brisanje; agente, ki uporabljajo povezavo, bo treba znova konfigurirati.

Dodajte jo agentu#

Povezavo dodajte agentu v razdelku API-povezave orodja za izdelavo agenta (Ustvarite agenta). Seznam prikazuje, kateri agenti uporabljajo posamezno povezavo, zato lahko takoj vidite, na kaj vpliva sprememba.

Naslednji koraki#