Connect tools & data

API savienojumi

Pārvērtiet jebkuru HTTP API par funkciju, ko jūsu balss aģents var izsaukt sarunas laikā: ielīmējiet cURL komandu, un vednis izveidos rīka definīciju, parametrus un autentifikāciju.

API savienojumi ir pielāgotas HTTP funkcijas, ko jūsu aģenti var izsaukt sarunas laikā — lai atrastu pasūtījumu, izveidotu biļeti vai iegūtu konta statusu no jūsu aizmugursistēmas. Galapunktu definējat vienreiz sadaļā Savienojumi → API (/dashboard/api-connections); aģenti, kuriem ir pievienots savienojums, pēc tam var to izsaukt, kad tas ir nepieciešams sarunā.

To var izveidot divos veidos: ielīmēt kaut ko, ko vednis var analizēt, vai iestatīt savienojumu manuāli.

Ātrākais veids: ielīmējiet un analizējiet#

1. Noklikšķiniet uz Jauns API savienojums

   Dialoglodziņš tiek atvērts vednī. Lodziņā ielīmējiet cURL komandas, OpenAPI/Swagger specifikācijas, Postman eksporta, TypeScript saskarnes vai Zod shēmas paraugu.

2. Noklikšķiniet uz Analizēt

   ThunderPhone no jūsu ielīmētā satura nosaka visu savienojumu — URL, metodi, galvenes un parametru shēmu, kas atvasināta no atrastajiem vaicājuma parametriem un pieprasījuma pamatteksta. Ielīmētās galvenes (tostarp autentifikācijas galvenes) tiek iekļautas galapunkta konfigurācijā.

3. Apstipriniet izceltos laukus

   Noteiktā konfigurācija tiek atvērta ar pārskatīšanai izceltiem paredzētajiem laukiem. Pielāgojiet nosaukumus, aprakstus un parametru tipus, lai balss aģents saprastu, kad un kā izsaukt funkciju — aprakstu lasa modelis.

4. Validēt un saglabāt

   Saglabāšanas laikā vispirms tiek palaists reāls testa pieprasījums uz jūsu galapunktu. Ja pieprasījums neizdodas, savienojums netiek saglabāts — izlabojiet URL, autentifikācijas galvenes vai pamattekstu un mēģiniet vēlreiz. Veiksmīgas izpildes gadījumā savienojums tiek saglabāts ar emblēmu Validēts.

Ja vednis jūsu ielīmētajā saturā nevar atrast pieprasījuma URL, tas to paziņos — iekļaujiet pilnu http(s) galapunktu un mēģiniet vēlreiz.

Manuāla iestatīšana#

Vednī noklikšķiniet uz Iestatīt manuāli → (vai uz Vai vēlaties, lai AI to nosaka? Izmēģiniet vedni →, lai atgrieztos). Manuālajā veidotājā ir divi redaktori:

• Vizuālais — veidlapas lauki parādāmajam nosaukumam, funkcijas nosaukumam, pieprasījuma URL, metodei (POST, GET, PUT, PATCH, DELETE), pielāgotām galvenēm un parametru shēmai (Pievienot rekvizītu katram argumentam, ko balss aģents var norādīt).
• JSON — tā pati definīcija neapstrādātā JSON formātā, lai tieši ielīmētu vai precizētu rīka specifikāciju.

Panelis Testēt pieprasījumu (neobligāts) ļauj pirms saglabāšanas nosūtīt konfigurēto pieprasījumu un parāda statusu, aizkavi un atbildes priekšskatījumu. Validēt un saglabāt vienmēr izpilda šo testu un saglabā tikai veiksmīgas izpildes gadījumā.

Pārvaldiet savus savienojumus#

Katrā savienojuma rindā ir redzams validācijas statuss — Validēts, Netestēts vai Kļūda — funkcijas nosaukums un aģenti, kas to izmanto. Rindas darbību izvēlnē varat:

• Rediģēt — atkārtoti atvērt konfigurāciju.
• Klonēt — dublēt to kā sākumpunktu (kopija sākotnēji ir Netestēta).
• Versiju vēsture — skatīt iepriekšējās versijas un atjaunot kādu no tām redaktorā.
• Pārsūtīt — kopēt vai pārvietot savienojumu uz citu organizāciju, kurai piederat. Pārvietojot tas tiek noņemts no šejienes; aģentiem, kas to izmantoja, var būt nepieciešama pārkonfigurēšana.
• Dzēst — neatgriezeniski; aģenti, kas izmanto savienojumu, būs jāpārkonfigurē.

Pievienojiet to aģentam#

Pievienojiet savienojumu aģentam veidotāja sadaļā API savienojumi (Izveidot aģentu). Sarakstā ir redzams, kuri aģenti izmanto katru savienojumu, tāpēc uzreiz varat redzēt, ko ietekmē izmaiņas.

Nākamās darbības#