Connect tools & data

Connessioni API

Trasforma qualsiasi API HTTP in una funzione che il tuo agente può chiamare durante una conversazione: incolla un comando cURL e la procedura guidata crea la definizione dello strumento, i parametri e l

Le connessioni API sono funzioni HTTP personalizzate che i tuoi agenti vocali possono chiamare durante una conversazione — per cercare un ordine, creare un ticket o recuperare lo stato di un account dal tuo backend. Definisci l'endpoint una sola volta in Connessioni → API (/dashboard/api-connections); gli agenti a cui è collegata la connessione possono quindi richiamarla ogni volta che la conversazione lo richiede.

Ci sono due modi per crearne una: incolla qualcosa che la procedura guidata possa analizzare, oppure configura la connessione manualmente.

Il modo più rapido: incolla e analizza#

1. Fai clic su Nuova connessione API

   La finestra di dialogo si apre sulla procedura guidata. Incolla un esempio di comando cURL, specifica OpenAPI/Swagger, esportazione Postman, interfaccia TypeScript o schema Zod nella casella.

2. Fai clic su Analizza

   ThunderPhone deduce l'intera connessione da ciò che hai incollato — URL, metodo, intestazioni e uno schema dei parametri derivato dai parametri di query e dal corpo della richiesta trovati. Le intestazioni incollate (incluse quelle di autenticazione) vengono riportate nella configurazione dell'endpoint.

3. Conferma i campi evidenziati

   La configurazione dedotta si apre con i campi stimati evidenziati per la revisione. Modifica nomi, descrizioni e tipi di parametro affinché l'agente capisca quando e come chiamare la funzione — la descrizione è ciò che legge il modello.

4. Convalida e salva

   Il salvataggio esegue prima una richiesta di test in tempo reale al tuo endpoint. Se la richiesta non riesce, la connessione non viene salvata — correggi l'URL, le intestazioni di autenticazione o il corpo e riprova. Se riesce, la connessione viene archiviata con il badge Convalidata.

Se la procedura guidata non trova un URL di richiesta in ciò che hai incollato, te lo segnalerà — includi un endpoint http(s) completo e riprova.

Configurazione manuale#

Fai clic su Configura manualmente → nella procedura guidata (oppure su Vuoi che l'AI lo deduca? Prova la procedura guidata → per tornare indietro). Il generatore manuale dispone di due editor:

• Visuale — campi del modulo per il nome visualizzato, il nome della funzione, l' URL, il metodo (POST, GET, PUT, PATCH, DELETE), le intestazioni personalizzate e lo schema dei parametri (Aggiungi proprietà per ogni argomento che l'agente può fornire).
• JSON — la stessa definizione come JSON non elaborato, per incollare o perfezionare direttamente una specifica dello strumento.

Un pannello Test della richiesta (facoltativo) ti consente di inviare la richiesta configurata prima del salvataggio e mostra lo stato, la latenza e un'anteprima della risposta. Convalida e salva esegue sempre questo test e salva solo in caso di successo.

Gestisci le tue connessioni#

Ogni riga della connessione mostra il relativo stato di convalida — Convalidata, Non testata o Errore — il nome della funzione e gli agenti che la utilizzano. Dal menu azioni della riga puoi:

• Modificare — riaprire la configurazione.
• Clonare — duplicarla come punto di partenza (la copia inizia come Non testata).
• Cronologia revisioni — visualizzare le versioni precedenti e ripristinarne una nell' editor.
• Trasferire — copiare o spostare la connessione in un'altra organizzazione a cui appartieni. Lo spostamento la rimuove da qui; gli agenti che la usavano potrebbero richiedere una riconfigurazione.
• Eliminare — operazione permanente; gli agenti che utilizzano la connessione dovranno essere riconfigurati.

Collegala a un agente#

Aggiungi la connessione a un agente nella sezione delle connessioni API del generatore (Crea un agente). L'elenco mostra quali agenti utilizzano ciascuna connessione, così puoi capire a colpo d'occhio quale impatto avrà una modifica.

Passaggi successivi#