- La scheda Execute Code di Botpress consente di eseguire JavaScript personalizzato all'interno dei flussi di lavoro dei bot, consentendo chiamate API dinamiche, elaborazione dei dati e logica personalizzata oltre alle azioni standard integrate.
- I casi d'uso principali includono le richieste API dinamiche, la post-elaborazione degli output LLM , la limitazione della velocità, i controlli dei permessi e la concatenazione di chiamate API in più fasi, consentendo agli agenti AI di gestire con precisione flussi di lavoro complessi.
- Le migliori pratiche includono la protezione delle chiavi API nelle variabili d'ambiente, la gestione degli errori e dei timeout con garbo e la costruzione di logiche condizionali per operazioni bot robuste e sicure, garantendo integrazioni API scalabili e senza problemi.
Gli agenti di intelligenza artificiale sono tanto potenti quanto i dati a cui possono accedere. Sebbene i modelli linguistici di grandi dimensioniLLMs) generino risposte dai dati di addestramento, non possono recuperare i prezzi delle azioni in tempo reale, elaborare i pagamenti o accedere ai dettagli del CRM, a meno che non siano integrati con le API.
Le API consentono agli agenti di intelligenza artificiale di accedere ai dati in tempo reale, di eseguire la logica e di attivare azioni. Per sfruttarle appieno, gli agenti hanno bisogno di codice personalizzato.
La scheda "Esegui codice" di Botpress Studio consente di scrivere ed eseguire JavaScript all'interno del flusso di lavoro di un bot, gestendo senza problemi le chiamate API, l'elaborazione dei dati e la personalizzazione del comportamento del bot.
Che cos'è la carta Execute Code?
La scheda Execute Code di Botpress consente agli sviluppatori di eseguire JavaScript personalizzato all'interno del flusso del bot. Consente le seguenti funzioni:
- Implementazione della logica personalizzata: È possibile eseguire calcoli complessi o trasformare i dati in modi non previsti dalle azioni standard.
- Interazioni dinamiche: Regolazione delle risposte in base ai dati dell'utente o ai calcoli in tempo reale.
- Integrazioni di dati: Connettetevi senza problemi con servizi di terze parti per recuperare o inviare dati.
- Gestione dello stato: Accesso e modifica dello stato del bot per mantenere il contesto e personalizzare le interazioni.
- Gestione degli errori: Implementare una gestione degli errori personalizzata per garantire operazioni robuste.
LaExecute Code Card offre suggerimenti di codice generati dall'intelligenza artificiale. Inserite una richiesta, come l'acquisizione di dati API, e il sistema genera istantaneamente il codice JavaScript. È quindi possibile rivederlo, modificarlo e perfezionarlo secondo necessità, accelerando lo sviluppo.
Perché gli agenti AI hanno bisogno di API esterne?
Gli agenti di intelligenza artificiale sono utili quanto i dati e i servizi a cui accedono. Sebbene siano in grado di elaborare input e generare risposte, non dispongono di conoscenze in tempo reale, capacità transazionali e integrazioni profonde senza API esterne.
Che si tratti di integrare dati in tempo reale, automatizzare flussi di lavoro o migliorare la sicurezza, le API rendono il vostro bot più intelligente, reattivo e integrato.
5 modi per utilizzare la carta Execute Code
La scheda Execute Code di Botpress Studio semplifica le operazioni dell'agente AI. Aggiungerla al vostro flusso di lavoro è semplice: seguite questo rapido tutorial:
Una voltaaggiunto, ecco i modi principali per sfruttarlo nel vostro flusso di lavoro agenziale.
1. Chiamate API dinamiche
Invece di utilizzare chiamate API statiche, la Execute Card consente di modificare dinamicamente le richieste in base all'intento dell'utente, al contesto del bot o alle conversazioni precedenti.
Esempio: Recupero di dati personalizzati in base alle preferenze dell'utente.
Prompt: Un chatbot di viaggio deve recuperare i prezzi degli hotel in base alla destinazione, alle date di viaggio e al budget dell'utente.
.webp)
Nota: La scheda Esegui codice può generare codice dal linguaggio naturale. Tuttavia, verificare sempre le variabili utilizzate nel codice generato prima di distribuire il flusso di lavoro in produzione.
2. Postelaborazione delle risposte LLM
Sebbene Botpress fornisca azioni AI integrate, a volte è necessario perfezionare le risposte prima di mostrarle agli utenti, ad esempio formattando gli output, filtrando alcune parole o strutturando i dati in modo più chiaro.
Esempio: Riscrittura di risposte LLM non strutturate in una tabella/formato definito.
Prompt: L'intelligenza artificiale recupera i consigli sui ristoranti da un'API e voglio che li formatti in una tabella pulita prima di visualizzarli.
.webp)
3. Esecuzione con limitazione del tasso e condizionale
Alcune API, compresi i portafogli digitali, hanno limiti di utilizzo. Con la Execute Code Card, è possibile controllare le interazioni degli utenti applicando limiti di velocità, impostando fallback e aggiungendo logica condizionale in base alla disponibilità dell'API.
Esempio: Verifica dell'uso dell'API prima di chiamarla
Prompt: Check API quota from https://api.monitoring.com/usage?apikey=${workflow.userApiKey} before making a request. If fewer than 5 requests remain, return an error; otherwise, proceed. Ensure proper error handling in case of failures.
.webp)
4. Gestione dei permessi
Se il vostro bot ha bisogno di verificare gli utenti prima di concedere l'accesso a determinate funzioni, la scheda consente flussi di autenticazione personalizzati che vanno oltre le opzioni predefinite di Botpress.
Esempio: Verifica dello stato di sottoscrizione dell'utente prima di fornire risposte AI
Prompt: Check a user's subscription via https://billing.example.com/user/{userId}. If on a free plan, prompt an upgrade; otherwise, allow access. Handle errors.
.webp)
5. Concatenamento di API in più fasi
A volte, un bot deve combinare i dati provenienti da più API prima di inviare una risposta finale. La scheda consente di realizzare complessi flussi di lavoro in più fasi, recuperando, trasformando e passando i dati in modo dinamico.
Esempio: Prelievo del tempo + prenotazione del ristorante per consigliare il momento migliore per partire
Prompt: Recupera i dati meteo e sul traffico per workflow.city utilizzando workflow.userApiKey. In base alle condizioni, restituire il miglior tempo di viaggio. Gestire i fallimenti.
.webp)
Integrazioni API senza soluzione di continuità per gli agenti AI
Gli agenti di intelligenza artificiale funzionano al meglio quando possono attingere a dati in tempo reale, automatizzare i flussi di lavoro e connettersi con servizi esterni.
Botpress Hub rende tutto questo semplice grazie alle integrazioni API precostituite, agli strumenti di automazione e ai connettori pronti all'uso, in modo che possiate concentrarvi sulla costruzione, non sulla configurazione.
Iniziate subitoa integrare potenti API nei flussi di lavoro del vostro bot: è gratis.
Domande frequenti
1. È necessario conoscere JavaScript per utilizzare efficacemente la Execute Code Card?
Non necessariamente. È utile conoscere le basi, ma la scheda include suggerimenti di codice generati dall'intelligenza artificiale. È sufficiente descrivere ciò che si desidera e l'intelligenza scriverà un codice iniziale da modificare.
2. Esistono modelli o frammenti di codice per le integrazioni API più comuni?
Sì, Botpress fornisce esempi e snippet condivisi dalla comunità per i casi d'uso più comuni, come la chiamata alle API meteo, ai CRM o ai servizi di pagamento.
3. È possibile utilizzare la Execute Code Card senza una precedente esperienza di integrazione API?
Assolutamente sì. Se siete alle prime armi con le API, l'intelligenza artificiale integrata nella scheda può guidarvi con suggerimenti e il costruttore di flussi di lavoro visivi rende l'intero processo più intuitivo.
4. Come gestisce la scheda le richieste API di lunga durata o i timeout?
Supporta il JavaScript asincrono con await, ma è necessario creare manualmente la gestione dei timeout usando try/catch e la logica di fallback per mantenere le cose senza intoppi.
5. Quali sono le migliori pratiche per implementare l'autenticazione e l'autorizzazione con la carta?
Memorizzate le chiavi sensibili in modo sicuro nelle variabili d'ambiente, utilizzate token o intestazioni per l'autenticazione delle API e aggiungete una logica condizionale nel vostro codice per verificare i ruoli degli utenti o i livelli di accesso prima di procedere.
.webp)
