Puoi configurare il workflow in modo che venga eseguito automaticamente quando i dati di un connettore cambiano.
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 connesse. Per saperne di più, 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 saperne di più, vedi Gestire le funzionalità delle app web.
- Assicurati che il connettore che vuoi utilizzare come origine del trigger sia connesso come datastore nella tua app Gemini Enterprise. Per saperne di più, vedi Connettere 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
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 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, il trigger viene aggiunto nella parte superiore del workflow nel builder di flussi.
- 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 il 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 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.
- 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.
Testare il workflow dell'agente
App
- Passa alla scheda Test nell'area di lavoro 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.
Gestire i trigger di eventi
Puoi gestire i trigger di eventi modificandone la configurazione, attivando o disattivando i 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 i workflow. Per saperne di più, vedi Attivare o disattivare un workflow.
- Disattivare un trigger di eventi: 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 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, all'utente non viene inviata alcuna notifica 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 configurare i connettori e le azioni dei nodi degli agenti.
- Scopri come eseguire ricerche con i filtri.
- Scopri come visualizzare i log di esecuzione degli agenti.
- Scopri come attivare o disattivare un workflow.