Crea un agente di chat del workflow

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

Panoramica

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

Mentre un agente chat non di workflow è limitato a un singolo nodo radice con attributi fissi, un agente chat di 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 di 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 di workflow supportano il controllo delle versioni. Puoi salvare, confrontare, visualizzare la cronologia delle visualizzazioni e ripristinare le versioni precedenti dell'agente per monitorare le modifiche.

Prima di iniziare

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

  • Assicurati che un amministratore di Gemini Enterprise abbia attivato l'opzione di attivazione/disattivazione di 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 di workflow

App

Per creare manualmente un agente chat di 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 di 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 le app 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 di 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 di workflow.

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

Limitazioni delle funzionalità

Gli agenti chat di workflow presentano le seguenti limitazioni:

  • I dettagli di configurazione di un sub-agente collegato non sono visibili nel 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 di workflow. Le opzioni di pianificazione si applicano solo agli agenti non di workflow.
  • La funzionalità Condividi un agente chat non è supportata per gli agenti chat di workflow in questa release.