Puoi configurare il workflow in modo che venga eseguito automaticamente quando i dati cambiano in un connettore.
I trigger di eventi utilizzano il polling per rilevare modifiche come nuove email, eventi nel 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 collegate. Per saperne di più, vedi Crea un'app, Connetti un'origine dati Google e Connetti 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 maggiori informazioni, vedi Gestisci le funzionalità dell'app web.
- Assicurati che il connettore che vuoi utilizzare come origine del trigger sia collegato come datastore nell'app Gemini Enterprise. Per ulteriori informazioni, vedi Collega un datastore di terze parti.
Connettori supportati
I seguenti connettori supportano i trigger di eventi:
- Confluence
- Gmail
- Google Calendar
- Google Drive
- Jira Cloud
- OneDrive
- Outlook
- ServiceNow
- SharePoint
- Team
Configura 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, sfoglia o cerca il connettore che vuoi utilizzare. Fai clic sul nome del connettore per selezionarlo.
- Seleziona l'evento che attiva il workflow. Gli eventi sono organizzati per categoria.
- Dopo aver selezionato un evento, l'attivatore viene aggiunto all'inizio del workflow nel generatore di flussi.
- Fai clic su Aggiungi passaggio per aggiungere i passaggi del workflow che vengono eseguiti quando viene attivato il trigger.
Testa un agente con trigger di eventi
Prima di attivare il workflow, puoi testarne la funzionalità visualizzando l'anteprima degli eventi di attivazione ed eseguendo simulazioni con dati sugli eventi di esempio.
Visualizza l'anteprima dei risultati dei trigger di eventi
App
- Nel canvas del workflow, fai clic sul nodo di attivazione dell'evento nella parte superiore del workflow.
- Nel riquadro di configurazione a destra, fai clic su Anteprima risultati.
- Gemini Enterprise recupera gli eventi recenti dal connettore. 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.
Testa il workflow dell'agente
App
- Passa alla scheda Test nel canvas 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 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.
Gestisci i trigger di eventi
Puoi gestire i trigger di eventi modificandone la configurazione, attivando o disattivando i workflow o eliminando i trigger.
NOTA: gli eventi possono richiedere fino a 10 minuti per essere visualizzati.
- Modifica un trigger di evento: apri l'agente in modalità di modifica, fai clic sul nodo del trigger nel canvas e aggiorna le impostazioni o i criteri di filtro nel riquadro di configurazione.
- Attiva un trigger di evento: per attivare il trigger e iniziare il polling degli eventi, attiva i workflow. Per saperne di più, vedi Attiva o disattiva un workflow.
- Disattiva un trigger di evento: per mettere in pausa o disattivare il polling degli eventi, disattiva il workflow.
Problemi noti e limitazioni
Di seguito sono riportati i problemi noti e le limitazioni relativi all'utilizzo dei trigger di eventi.
- Scollegamento del connettore: quando un amministratore scollega un connettore dal motore o dall'app, l'attivatore 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 va a buon fine a causa di errori di recupero dei dati da un connettore associato in un trigger di evento, viene creata una sessione con stato non riuscito. I nuovi tentativi manuali per le sessioni non riuscite non sono attualmente supportati.
- 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, consulta Quote e limiti di Workflow Builder.
Passaggi successivi
- Scopri come configurare connettori e azioni dei nodi agente.
- Scopri come eseguire ricerche con i filtri.
- Scopri come visualizzare i log di esecuzione degli agenti.
- Scopri come attivare o disattivare un workflow.