Povezave API

Povezave API so funkcije HTTP po meri, ki jih lahko vaši agenti pokličejo med pogovorom — poiščejo naročilo, ustvarijo zahtevek ali pridobijo stanje računa iz vašega lastnega zalednega sistema. Končno točko enkrat določite v razdelku Povezave → API-ji (/dashboard/api-connections); agenti, ki imajo povezavo dodano, jo lahko nato prikličejo, kadar to zahteva pogovor.

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 povezava API

   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 vnosa razbere celotno povezavo — URL, metodo, glave in shemo parametrov, izpeljano iz najdenih parametrov poizvedbe in telesa zahteve. Glave, ki ste jih prilepili (vključno z glavami za preverjanje pristnosti), se prenesejo v konfiguracijo končne točke.

3. Potrdite označena polja

   Razbrana konfiguracija se odpre z označenimi predvidenimi polji za pregled. Prilagodite imena, opise in vrste parametrov, da agent razume, kdaj in kako poklicati funkcijo — opis prebere model.

4. Preverite in shranite

   Ob shranjevanju se najprej izvede zahteva za preizkus v živo do vaše končne točke. Če zahteva ne uspe, povezava ni shranjena — popravite URL, glave za preverjanje pristnosti ali telo in poskusite znova. Ob uspehu se povezava shrani z značko Preverjeno.

Če čarovnik v vašem vnosu 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 AI to samodejno določi? Preizkusite čarovnika → za vrnitev). Ročni urejevalnik ima dva urejevalnika:

• Vizualno — polja obrazca za prikazno ime, ime funkcije, zahtevan URL, metodo (POST, GET, PUT, PATCH, DELETE), glave po meri in shemo parametrov (Dodajte lastnost za vsak argument, ki ga lahko navede agent).
• JSON — enaka definicija v surovem JSON-u za neposredno lepljenje ali natančno prilagajanje specifikacije orodja.

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

Upravljajte svoje povezave

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

• Uredite — znova odprete konfiguracijo.
• Klonirajte — podvojite jo kot izhodišče (kopija je na začetku nepreizkušena).
• Zgodovina različic — ogledate si prejšnje različice in eno obnovite v urejevalniku.
• Prenesite — kopirate ali premaknete povezavo v drugo organizacijo, katere član ste. Premik jo odstrani od tukaj; agenti, ki so jo uporabljali, bodo morda potrebovali ponovno konfiguracijo.
• Izbrišite — trajno; agente, ki uporabljajo povezavo, bo treba ponovno konfigurirati.

Dodajte jo agentu

Povezavo dodajte agentu v razdelku Povezave API v urejevalniku (Ustvarite agenta). Seznam prikazuje, kateri agenti uporabljajo posamezno povezavo, zato lahko na prvi pogled vidite, na kaj vpliva sprememba.

Naslednji koraki