Workflow

Crea flussi di conversazione avanzati con workflow visivi basati su grafi

Panoramica

I workflow degli agenti offrono una potente interfaccia visiva per progettare flussi di conversazione complessi in ElevenAgents. Invece di basarti su percorsi di conversazione lineari, con i workflow puoi creare grafi di conversazione sofisticati e ramificati che si adattano dinamicamente alle esigenze degli utenti.

Creare workflow

La dashboard è il metodo consigliato per progettare workflow grazie all’editor grafico visivo. I workflow sono archiviati nel campo workflow di primo livello dell’agente, quindi puoi anche recuperarne, modificarne e inviarne il JSON tramite la CLI oppure aggiornarlo tramite l’SDK: è utile per il controllo versione e il CI/CD.

Crea dalla dashboard

Aggiorna tramite CLI

Aggiorna tramite API

Apri il tuo agente nella dashboard, vai alla scheda Workflow e usa l’editor visivo per aggiungere nodi, configurare il comportamento dei subagenti e collegare gli archi. Salva le modifiche.

Tipi di nodo

I workflow sono composti da diversi tipi di nodo, ciascuno con uno scopo specifico nel flusso di conversazione.

Nodi subagente

I nodi subagente ti consentono di modificare il comportamento dell’agente in punti specifici del workflow. Queste modifiche si applicano alla configurazione dell’agente di base oppure possono sostituire completamente la configurazione dell’agente corrente, offrendoti un controllo granulare su ogni fase della conversazione. Puoi aggiornare o sovrascrivere qualsiasi configurazione dell’agente, gli strumenti disponibili e gli elementi della knowledge base collegati.

Generale

Knowledge Base

Strumenti

Configurazione aggiuntiva dell'agente subagente

Modifica le impostazioni principali dell’agente per questo nodo specifico:

Prompt di sistema: aggiungi o sostituisci le istruzioni di sistema per guidare il comportamento dell’agente
Selezione LLM: scegli un modello linguistico diverso (ad esempio, passa da Gemini 2.0 Flash a un modello più potente per attività di ragionamento complesse)
Configurazione della voce: modifica le impostazioni vocali, inclusi velocità e tono, oppure passa a una voce diversa

Casi d’uso:

Usa un LLM più potente per i nodi che richiedono decisioni complesse
Applica linee guida di conversazione più rigide durante la raccolta di informazioni sensibili
Modifica le caratteristiche della voce per le diverse fasi della conversazione
Modifica la personalità dell’agente per tipi di interazione specifici

Nodo Say

Un nodo Say fa pronunciare all’agente un messaggio in un punto specifico del workflow, quindi prosegue lungo gli archi in uscita. Usalo quando la formulazione di un messaggio è importante e non deve essere lasciata a un subagente, ad esempio per un saluto, un’informativa legale o una conferma letta all’utente.

Ogni nodo Say invia il messaggio in una delle due modalità:

Letterale: l’agente pronuncia il testo esatto che inserisci, con una traduzione facoltativa per ogni lingua configurata.
Prompt: l’LLM genera il messaggio a partire da una descrizione che scrivi.

Nodo strumento di dispatch

I nodi strumento eseguono una chiamata a uno strumento specifico durante il flusso della conversazione. A differenza degli strumenti nei subagenti, i nodi strumento sono punti di esecuzione dedicati che garantiscono la chiamata dello strumento.

Configurazione speciale degli archi: I nodi strumento dispongono di un tipo di arco univoco che consente di instradare a un nuovo nodo in base al risultato dell’esecuzione dello strumento. Puoi definire:

Percorso di successo: dove instradare quando lo strumento viene eseguito correttamente
Percorso di errore: dove instradare quando lo strumento non riesce o restituisce un errore

In futuro saranno disponibili ulteriori condizioni di ramificazione.

Nodo di aggiornamento dello stato

Un nodo di aggiornamento dello stato assegna una o più variabili dinamiche ogni volta che il workflow lo attraversa, usando le stesse espressioni dello strumento Update state. A differenza dello strumento, che viene eseguito quando l’LLM decide di chiamarlo, il nodo applica sempre gli aggiornamenti in quel punto del grafo e poi continua lungo gli archi in uscita.

Scopri di più qui.

Nodo di trasferimento dell’agente

Il nodo di trasferimento dell’agente facilita il passaggio della conversazione tra diversi agenti conversazionali; scopri di più qui.

Nodo di trasferimento a un numero

I nodi di trasferimento a un numero passano da una conversazione con un agente IA a un operatore umano tramite sistemi telefonici; scopri di più qui

Nodo finale

I nodi di fine chiamata terminano il flusso di conversazione in modo ordinato; scopri di più qui

Archi e controllo del flusso

Gli archi definiscono il modo in cui le conversazioni scorrono tra i nodi del workflow. Supportano una logica di instradamento sofisticata che consente percorsi di conversazione dinamici e sensibili al contesto.

Archi in avanti

Archi all'indietro

Gli archi in avanti spostano la conversazione verso i nodi successivi del workflow. Rappresentano il flusso principale della conversazione.

Condizione LLM

Espressione

Nessuno

Usa le condizioni LLM per creare flussi di conversazione dinamici basati sulla valutazione del linguaggio naturale. L’LLM valuta le condizioni in tempo reale per determinare il percorso appropriato.

Trasferimento dell'agente con condizione LLM

Opzioni di configurazione:

Etichetta: descrizione leggibile dall’uomo della condizione dell’arco (non elaborata dall’LLM)
Condizione LLM: condizione in linguaggio naturale valutata dall’LLM

Analisi

Quando un workflow è attivo, la scheda Workflow nella dashboard di analisi sovrappone al grafo i dati di utilizzo: accessi per nodo, tempo medio trascorso e terminazioni, oltre alla distribuzione degli archi in entrata e in uscita per ogni nodo. Dall’ispettore dei nodi puoi anche passare direttamente alle conversazioni corrispondenti nella cronologia tramite il filtro Nodo inserito.