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 è ideale per i seguenti casi d'uso:

• Processi in più passaggi con logica di sequenza definita. Ad esempio, automatizzando una checklist di onboarding dei dipendenti su strumenti come Gmail e Calendar.
• Attività con automazione con l'AI e approvazioni umane. Ad esempio, la stesura di un report con l'AI che richiede l'approvazione dell'utente prima della pubblicazione.
• Orchestrazioni complesse con logica condizionale. Ad esempio, l'indirizzamento dei potenziali acquirenti a team diversi in base alla regione e al budget.

In Workflow Builder sono disponibili le seguenti funzionalità:

• Crea un workflow con il linguaggio naturale: descrivi il tuo workflow in un linguaggio semplice e genera automaticamente un'impalcatura del workflow.
• Utilizza i modelli di workflow: sfoglia e inizia da modelli predefiniti per casi d'uso commerciali comuni.
• Configura i trigger dei workflow: esegui i workflow automaticamente quando i dati cambiano nei connettori.
• Collega i connettori ai passaggi dell'agente: attiva gli strumenti di lettura e write-back (come Gmail, Jira e Google Drive) nei passaggi dell'agente Gemini per cercare dati, inviare messaggi e gestire i record.
• Utilizza i passaggi di controllo del flusso: aggiungi ramificazioni condizionali, filtri dei dati e loop al tuo workflow.
• Connetti i server MCP: connetti i server MCP come passaggi del workflow o come strumenti per i passaggi di Gemini Agent.
• Utilizza i passaggi human-in-the-loop: aggiungi al tuo workflow passaggi di revisione umana, approvazione e richiesta di informazioni.
• Aggiungi agenti esistenti al tuo workflow: trasferisci le attività ad altri agenti AI specializzati all'interno del tuo workflow.
• Gestisci le versioni dei workflow: salva, condividi, confronta e ripristina le versioni dei workflow.
• Modifica un workflow con il linguaggio naturale: modifica i workflow esistenti descrivendo le modifiche in linguaggio naturale.
• Visualizza i log di esecuzione dei workflow: monitora le esecuzioni dei workflow con tracce di esecuzione passo passo.
• Condividi un workflow: condividi i workflow attivi con altri utenti della tua organizzazione.

Connettori supportati

Workflows supporta i seguenti connettori:

• Gmail
• Google Calendar
• Google Chat
• Google Drive
• Confluence
• Confluence Data Center
• Jira
• Jira Data Center
• Microsoft Teams
• Notion
• OneDrive
• Outlook
• Salesforce
• SharePoint
• ServiceNow
• Slack

Prima di iniziare

Prima di esplorare queste nuove funzionalità, segui questi passaggi:

• 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 Gemini Enterprise con i datastore necessari collegati. Per saperne di più, consulta 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.

• Progettista conversazionale: il progettista 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. Questa opzione è 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 flusso di lavoro. Fornisce un flusso logico di nodi che rappresentano i passaggi e le connessioni tra di essi. L'editor visivo è ideale per gli utenti che vogliono perfezionare la logica del workflow, aggiungere logica condizionale e integrare vari strumenti e applicazioni.

  

  • Anteprima: la scheda Anteprima fornisce un'anteprima in tempo reale del workflow, consentendoti 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, tra cui 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
Attivatore manuale	Attiva l'esecuzione del workflow on demand. Gli utenti possono avviare il workflow inserendo @ e il nome del workflow da un prompt della chat dell'app Gemini Enterprise.	Campi di immissione: campi di immissione facoltativi o obbligatori che gli utenti possono fornire quando avviano il workflow.
Trigger di pianificazione	Attiva l'esecuzione del workflow con 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.
Attivatore di eventi	Attiva l'esecuzione del workflow quando i dati cambiano in un connettore.	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 di avvio di un workflow in base all'attività del connettore esterno (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.

Procedura

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

La tabella seguente elenca i passaggi supportati, classificati in base al tipo di azione che eseguono:

Categoria	Passaggio	Descrizione	Campi di configurazione
Nodi agent	Gemini Agent	Un agente basato sull'AI che puoi configurare per leggere, ragionare e rispondere in base a istruzioni predefinite.	Campi di immissione: Istruzioni: le istruzioni per l'agente Gemini. Conoscenza: i file o le risorse aggiuntivi a cui l'agente Gemini può accedere per generare risposte. Quando viene 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 in tempo reale a ogni esecuzione dell'agente, quindi le modifiche ai file di origine vengono applicate immediatamente. Importante: se lo strumento Drive o OneDrive completo è abilitato sullo stesso nodo agente, ha la precedenza e concede all'agente l'accesso di ricerca illimitato. La soluzione alternativa consigliata è utilizzare due nodi Gemini Agent distinti. Il primo nodo deve utilizzare le conoscenze limitate per la ricerca, mentre il secondo nodo può utilizzare lo strumento completo per altre funzionalità, come la scrittura di aggiornamenti. App connesse: seleziona i connettori e le azioni 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 saperne di più, consulta Configura i connettori e le azioni dei nodi agente. Modello: il modello Gemini utilizzato dall'agente Gemini. Nota: sono supportati solo i modelli Gemini 3.0 e versioni successive. Campi di output: La risposta dell'agente Gemini 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 un 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 dei dati coerente in tutta l'orchestrazione.
Controllo del flusso	Condizione	Le condizioni sono istruzioni logiche che determinano il modo in cui il workflow esegue i passaggi. Definiscono i criteri che devono essere soddisfatti per l'esecuzione di un passaggio e possono essere basate sul risultato dei passaggi precedenti o su origini dati esterne.	Campi di immissione: Nome del ramo: il nome del ramo da eseguire se la condizione è vera. Variabile: la variabile da valutare. Puoi selezionare una variabile dall'output dei passaggi precedenti. Operatore: l'operatore (ad esempio "contiene", "è uguale a", "maggiore di") 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	Consente di richiedere informazioni a un utente umano.	Campi di immissione: Messaggio: il messaggio da mostrare all'utente. Puoi specificare un messaggio statico o selezionare una variabile dall'output dei passaggi precedenti. Questions: le domande da porre all'utente. Puoi specificare il tipo di risposta che richiedi (ad esempio risposta breve, paragrafo, data, email, scelta singola o sì o no). Campi di output: Le domande a cui l'utente ha risposto.

Configura i connettori e le azioni dei nodi dell'agente

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

In sintesi: funzionalità di azione dei nodi agente

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

Collega e autorizza un connettore

App

Per collegare un connettore a un nodo agente:

1. Nel canvas del workflow, fai clic sul nodo Gemini Agent per aprire il relativo riquadro di configurazione.
2. In App collegate, individua il connettore che vuoi collegare (ad esempio Jira, Gmail o Google Drive).
3. Imposta l'opzione 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.

Seleziona le categorie di azioni

Ogni connettore organizza le proprie azioni in due categorie distinte:

• Cerca dati: azioni che cercano, eseguono query, elencano o recuperano record dal servizio connesso.
  • Selezione granulare delle azioni: fai clic sull'icona Configura () accanto a Cerca dati per visualizzare tutte le azioni di ricerca disponibili (come 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 menu 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).
  • Attivazione/disattivazione a livello di connettore: l'attivazione/disattivazione dell'azione di mutazione opera a livello di connettore. Se attivi questa opzione, l'agente ottiene l'accesso a tutte le operazioni di modifica supportate per quel connettore.

Nota:l'aggiunta o l'aggiornamento di dati tramite connettori richiede una revisione umana. Se attivi un connettore, ma disattivi tutte le azioni sottostanti nelle categorie Cerca dati e Aggiungi o aggiorna dati, l'agente non può interagire con il connettore in fase di runtime.

Requisito di dipendenza dell'azione

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

Le azioni mutative in genere richiedono che l'agente cerchi prima un identificatore del 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 Aggiorna problema Jira richiede che l'agente esegua prima una query su Jira per ottenere l'issue_id interno. Se le azioni di mutazione sono abilitate senza le azioni di ricerca di supporto, l'agente non può cercare i record target richiesti, il che causa errori di esecuzione delle azioni di runtime (come ENTITY_NOT_FOUND o errori di parametri mancanti). Quando attivi le azioni di mutazione, attiva sempre le azioni di ricerca e recupero di supporto.

Esempio: limita un agente alla ricerca Jira di sola lettura

App

L'esempio seguente mostra come configurare un nodo Agente Gemini per cercare i problemi di 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, attiva Jira (completa l'autorizzazione OAuth se richiesto).
3. Fai clic sulla freccia di espansione () accanto a Jira.
4. Assicurati che l'opzione Cerca dati sia On e imposta l'opzione Aggiungi o aggiorna dati su Off.
5. Fai clic sull'icona Configura () accanto a Cerca dati e verifica che siano attivate solo le azioni di ricerca di sola lettura desiderate (ad esempio Cerca in Jira).

Risoluzione delle azioni e precedenza 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 di runtime
Ricerca attivata	Espone le azioni standard di elenco e recupero per tutte le operazioni di ricerca abilitate.
Azione di ricerca individuale disattivata	L'azione di ricerca specifica viene omessa dal catalogo delle azioni dell'agente.
Aggiungi / aggiorna dati abilitati	Espone le azioni di mutazione insieme a tutte le azioni di ricerca abilitate.
Aggiunta / aggiornamento dei dati disattivata	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 attivato il workflow, puoi creare versioni aggiuntive del workflow, salvarle, confrontarle e ripristinarle. Avere più versioni di un flusso di lavoro 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 saperne di più, consulta Gestisci le versioni dei 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 di 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
• Suggerimento per il modello
• Formattazione del nodo di approvazione

Passaggi successivi

• Scopri come creare un workflow con il linguaggio naturale.
• Scopri come utilizzare i template di workflow.
• Scopri come configurare gli attivatori di eventi.
• Scopri come condividere un workflow.
• Scopri come gestire le versioni dei workflow.