Puoi configurare il workflow in modo che venga eseguito automaticamente quando i dati cambiano in un'app connessa.
I trigger di eventi utilizzano il polling per rilevare modifiche come nuove email, eventi di calendario aggiornati o nuovi file in un datastore connesso. Quando viene rilevata una modifica, viene eseguito il workflow configurato.
Prima di iniziare
Prima di utilizzare questa funzionalità, completa i seguenti passaggi:
- Assicurati di avere un'app web con le origini dati necessarie connesse. Per ulteriori informazioni, vedi Creare un'app, Connettere un'origine dati Google e Connettere un'origine dati di terze parti.
- 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 ulteriori informazioni, vedi Gestire le funzionalità delle app web.
- Assicurati che l'app che vuoi utilizzare come origine del trigger sia connessa come datastore nell'app Gemini Enterprise. Per ulteriori informazioni, vedi Connettere un datastore di terze parti.
App supportate
Le seguenti app supportano i trigger di eventi:
- Confluence
- Gmail
- Google Calendar
- Google Drive
- Jira Cloud
- OneDrive
- Outlook
- ServiceNow
- SharePoint
- Team
Configurare un trigger di eventi
App
- Apri l'app web Gemini Enterprise in un browser.
- Nel menu di navigazione, fai clic su Agenti.
- Fai clic su Crea agente.
- Fai clic su Avvia manualmente.
- Nella pagina Cosa deve attivare l'agente?, fai clic su Evento app.
- Nel riquadro dei dettagli, in Evento app - Scegli un'app da cui iniziare, cerca o sfoglia l'app che vuoi utilizzare. Fai clic sul nome dell'app per selezionarla.
- Seleziona l'evento che attiva il workflow. Gli eventi sono organizzati per categoria.
- Dopo aver selezionato un evento, il trigger viene aggiunto nella parte superiore del workflow nel builder di flusso.
- Fai clic su Aggiungi passaggio per aggiungere i passaggi del workflow che vengono eseguiti quando viene attivato il trigger.
Testare un agente con trigger di eventi
Prima di attivare l'agente del workflow, puoi testarne la funzionalità visualizzando in anteprima gli eventi trigger ed eseguendo simulazioni con dati di eventi di esempio.
Visualizzare in anteprima i risultati del trigger di eventi
App
- Nell'area di lavoro dell'agente del workflow, fai clic sul nodo del trigger di eventi nella parte superiore del workflow.
- Nel riquadro di configurazione a destra, fai clic su Visualizza risultati in anteprima.
- Gemini Enterprise recupera gli eventi recenti dall'app connessa. Ogni elemento mostra il titolo e il timestamp dell'evento. I risultati dell'anteprima di Google Calendar si basano su eventi aggiornati di recente e potrebbero non includere quelli più recenti.
- Puoi fare clic su un risultato dell'anteprima per visualizzare i dettagli dell'evento.
Testare il workflow dell'agente
App
- Passa alla scheda Test nell'area di lavoro dell'agente del workflow.
- Nella sezione di input del trigger, seleziona un evento di esempio dall'elenco degli eventi visualizzati in anteprima utilizzando il selettore Seleziona input.
- Fai clic su Avvia manualmente per eseguire la simulazione dell'agente del workflow utilizzando i dati sugli eventi di esempio.
- Al termine dell'esecuzione, espandi il riepilogo della simulazione per esaminare gli output e verificare che ogni passaggio abbia elaborato correttamente il payload del trigger.
Gestire i trigger di eventi
Puoi gestire i trigger di eventi modificandone la configurazione, attivando o disattivando gli agenti del workflow o eliminando i trigger.
NOTA: potrebbero essere necessari fino a 10 minuti prima che gli eventi vengano visualizzati.
- Modificare un trigger di eventi: apri l'agente in modalità di modifica, fai clic sul nodo del trigger nell'area di lavoro e aggiorna le impostazioni o i criteri di filtro nel riquadro di configurazione.
- Attivare un trigger di eventi: per attivare il trigger e iniziare il polling degli eventi, attiva l'agente del workflow. Per ulteriori informazioni, vedi Attivare o disattivare un agente del workflow.
- Disattivare un trigger di eventi: per mettere in pausa o disattivare il polling degli eventi, disattiva l'agente del workflow.
Problemi noti e limitazioni
Di seguito sono riportati i problemi noti e le limitazioni quando si utilizzano i trigger di eventi.
- Scollegamento del connettore: quando un amministratore scollega un connettore dal motore o dall'app, il trigger di eventi viene messo in pausa automaticamente. Tuttavia, non viene inviata alcuna notifica all'utente e gli utenti non possono visualizzare gli agenti in pausa nella loro galleria.
- Nuovi tentativi di sessione non riusciti: se l'esecuzione di un agente non riesce a causa di errori durante il recupero dei dati da un connettore associato in un trigger di eventi, viene creata una sessione con stato non riuscito. Al momento non sono supportati i nuovi tentativi manuali per le sessioni non riuscite.
- Filtri: aggiungi sempre filtri ai trigger di eventi per garantire un'esecuzione tempestiva dell'agente sugli eventi più importanti.
- Trigger di Gmail:
- L'inizializzazione dell'agente potrebbe essere più lenta per gli utenti con un volume elevato di email.
- Gmail supporta due trigger: Quando viene inviata un'email e Quando viene ricevuta un'email. Se vuoi attivare un agente inviandoti un'email, utilizza Quando viene inviata un'email. Se utilizzi Quando viene ricevuta un'email, l'agente non verrà attivato.
Per un elenco completo dei vincoli di sistema, vedi Quote e limiti di Workflow Builder.
Passaggi successivi
- Scopri come utilizzare le azioni del connettore.
- Scopri come eseguire ricerche con i filtri.
- Scopri come visualizzare i log di esecuzione degli agenti.
- Scopri come attivare o disattivare un agente del workflow.