Panoramica di Workflows

I workflow sono agenti che puoi creare utilizzando Workflow Builder nell'app web Gemini Enterprise. Questi agenti sono progettati per eseguire una sequenza di passaggi o azioni, che possono includere una combinazione di automazione con l'AI e intervento umano, in base a un trigger configurato. Le risposte del workflow possono essere deterministiche o non deterministiche in base alla logica di orchestrazione complessiva dell'agente.

Workflows sono ideali per i seguenti casi d'uso:

• Processi in più passaggi con logica di sequenza definita. Ad esempio, automatizzare una checklist di onboarding dei dipendenti in strumenti come Gmail e Calendar.
• Attività con automazione con l'AI e approvazioni umane. Ad esempio, scrivere una bozza di un report con l'AI che richiede l'approvazione di un utente prima della pubblicazione.
• Orchestrazioni complesse con logica condizionale. Ad esempio, indirizzare i lead di vendita a team diversi in base alla regione e al budget.

Le seguenti funzionalità sono disponibili in Workflow Builder:

• Creare un workflow con linguaggio naturale: descrivi il workflow in linguaggio semplice e genera automaticamente una struttura di workflow.
• Utilizzare i modelli di workflow: sfoglia e inizia dai modelli predefiniti per i casi d'uso aziendali comuni.
• Configurare i trigger del workflow: esegui automaticamente i workflow quando i dati cambiano nelle app connesse.
• Connettere le app ai passaggi dell'agente: attiva gli strumenti di lettura e scrittura (come Gmail, Jira e Google Drive) nei passaggi di Gemini Agent per cercare dati, inviare messaggi e gestire record.
• Utilizzare i passaggi di controllo del flusso: aggiungi ramificazioni condizionali, filtri dati e loop al workflow.
• Connettere i server MCP: connetti i server MCP come passaggi del workflow o come strumenti per i passaggi di Gemini Agent.
• Utilizzare i passaggi human-in-the-loop: aggiungi passaggi di revisione umana, approvazione e richiesta di informazioni al workflow.
• Aggiungere agenti esistenti al workflow: delega le attività ad altri agenti AI specializzati all'interno del workflow.
• Gestire le versioni del workflow: salva, condividi, confronta e ripristina le versioni del workflow.
• Modificare un workflow con linguaggio naturale: modifica i workflow esistenti descrivendo le modifiche in linguaggio naturale.
• Visualizzare i log di esecuzione del workflow: monitora le esecuzioni del workflow con tracce di esecuzione passo passo.
• Condividere un workflow: condividi i workflow live con altri utenti della tua organizzazione.

Connettori supportati

Workflows supportano i seguenti connettori:

• Gmail
• Google Calendar
• Google Chat
• Google Drive
• Slack
• Jira
• ServiceNow
• Confluence
• OneDrive
• SharePoint
• Outlook

Prima di iniziare

Prima di esplorare queste nuove funzionalità:

• 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 Gemini Enterprise con i datastore necessari connessi. Per maggiori informazioni, vedi Informazioni su app e datastore.

Canvas del workflow

Workflow Builder offre un canvas ibrido che combina la facilità dei prompt in linguaggio naturale con il controllo di un editor visivo.

• Designer conversazionale: il designer conversazionale, accessibile all' inizio della creazione del workflow e all'interno dell'editor visivo, fornisce un' interfaccia conversazionale per creare e perfezionare il workflow utilizzando prompt in linguaggio naturale. È ideale per gli utenti che preferiscono un'esperienza di sviluppo no-code e vogliono utilizzare il linguaggio naturale per creare i propri workflow.

  • 
  • 

• Canvas dell'editor: il canvas dell'editor fornisce una rappresentazione visiva del workflow. Fornisce un flusso logico di nodi che rappresentano i passaggi e le connessioni tra loro. L'editor visivo è ideale per gli utenti che vogliono perfezionare la logica del workflow, aggiungere logica condizionale e integrarsi con vari strumenti e applicazioni.

  

  • Anteprima: la scheda Anteprima fornisce un'anteprima live del workflow, che ti consente di eseguire simulazioni per testare il flusso del workflow e apportare le modifiche necessarie.

    

  • Esecuzioni: la scheda Esecuzioni fornisce un elenco di tutte le esecuzioni del workflow, inclusi la data e l'ora di ogni esecuzione, il trigger che ha avviato l' esecuzione e lo stato attuale dell'esecuzione.

    

Componenti del workflow

Un workflow è costituito dai seguenti componenti:

• Trigger
• Passaggi
• Variabili

Trigger

I trigger sono eventi che avviano l'esecuzione di un workflow. La tabella seguente elenca i trigger supportati per i workflow:

Trigger	Descrizione	Campi di configurazione
Trigger manuale	Attiva l'esecuzione dell'agente del workflow su richiesta. Gli utenti possono avviare l'agente del workflow inserendo @ e il nome dell'agente del workflow da un prompt di chat dell'app Gemini Enterprise.	Campi di input: campi di input facoltativi o obbligatori che gli utenti possono fornire quando avviano il workflow.
Trigger di pianificazione	Attiva l'esecuzione del workflow a una frequenza specificata.	Frequenza: la frequenza con cui viene attivato il workflow. Puoi specificare la frequenza in minuti, ore, giorni, settimane, mesi o utilizzare un'espressione cron personalizzata. Fuso orario: il fuso orario per la frequenza.
Trigger di eventi	Attiva l'esecuzione del workflow quando i dati cambiano in un'app connessa.	Connettore: l'applicazione connessa che genera l'evento. Filtro: i criteri che devono essere soddisfatti affinché l'evento attivi il workflow.

Nota:i trigger di eventi definiscono la condizione iniziale per un workflow in base all'attività dell'app esterna (ad esempio, la ricezione di un'email). Sono configurati come trigger del workflow e non vengono visualizzati come nodi di passaggi intermedi nel flusso del canvas.

Passaggi

I passaggi sono singole attività eseguite dal workflow. Ogni passaggio viene eseguito in sequenza e il risultato di ogni passaggio può influenzare il passaggio successivo.

La tabella seguente elenca i passaggi supportati, suddivisi per tipo di azione eseguita:

Categoria	Passaggio	Descrizione	Campi di configurazione
Nodi dell'agente	Gemini Agent	Un agente basato sull'AI che puoi configurare per leggere, ragionare e rispondere in base a predefinite istruzioni.	Campi di input: Istruzioni: le istruzioni per Gemini Agent. Conoscenza: i file o le risorse aggiuntivi a cui Gemini Agent può accedere per generare risposte. Quando è configurato un datastore Google Drive o OneDrive, sono disponibili le opzioni Aggiungi da Drive e Aggiungi da OneDrive. Queste opzioni ti consentono di selezionare file o cartelle specifici, limitando la ricerca dell'agente solo a queste risorse. La ricerca viene eseguita live a ogni esecuzione dell'agente, quindi eventuali modifiche ai file di origine vengono immediatamente applicate. Importante: se lo strumento completo di Drive o OneDrive è attivato nello stesso nodo dell'agente, ha la precedenza e concede all'agente l'accesso illimitato alla ricerca. La soluzione alternativa consigliata è utilizzare due nodi Gemini Agent distinti. Il primo nodo deve utilizzare la conoscenza limitata per la ricerca, mentre il secondo nodo può utilizzare lo strumento completo per altre funzionalità, come la scrittura di aggiornamenti. App connesse: seleziona le applicazioni e le azioni connesse a cui l'agente può accedere in fase di runtime. Puoi selezionare in modo granulare le azioni di ricerca e attivare o disattivare le azioni di modifica dei dati. Per maggiori informazioni, vedi Configurare le app e le azioni connesse al nodo dell'agente. Modello: il modello Gemini utilizzato da Gemini Agent. Nota:sono supportati solo i modelli Gemini 3.0 e versioni successive. Campi di output: La risposta di Gemini Agent viene acquisita come variabile che può essere passata come input ai passaggi successivi del workflow. Formato di output: puoi specificare l'output come testo normale o in formato JSON strutturato. Schema JSON: quando utilizzi l'output strutturato, puoi definire uno schema JSON manuale per specificare il formato e i tipi di dati delle variabili di output, garantendo una gestione coerente dei dati durante l'orchestrazione.
Controllo del flusso	Condizione	Le condizioni sono istruzioni logiche che determinano la modalità di esecuzione dei passaggi del workflow. Definiscono i criteri che devono essere soddisfatti affinché un passaggio venga eseguito e possono essere basati sul risultato dei passaggi precedenti o origini dati esterne.	Campi di input: Nome ramo: il nome del ramo da eseguire se la condizione è vera. Variabile: la variabile da valutare. Puoi selezionare una variabile dall'output di precedenti. Operatore: l'operatore (ad esempio `contains`, `equals`, `greater than`) da utilizzare per la valutazione. Valore: il valore da confrontare con la variabile. Puoi specificare un valore statico, o selezionare una variabile dall'output dei passaggi precedenti. + Condizione: puoi aggiungere altre condizioni utilizzando operatori logici come `AND` e `OR`.
Human-in-the-loop	Richiedi informazioni	Ti consente di richiedere informazioni a un utente umano.	Campi di input: Messaggio: il messaggio da mostrare all'utente. Puoi specificare un messaggio statico, o selezionare una variabile dall'output dei passaggi precedenti. Domande: le domande da porre all'utente. Puoi specificare il tipo di risposta che stai richiedendo (ad esempio risposta breve, paragrafo, data, email, scelta singola, o sì o no). Campi di output: Le domande a cui l'utente ha risposto.

Configurare le app e le azioni connesse al nodo dell'agente

Quando configuri un nodo Gemini Agent , puoi controllare le app, i connettori e le azioni a cui l'agente può accedere in fase di runtime. Puoi limitare l'agente alle operazioni di ricerca di sola lettura o attivare le azioni di scrittura mutative.

Panoramica: funzionalità delle azioni del nodo dell'agente

Capacità	Categoria di azioni	Granularità della selezione	Caso d'uso di esempio
Ricerca e query	Search For Data	Per azione (attiva o disattiva le singole azioni)	Query ampie, ricerca di richieste, ricerca nelle knowledge base.
Modifica dei dati	Add Or Update Data	A livello di connettore (opzione di attivazione/disattivazione tutto o niente)	Creazione di richieste, aggiornamento dello stato dei problemi, invio di email.

Allegare e autorizzare un'app connessa

App

Per allegare un'app connessa a un nodo dell'agente:

1. Nel canvas del workflow, fai clic sul nodo Gemini Agent per aprire il relativo riquadro di configurazione.
2. In App connesse, individua il connettore o l'app che vuoi allegare (ad esempio Jira, Gmail o Google Drive).
3. Imposta l'opzione di attivazione/disattivazione del connettore su On.
   • Se è la prima volta che tu o la tua organizzazione utilizzate il connettore, completa il flusso di autorizzazione OAuth richiesto per concedere le autorizzazioni necessarie.
4. Fai clic sulla freccia di espansione () accanto al nome del connettore per attivare le azioni supportate dal connettore.

Selezionare le categorie di azioni

Ogni applicazione connessa organizza le proprie azioni in due categorie distinte:

• Search For Data: azioni che cercano, eseguono query, elencano o recuperano record dal servizio connesso.
  • Selezione granulare delle azioni: fai clic sull'icona Configura () accanto a Search For Data per visualizzare tutte le azioni di ricerca disponibili (ad esempio Search Events, List Events o List Calendars). Puoi attivare o disattivare le singole azioni in modo indipendente.
  • Filtri di ricerca deterministici: limita gli ambiti di ricerca configurando i filtri utilizzando elenchi a discesa strutturati o espressioni di query native, come Jira Query Language (JQL), Confluence Query Language (CQL), query di ricerca di Drive o operatori di ricerca di Gmail.
  • Test delle query in linea: convalida le query direttamente nel riquadro di configurazione per verificare che i filtri restituiscano i risultati previsti prima di eseguire il workflow.
• Aggiungi o aggiorna dati: azioni che creano, modificano, inviano o eliminano record nell'applicazione di destinazione (ad esempio, la creazione di un problema Jira o l'invio di un'email).
  • Opzione di attivazione/disattivazione a livello di connettore: l'opzione di attivazione/disattivazione delle azioni mutative funziona a livello di connettore. L'attivazione di questa opzione concede all'agente l'accesso a tutte le operazioni mutative supportate per quel connettore.

Nota:l'aggiunta o l'aggiornamento di dati tramite app connesse richiede una revisione umana. Se attivi un connettore, ma disattivi tutte le azioni sottostanti nelle categorie Search For Data e Add Or Update Data , l'agente non può interagire con il connettore in fase di runtime.

Requisito di dipendenza delle azioni

Attenzione: le azioni mutative dipendono dalle azioni di sola lettura e di ricerca per risolvere gli identificatori di entità in fase di runtime.

Le azioni mutative in genere richiedono che l'agente cerchi prima un identificatore di record (ad esempio un ID problema, un'email di contatto o un ID cartella) prima di eseguire un'operazione di aggiornamento, creazione o eliminazione.

Ad esempio, un'azione Update Jira issue richiede che l'agente esegua prima una query su Jira per ottenere l'issue_id interno. Se le azioni mutative sono attivate senza le azioni di ricerca di supporto, l'agente non può cercare i record di destinazione richiesti, il che causa errori di esecuzione delle azioni in fase di runtime (ad esempio ENTITY_NOT_FOUND o errori di parametri mancanti). Quando attivi le azioni mutative, attiva sempre le azioni di ricerca e recupero di supporto.

Esempio: limitare un agente alla ricerca di sola lettura di Jira

App

L'esempio seguente mostra come configurare un nodo Gemini Agent per cercare i problemi Jira senza consentire all'agente di creare o modificare i problemi:

1. Nel canvas del workflow, fai clic sul nodo Gemini Agent per aprire il relativo riquadro di configurazione.
2. In App connesse, imposta Jira su On (completa l'autorizzazione OAuth se richiesto).
3. Fai clic sulla freccia di espansione () accanto a Jira.
4. Assicurati che l'opzione di attivazione/disattivazione Search For Data sia impostata su On e imposta Add Or Update Data su Off.
5. Fai clic sull'icona Configura () accanto a Search For Data e verifica che siano attivate solo le azioni di ricerca di sola lettura desiderate (ad esempio Search Jira).

Risoluzione delle azioni e precedenza in fase di runtime

Quando il workflow viene eseguito, Gemini Agent seleziona e richiama le azioni in base alle seguenti regole di precedenza:

Stato configurazione	Esecuzione delle azioni in fase di runtime
Ricerca attivata	Espone le azioni standard di elenco e recupero per tutte le operazioni di ricerca attivate.
Azione di ricerca individuale disattivata	L'azione di ricerca specifica viene omessa dal catalogo delle azioni dell'agente.
Aggiungi / aggiorna dati attivato	Espone le azioni mutative insieme a tutte le azioni di ricerca attivate.
Aggiungi / aggiorna dati disattivato	Tutte le azioni di creazione, aggiornamento ed eliminazione dei dati sono bloccate per quel connettore.

Variabili

Le variabili sono valori che possono essere passati tra i passaggi di un workflow. Questi valori vengono generati come output dei passaggi e possono essere utilizzati come input per i passaggi successivi.

Versioni del workflow

Quando crei un workflow, puoi salvarlo come bozza o attivarlo. Dopo aver pubblicato il workflow, puoi creare altre versioni del workflow, salvarle, confrontarle e ripristinarle. Avere più versioni di un workflow può essere utile nei seguenti scenari:

• Vuoi testare una nuova versione del workflow senza interrompere la versione esistente.
• Vuoi ripristinare una versione precedente del workflow.

Per maggiori informazioni, vedi Gestire le versioni del workflow.

Problemi noti

Di seguito sono riportati i problemi noti e le limitazioni per i workflow in questa release:

• Supporto del linguaggio naturale
• Problemi di visualizzazione dei modelli email
• Affidabilità del linguaggio naturale
• Errori di caricamento della scheda Esecuzioni
• I connettori non vengono visualizzati dopo l'autorizzazione
• Timeout di esecuzione in caso di carico elevato
• Errore delle azioni disattivate
• Consigli sui modelli
• Formattazione del nodo di approvazione

Passaggi successivi

• Scopri come creare un workflow con linguaggio naturale.
• Scopri come utilizzare i modelli di workflow .
• Scopri come configurare i trigger di eventi.
• Scopri come condividere un workflow.
• Scopri come gestire le versioni del workflow.