Crea un agente di chat del workflow

Questo documento descrive come creare e configurare un agente di chat del flusso di lavoro in Agent Designer.

Panoramica

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

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

I vantaggi principali degli agenti di chat per il workflow includono:

  • Orchestrazione avanzata: nidifica più agenti di workflow o ADK remoti pubblicati come nodi secondari per gestire attività utente complesse.
  • Supporto della cronologia delle versioni: gli agenti di chat del flusso di lavoro 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 del flusso di lavoro, completa i seguenti prerequisiti:

  • Assicurati che la tua organizzazione sia registrata al programma di accesso in anteprima (EAP) di Agent Designer.
  • Assicurati che un amministratore di Gemini Enterprise abbia attivato il pulsante di attivazione/disattivazione della funzionalità Agent Designer nelle impostazioni di gestione delle funzionalità dell'app. Per maggiori informazioni, vedi Gestire le funzionalità dell'app web.
  • Assicurati di avere un'app web con le origini dati necessarie collegate. Per ulteriori informazioni, vedi Creare un'app, Connettere un'origine dati Google e Connettere un'origine dati di terze parti.
  • Verifica che tutti gli agenti del flusso di lavoro o gli agenti ADK remoti che vuoi allegare come subagenti siano già pubblicati nel repository del tuo workspace, in modo che siano visibili all'orchestratore principale.

Crea un agente di 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 + Crea agente > Agente del flusso di lavoro.
  3. Nel riquadro di creazione dell'agente, fai clic su Avvia manualmente.
  4. Seleziona il chip di attivazione Chat.

    Si apre l'editor di Agent Designer, che ti indirizza alle opzioni di configurazione dell'agente di chat del flusso di lavoro.

  5. Nel riquadro di configurazione, puoi facoltativamente configurare quanto segue per il tuo 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.

    • Agenti secondari: sfoglia o cerca per selezionare gli agenti del flusso di lavoro pubblicati o gli agenti ADK remoti che vuoi che il tuo agente del flusso di lavoro orchestri. Questi agenti verranno configurati come nodi secondari di runtime sotto l'agente principale.

    • Altro: seleziona il modello utilizzato dall'agente di 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 rivedere 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 di chat del flusso di lavoro.

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

Limitazioni delle funzionalità

Durante la fase del programma di accesso in anteprima (EAP), gli agenti di chat del workflow presentano le seguenti limitazioni:

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