Crea un agente di chat del workflow

Questo documento descrive come creare e configurare un agente chat del workflow in Workflow Builder.

Panoramica

Un agente chat del workflow funge da potente orchestratore di workflow multi-nodo per gestire le interazioni conversazionali.

Mentre un agente chat non del workflow è limitato a un singolo nodo radice con attributi fissi, un agente chat del workflow ti consente di collegare workflow pubblicati e agenti ADK (Application Development Kit) remoti come sub-agenti. L'agente chat radice funge da coordinatore, inviando le query degli utenti al sub-agente appropriato e restituendo le risposte.

I principali vantaggi degli agenti chat del workflow includono:

  • Orchestrazione avanzata: nidifica più workflow pubblicati o agenti ADK remoti come nodi secondari per gestire attività utente complesse.
  • Supporto della cronologia delle versioni: gli agenti chat del workflow supportano il controllo delle versioni. Puoi salvare, confrontare, visualizzare la cronologia e ripristinare le versioni precedenti dell'agente per monitorare le modifiche.

Prima di iniziare

Prima di creare un agente chat del workflow, completa i seguenti prerequisiti:

  • Assicurati che un amministratore di Gemini Enterprise abbia attivato l'opzione di attivazione/disattivazione della funzionalità Workflow Builder nelle impostazioni di gestione delle funzionalità dell'app. Per maggiori informazioni, vedi Gestisci le funzionalità dell'app web.
  • Assicurati di avere un'app web con le origini dati necessarie collegate. Per maggiori informazioni, vedi Creare un'app, Collegare un'origine dati Google e Collegare un'origine dati di terze parti.
  • Verifica che tutti i workflow o gli agenti ADK remoti che vuoi collegare come sub-agenti siano già pubblicati nel repository dell'area di lavoro, in modo che siano visibili all'orchestratore radice.

Creare un agente chat del workflow

App

Per creare manualmente un agente chat del workflow:

  1. Apri l'app web Gemini Enterprise in un browser.
  2. Nel menu di navigazione dell'app web, fai clic su + Nuovo agente > Workflow.
  3. Nel riquadro di creazione dell'agente, fai clic su Crea manualmente.

  4. Seleziona il chip del trigger Chat.

    Si apre l'editor di Workflow Builder, che ti indirizza alle opzioni di configurazione dell'agente chat del workflow.

  5. Nel riquadro di configurazione, puoi facoltativamente configurare quanto segue per l'agente:

    • Prompt suggeriti: inserisci un prompt che descriva lo scopo e il comportamento previsto dell'agente.

    • Conoscenza: fai clic su Aggiungi file per caricare eventuali materiali di riferimento aggiuntivi da utilizzare per l'agente.

    • Strumenti e integrazioni: apri la finestra di dialogo Strumenti e integrazioni per selezionare gli strumenti e i connettori Google consentiti per questa interfaccia conversazionale.

    • Sub-agenti: sfoglia o cerca i workflow pubblicati o gli agenti ADK remoti che vuoi che il workflow orchestri. Questi agenti verranno configurati come nodi secondari di runtime sotto l'agente radice.

    • Altro: seleziona il modello utilizzato dall'agente chat del workflow.

  6. Testa la configurazione dell'agente:

    • Fai clic sulla scheda Anteprima.
    • Nell'interfaccia di chat, invia un messaggio di test (ad esempio, hello) per valutare le risposte dell'agente.

  7. Salva o gestisci le versioni dell'agente (facoltativo):

    1. Fai clic sulla freccia menu a discesa accanto a Pubblica e seleziona Salva versione.
    2. Per esaminare o ripristinare una versione, fai clic sulla freccia menu a discesa accanto a Pubblica, fai clic su Visualizza cronologia delle versioni e seleziona la versione da ripristinare.

  8. Fai clic su Pubblica per finalizzare e pubblicare l'agente chat del workflow.

    Una volta pubblicato, l'agente chat del workflow viene visualizzato nella Galleria di agenti, pronto a gestire le richieste degli utenti in arrivo.

Limitazioni delle funzionalità

Gli agenti chat del workflow presentano le seguenti limitazioni:

  • I dettagli di configurazione di un sub-agente collegato non sono visibili all'interno del riquadro di configurazione dell'agente chat radice. Per esaminare o modificare il workflow di un sub-agente (ad esempio un passaggio di approvazione), apri il workflow singolarmente dalla pagina Galleria di agenti.
  • La funzionalità Pianifica l'esecuzione dell'agente chat non è supportata per gli agenti chat del workflow. Le opzioni di pianificazione si applicano solo agli agenti non del workflow.
  • La funzionalità Condividi un agente chat non è supportata per gli agenti chat del workflow in questa release.