Richiesta API
Il componente Richiesta API ti permette di collegare i tuoi flussi a API esterne inviando richieste HTTP personalizzabili e gestendo le risposte.
Descrizione del componente
Come funziona il componente Richiesta API
Componente Richiesta API
Il componente Richiesta API è uno strumento versatile progettato per facilitare le richieste HTTP all’interno dei tuoi workflow AI. Permette al tuo flusso di lavoro di interagire con API esterne o servizi web inviando richieste a uno o più URL e processando le risposte. Questa funzionalità è essenziale per attività come il recupero dati, l’integrazione con servizi di terze parti o l’invocazione di endpoint personalizzati come parte di processi automatizzati o intelligenti.
Cosa Fa il Componente?
Questo componente ti consente di configurare e inviare richieste HTTP (GET, POST, PATCH, PUT) a URL specificati. Puoi personalizzare la richiesta aggiungendo header, parametri di query e un corpo della richiesta. Supporta anche la gestione di dati di form e l’impostazione di timeout personalizzati, rendendolo adatto a una vasta gamma di interazioni API.
Input
Il componente Richiesta API supporta i seguenti input configurabili:
| Campo | Descrizione | Tipo | Predefinito/Opzioni |
|---|---|---|---|
| URL | Inserisci uno o più URL di destinazione, separati da virgola. | Stringa | |
| Metodo | Metodo HTTP da utilizzare per la richiesta. | Dropdown | GET, POST, PATCH, PUT |
| Header | Header personalizzati da includere nella richiesta (come dizionario). | Dizionario/Dati | |
| Corpo | Dati da inviare per richieste POST, PATCH o PUT (come dizionario). | Dizionario/Dati | |
| Parametri di Query | Coppie chiave-valore da aggiungere come parametri di query all’URL. | Dizionario/Dati | |
| Usa Form Data | Attiva per inviare i dati come application/x-www-form-urlencoded. | Booleano | false |
| Timeout | Tempo (in secondi) prima che la richiesta vada in timeout. | Intero | 5 |
| Cache TTL | Per quanto tempo memorizzare la risposta API in cache. Imposta su ‘Nessuna cache’ per disabilitare. | Dropdown | Nessuna cache, 5 min, … ecc. |
| Verbose | Se attivo, stampa output dettagliato per il debug. | Booleano | false |
| Nome Strumento | Nome per questo strumento di richiesta API (usato dagli agenti). | Stringa | |
| Descrizione Strumento | Descrizione per aiutare gli agenti a capire come usare questo strumento. | Stringa (multiriga) |
Output
Il componente produce due output principali:
| Nome Output | Tipo | Descrizione |
|---|---|---|
| Dati | Dati | I dati di risposta dalla richiesta API. |
| Strumento | Tool | Rende questa richiesta API disponibile come “strumento” per workflow basati su agenti. |
Perché Usare Questo Componente?
- Integrazione: Collega il tuo workflow AI a qualsiasi API esterna o servizio web, semplificando l’arricchimento dei processi con nuovi dati o azioni.
- Flessibilità: Supporta vari metodi HTTP, header, corpi e parametri di query personalizzati—adatto sia per chiamate API semplici che complesse.
- Caching: Permette di memorizzare opzionalmente le risposte per migliorare le prestazioni e ridurre chiamate API ridondanti.
- Supporto Form Data: Invia facilmente dati codificati come form per endpoint compatibili.
- Compatibile con Agenti: Definisci nomi e descrizioni dello strumento affinché il componente sia utilizzabile come strumento nei workflow AI basati su agenti.
Esempi di Utilizzo
- Recupera dati in tempo reale (es. meteo, notizie, finanza) da API pubbliche.
- Invia informazioni a un servizio di terze parti (es. CRM, sistema di ticketing).
- Integra con endpoint backend personalizzati per elaborazione dati o automazione di workflow.
- Permetti agli agenti LLM di chiamare API esterne come parte del loro ragionamento o esecuzione di compiti.
Riepilogo
Il componente Richiesta API è un elemento fondamentale per qualsiasi processo AI che necessiti di interagire con servizi web o fonti di dati esterne. Offre un ampio set di opzioni di configurazione per gestire una grande varietà di scenari di richiesta HTTP e i suoi output possono essere utilizzati direttamente o resi disponibili come strumento per workflow AI basati su agenti.
Esempi di modelli di flusso che utilizzano il componente Richiesta API
Per aiutarti a iniziare rapidamente, abbiamo preparato diversi modelli di flusso di esempio che mostrano come utilizzare efficacemente il componente Richiesta API. Questi modelli presentano diversi casi d'uso e best practice, rendendo più facile per te comprendere e implementare il componente nei tuoi progetti.
Domande frequenti
- Cosa fa il componente Richiesta API?
Il componente Richiesta API consente al tuo flusso di inviare richieste HTTP (GET, POST, PATCH, PUT) a uno o più URL, permettendoti di collegarti con qualsiasi API esterna o servizio web.
- Posso personalizzare gli header e il corpo delle mie richieste API?
Sì, puoi aggiungere header e contenuti del corpo personalizzati per adattarli alla tua API di destinazione. Entrambi possono essere impostati tramite input di dati o dizionari.
- Supporta parametri di query e diversi metodi HTTP?
Assolutamente. Puoi aggiungere parametri di query all’URL e scegliere tra vari metodi HTTP, inclusi GET, POST, PATCH e PUT.
- Posso memorizzare nella cache le risposte delle API?
Sì, puoi configurare per quanto tempo memorizzare in cache le risposte API oppure disabilitare completamente la cache, offrendo così controllo sulla freschezza dei dati e sulle prestazioni.
- Questo componente è adatto per integrare strumenti di terze parti?
Sì, è progettato per un’integrazione fluida con praticamente qualsiasi servizio di terze parti che esponga un’API, rendendolo un componente fondamentale per l’automazione e workflow avanzati.
Collega i Flussi a Qualsiasi API
Inizia ad aggiungere dati in tempo reale, servizi di terze parti o integrazioni personalizzate ai tuoi flussi utilizzando Richiesta API.
Scopri di più
