Le azioni API richiedono una comprensione tecnica della configurazione di server o interfacce.
Si prega di notare che questo tutorial è disponibile solo in inglese, poiché è rivolto principalmente a utenti con un background più tecnico, per i quali l'inglese è lo standard de facto.
Le azioni API ti consentono di collegare sistemi e servizi esterni ai tuoi flussi di lavoro effettuando richieste HTTP ai loro endpoint. Ti permettono di inviare dati a o recuperare dati da applicazioni di terze parti, database o server personalizzati in modo programmatico. Puoi configurare il metodo di richiesta (GET, PATCH, POST, PUT, DELETE), intestazioni, autenticazione e parametri del corpo per soddisfare i requisiti dell'API. Le azioni API sono particolarmente utili quando l'integrazione MCP non è disponibile o quando hai bisogno di un controllo diretto sulla comunicazione HTTP. Una volta configurate, queste azioni possono essere attivate automaticamente all'interno dei tuoi flussi di lavoro o dagli AI Agent per automatizzare attività e sincronizzare dati tra piattaforme.
Avvertenza!
La qualità dei tuoi dati conta davvero! Se fornisci all'IA informazioni di bassa qualità, otterrai risultati di bassa qualità (pensa a "spazzatura in ingresso, spazzatura in uscita")
Ogni modello di IA lavora con limiti di contesto, ovvero una limitazione della quantità di dati che vengono forniti da sistemi esterni, ad esempio tramite API o tramite un server MCP.
Per ottenere la migliore qualità di risposta possibile, è essenziale prefiltrare le informazioni il più possibile. L'obiettivo è che il modello di IA riceva esclusivamente le informazioni esatte necessarie per rispondere a quel singolo messaggio.
Altrimenti, il modello di IA viene "sovraccaricato" con informazioni non filtrate e quindi anche con una quantità di dati inutilmente grande, nella speranza che l'IA crei una risposta sensata, e possibilmente anche rapidamente. Questo non è realistico.
Utilizzate quindi al meglio le possibilità di trasferimento dei parametri sia sulla base degli input del contatto, sia nella restituzione dei dati tramite API.
Assegna alla tua azione API un nome interno e fornisci istruzioni per il tuo AI Agent su quando attivare questa azione.
Aggiungi l'URL dell'endpoint designato e il metodo.
Configura intestazioni, corpo e segnaposto se necessario.
Tieni presente che devi attivare la tua nuova azione API per ogni AI Agent a cui vuoi dare accesso nella scheda Azioni di sistema della tua pagina di configurazione dell'AI Agent.
Configurazioni di esempio
Configurazioni di esempio