Nodo HTTP Request - Chiamate REST a API Esterne in ConvyAI Agentic Flow
Panoramica
Il nodo HTTP Request esegue una chiamata REST sincrona verso un endpoint esterno all'interno di un Agentic Flow. Il designer configura l'URL, il metodo HTTP, gli header e il body della richiesta; il codice di stato e il body della risposta sono disponibili come output del nodo per i nodi successivi.
Posizionamento
Il nodo HTTP Request ha un ingresso e un'uscita. Può essere posizionato in qualsiasi punto del flusso dopo un nodo trigger.
Configurazione
Endpoint
| Campo | Descrizione |
|---|---|
| URL | L'endpoint di destinazione. Supporta riferimenti a variabili del flusso con la sintassi standard ($('nodo').campo, $context.x, $input). |
| Method | Metodo HTTP: GET, POST, PUT, PATCH o DELETE. HEAD e OPTIONS non sono supportati. |
Il nodo supporta esclusivamente endpoint REST. Le chiamate SOAP non sono previste in questa versione.
Body
Per le richieste che prevedono un body, seleziona una delle seguenti modalità di encoding:
| Modalità | Descrizione |
|---|---|
query-string | Parametri aggiunti all'URL come query string. |
json | Parametri serializzati come oggetto JSON nel body della richiesta. |
form-data | Parametri inviati come multipart/form-data. |
x-www-form-urlencoded | Parametri URL-encoded nel body della richiesta. |
In ogni modalità, l'interfaccia mostra i controlli chiave/valore per inserire i parametri da inviare. Tutti i campi supportano riferimenti a variabili del flusso con la sintassi standard.
L'invio di file binari o payload in formato base64 non è supportato in questa versione.
Header
Aggiungi qualsiasi numero di header HTTP custom come coppie chiave/valore. Usa questa sezione per impostare header di autenticazione (Bearer token, API key, Basic auth) insieme a qualsiasi altro header richiesto dall'API di destinazione. Non sono presenti sezioni dedicate per l'autenticazione - tutti gli header si gestiscono manualmente.
Timeout e comportamento in caso di errore
| Campo | Descrizione |
|---|---|
| Timeout | Tempo massimo di attesa per la richiesta, in secondi. |
| Fail on error | Controlla il comportamento in caso di timeout, errore di rete o risposta 5xx. |
Quando Fail on error è attivo, il nodo transita in stato di errore e interrompe l'esecuzione del flusso in caso di timeout, errore di rete o risposta 5xx.
Quando Fail on error non è attivo, il flusso prosegue indipendentemente dall'esito. I nodi successivi possono ispezionare i campi statusCode e error dell'output per gestire il risultato in modo condizionale.
Le risposte 4xx sono considerate risposte di protocollo valide e non attivano il comportamento di errore né la logica di retry.
Retry
| Campo | Descrizione |
|---|---|
| Max retries | Numero massimo di tentativi in caso di errori di rete o timeout. Valori accettati: 0–10. |
| Retry interval | Tempo di attesa tra un tentativo e il successivo, in secondi. Valori accettati: 1–30. |
Il retry si applica esclusivamente a errori di rete e timeout. Le risposte 4xx e 5xx non vengono ritentate.
Output
L'output del nodo è accessibile dai nodi successivi con la sintassi standard ($('httpRequest').response, ecc.).
| Campo | Tipo | Descrizione |
|---|---|---|
response | any | Il body della risposta restituito dall'endpoint. |
statusCode | number | Il codice di stato HTTP della risposta. |
error | object | Presente solo in caso di errore. Contiene i campi type e message con la descrizione del problema. |