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 del 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 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 il pulsante di attivazione/disattivazione della funzionalità Workflow Builder nelle impostazioni di gestione delle funzionalità dell'app. Per maggiori informazioni, vedi Gestire 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 Collegare 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, 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 alla parte superiore del flusso di lavoro nel builder di flussi.
- Fai clic su Aggiungi passaggio per aggiungere i passaggi del workflow che vengono eseguiti quando viene attivato l'attivatore.
Testare un agente con trigger di eventi
Prima di attivare il flusso di lavoro, puoi testarne la funzionalità visualizzando l'anteprima degli eventi trigger ed eseguendo simulazioni con dati di esempio degli eventi.
Visualizzare l'anteprima dei risultati del trigger evento
App
- Nel canvas del flusso di lavoro, fai clic sul nodo del trigger dell'evento nella parte superiore del flusso di lavoro.
- Nel riquadro di configurazione a destra, fai clic su Visualizza 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 di anteprima per visualizzare i dettagli dell'evento.
Testare il workflow dell'agente
App
- Passa alla scheda Test nel canvas del flusso di lavoro.
- 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 flusso di lavoro utilizzando i dati degli 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 evento
Puoi gestire i trigger di eventi modificandone la configurazione, attivando o disattivando i flussi di lavoro o eliminando i trigger.
NOTA: gli eventi possono richiedere fino a 10 minuti per essere visualizzati.
- Modificare 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.
- Attivare un attivatore di eventi:per attivare l'attivatore e iniziare a eseguire il polling degli eventi, attiva i flussi di lavoro. Per saperne di più, vedi Attivare o disattivare un flusso di lavoro.
- Disattivare 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 quando si lavora con i trigger di eventi.
- Scollegamento del connettore:quando un amministratore scollega un connettore dal motore o dall'app, il trigger dell'evento 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.
- Tentativi di sessione non riusciti:se l'esecuzione di un agente non va a buon fine a causa di errori nel 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 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 flusso di lavoro.