Panoramica dei trigger di evento

Puoi configurare agenti personalizzati per eseguire azioni o chiamare argomenti in risposta a qualcosa che accade utilizzando i trigger di eventi. A differenza dei trigger di argomento, che richiedono l'input di un utente, i trigger di eventi consentono all'agente di agire in modo autonomo in risposta al verificarsi dell'evento definito.

Importante

L'abilitazione dei trigger di evento può influire sul modo in cui viene calcolata la fatturazione. Scopri di più sulla fatturazione per la modalità generativa.

Nota

Questa funzionalità è disponibile solo per gli agenti che hanno l'orchestrazione generativa abilitata.

Come funzionano i trigger di eventi

I trigger di eventi richiedono un evento scelto, che genera un payload del trigger e lo invia all'agente tramite un connettore. Il payload contiene informazioni sull'evento, incluse variabili per tipi specifici di dati. Quando l'agente riceve il payload, esegue le indicazioni fornite dall'autore dell'agente nelle istruzioni dell'agente e nelle istruzioni inviate tramite il payload del trigger.

Gli agenti agiscono solo in base alla progettazione e alle istruzioni del loro autore. Ad esempio, puoi aggiungere un trigger per l'aggiunta di un nuovo membro del team e designare la risposta come l'azione di invio al nuovo dipendente di un messaggio di benvenuto con le risorse di onboarding.

I trigger di evento si attivano in base a eventi esterni all'agente. Sono diversi dai trigger di argomento, che vengono usati per attivare argomenti o azioni in base alle frasi trigger immesse dagli utenti.

Questo articolo spiega come funzionano i trigger di evento, le relative limitazioni e le strategie di risoluzione dei problemi. Per ulteriori informazioni sull'aggiunta di un trigger di evento, vedi Aggiungere un trigger di evento.

Altri esempi di trigger di eventi includono:

• Quando viene creato un elemento in SharePoint
• Quando un file viene creato in OneDrive
• Quando un'attività viene completata in Planner
• Una determinata quantità di tempo trascorso (un trigger di ricorrenza)

Importante

I trigger disponibili dipendono dai criteri di prevenzione della perdita dei dati dell'organizzazione, configurati in Power Automate da un amministratore.

Fatturazione e utilizzo per i trigger di eventi

L'attività del trigger di evento viene conteggiata ai fini delle unità di consumo per l'utilizzo e la fatturazione. Per messaggio si intende qualsiasi richiesta o messaggio inviato all'agente che attiva un'azione o una risposta dell'agente. Sono inclusi i payload inviati agli agenti dai trigger di eventi. Ad esempio, un trigger di ricorrenza impostato per attivarsi ogni 10 minuti invia un payload del trigger come messaggio a un agente ogni 10 minuti.

Per ulteriori informazioni, vai a Gestisci messaggi e capacità Copilot Studio.

Il flusso di lavoro del trigger

Un trigger è una parte di un flusso di lavoro che contiene più parti:

1. Un trigger di eventi registra che si è verificato un evento specifico.
2. Il trigger invia un payload contenente informazioni sull'evento e istruzioni.
3. L'agente ha le istruzioni per scegliere una o più azioni o argomenti in base al payload.

Trova il trigger più adatto al tuo evento

Copilot Studio dispone di una raccolta di trigger per una serie di eventi che possono verificarsi in Microsoft e nei servizi partner. La configurazione del trigger determina i parametri dell'evento che avvia il trigger. Determina inoltre il contenuto del payload del trigger.

La maggior parte dei trigger consente di specificare parametri relativi all'evento che attiva il trigger. Ad esempio, nel trigger Quando una riga viene aggiunta, modificata o eliminata per Dataverse, seleziona le modifiche alla tabella che attivano il trigger.

Definizione del payload del trigger

Il payload del trigger è un messaggio JSON o di testo normale che contiene informazioni su un evento e viene inviato al tuo agente come messaggio. Quando aggiungi un trigger, puoi mantenere il contenuto del payload predefinito per quel trigger o aggiungere le tue istruzioni. Successivamente, puoi modificare il contenuto del payload, inclusa l'aggiunta di variabili e operatori stringa, in Power Automate.

Ad esempio, il messaggio predefinito nel trigger Quando una riga viene aggiunta, modificata o eliminata è Usa contenuto da Body. Quando l'agente riceve il payload, contiene il contenuto della riga e le istruzioni per utilizzarlo.

Puoi aggiungere istruzioni da inviare all'agente all'interno del payload che indirizzano l'agente su come agire quando attivato dal trigger. Se disponi di più trigger, ogni payload del trigger può avere istruzioni specifiche e dettagliate. Di conseguenza, puoi evitare di scrivere linee guida lunghe e complicate nelle istruzioni generali dell'agente o confondere l'agente su quali istruzioni si applicano a quale trigger.

Ad esempio, in un payload del trigger Quando una riga viene aggiunta, modificata o eliminata, puoi aggiungere Invia un riepilogo delle modifiche nella chat. Quando l'agente riceve il payload, riepiloga le modifiche per l'utente nella chat dell'agente.

Tuttavia, evita di scrivere istruzioni di payload in conflitto con le istruzioni generali dell'agente. I conflitti nelle istruzioni possono causare errori o risultati imprevisti. Assicurati di testare tutte le modifiche che coinvolgono i trigger di eventi.

Dopo aver creato un trigger, puoi aggiungere o modificare variabili o operatori di stringa in un payload del trigger e modificare le istruzioni di un payload esistenti utilizzando Power Automate.

Istruzioni dell'agente vs istruzioni del payload

Le istruzioni del payload sono specifiche su come reagire a un evento. Puoi anche usare le istruzioni agente per indirizzare il tuo agente su come gestire le informazioni da un trigger e su come agire quando riceve un payload del trigger, nonché per determinare il comportamento generale del tuo agente. Ad esempio, per un agente che verifica la presenza di nomi di account duplicati nelle nuove righe della tabella Dataverse, le istruzioni potrebbero essere: Quando viene aggiunta una nuova riga, controlla se si tratta di un account duplicato. Se è presente un duplicato, crea un'attività da eseguire per l'analisi e includi i dettagli sulle modifiche e sui duplicati.

Tuttavia, le istruzioni agente potrebbero non essere la soluzione migliore per tutte le situazioni. Se l'agente ha più trigger o più obiettivi complessi, dovresti invece usare le istruzioni nel payload del trigger.

Continuando con l'ultimo esempio, puoi aggiungere un'istruzione nel payload del trigger per Cercare nomi di account duplicati nella stessa tabella Dataverse. Quando l'agente riceve il payload, gli viene chiesto di cercare nomi di account duplicati. Le istruzioni generali dell'agente riportano Se c'è un duplicato, crea un'attività Cose da fare per indagare e includi i dettagli sulle modifiche e sui duplicati.

La creazione di istruzioni per gli agenti richiede pratica. Vai alla guida alla scrittura per ulteriori suggerimenti e testa sempre tutte le modifiche apportate all'agente.

Chiamare un'azione o un argomento

Quando un agente riceve un payload del trigger, le istruzioni che gli fornisci determinano l'azione o l'argomento che chiama in risposta, in base alle informazioni che ha a disposizione.

L'agente non crea una nuova azione o un nuovo argomento sul momento. In qualità di autore di agente, devi definire le azioni o gli argomenti che può selezionare. Per sapere in che modo l'agente determina l'azione o l'argomento da chiamare, vai a Come funziona l'orchestrazione generativa?

Se l'agente non reagisce come previsto, puoi utilizzare la mappa delle attività per vedere se manca qualche informazione di input chiave.

Di seguito sono riportati alcuni miglioramenti che è possibile apportare alle istruzioni:

• Aggiunta di istruzioni più dettagliate nel payload del trigger o nelle istruzioni dell'agente. L'agente potrebbe aver bisogno di più indicazioni, ad esempio quali informazioni usare in un campo di input specifico per l'azione.
• Inclusione di istruzioni nel trigger del payload.
• Indica all'agente di richiamare un'azione o un argomento specifico.
• Verifica della presenza di istruzioni in conflitto tra il payload del trigger e le istruzioni dell'agente.
• Aggiunta alle descrizioni delle azioni, in modo che l'agente abbia più informazioni per determinare quando richiamarlo.
• Aggiunta di descrizioni ai campi di input delle azioni per aiutare l'agente a compilare correttamente i parametri. Se gli input di un'azione sono sempre gli stessi, puoi impostare tu stesso il valore.
• Richiamare meno di 15 azioni o argomenti consecutivamente. Gli agenti complessi che eseguono molte azioni o argomenti come una singola sequenza possono avere difficoltà a eseguirli in modo affidabile.

Se l'agente ha ancora difficoltà a chiamare l'azione prevista, prendi in considerazione l'aggiunta di un Power Automate flusso che soddisfi il tuo obiettivo come azione per il tuo agente.

Pubblicazione di agenti con trigger di eventi

Prima di pubblicare l'agente con un nuovo trigger di evento, l'agente non reagisce automaticamente a tale trigger. Assicurati di testare accuratamente l'agente prima della pubblicazione, perché dopo aver pubblicato un agente con un nuovo trigger, l'agente reagisce automaticamente ogni volta che i suoi trigger vengono attivati. Nella pagina Attività è possibile visualizzare un record dettagliato dei trigger e delle reazioni dell'agente.

Per informazioni sull'attivazione dei trigger durante il test, vai a Testare un trigger.

I trigger di evento possono utilizzare solo le credenziali dell'autore agente per l'autenticazione (ovvero le credenziali utilizzate per autorizzare le connessioni) per il trigger. Ciò potrebbe consentire agli utenti di un agente di utilizzare l'agente per accedere a dati e sistemi utilizzando la stessa autorizzazione. Per maggiori informazioni, vai a Risoluzione dei problemi e limitazioni.

Autenticazione delle azioni dopo la pubblicazione

Se all'agente manca l'autenticazione per eseguire un'azione o è configurato per richiedere l'autenticazione dell'utente, invia un messaggio all'utente per richiedere le credenziali. Se il flusso di un agente viene interrotto perché non riesce a ricevere informazioni o un'azione non è riuscita, non può continuare la sessione. Se vuoi che il agente venga eseguito in modo autonomo, ogni azione deve essere configurata con un'autenticazione autore funzionante che non richieda l'input dell'utente. Puoi anche indicare al tuo agente di non richiedere credenziali agli utenti.

Poiché i trigger utilizzano l'autenticazione autore, tieni presente a quali dati i potenziali utenti possono accedere tramite un agente pubblicato che dispone di trigger. Per altre informazioni, vedi la sezione Protezione dei dati con trigger.

Risoluzione dei problemi e limitazioni

Limitazioni quote

Se i trigger si attivano troppo frequentemente, l'agente potrebbe finire per utilizzare più risorse del previsto. L'agente potrebbe quindi superare i limiti della quota di carico e il servizio potrebbe essere limitato.

Gli amministratori possono monitorare l'utilizzo delle risorse tramite Power Platform Possono anche bloccare i trigger di evento in un ambiente.

Per evitare il superamento dei limiti di quota:

• Fai attenzione quando si aggiungi trigger molto frequenti o trigger che si ripetono all'infinito. Ad esempio, un trigger di ricorrenza si attiva ogni volta che trascorre un determinato periodo di tempo. Minore è la quantità di tempo tra un'attivazione e l'altra, maggiore è la quantità di risorse utilizzate dal trigger.
• Tieni traccia di quanti trigger sono attivi in un ambiente.

Protezione dei dati per gli agenti con trigger

Attualmente, i trigger di evento possono utilizzare solo le credenziali dell'autore dell'agente per l'autenticazione. Inoltre, affinché l'agente possa essere eseguito in modo autonomo, tutti i trigger e le azioni che richiedono l'autenticazione devono utilizzare le credenziali dell'autore.

Se pubblichi un agente con trigger di eventi autenticati, gli utenti potrebbero essere in grado di accedere alle informazioni o richiedere all'agente di eseguire azioni utilizzando le credenziali dell'autore. Se gli autori configurano un agente con un trigger di evento autenticato, questa limitazione viene ricordata prima di pubblicare l'agente.

I payload dei trigger possono potenzialmente contenere informazioni riservate che un agente può generare in altre posizioni tramite azioni. Ad esempio, se hai creato un agente che utilizza le informazioni dei messaggi e-mail in arrivo per popolare nuove righe nelle tabelle Dataverse.

Gli amministratori possono impedire agli utenti Copilot Studio di utilizzare i trigger di eventi con i propri agenti. Per altre informazioni, vedi Bloccare i trigger di evento.

Procedure consigliate per la protezione dei dati

Per impedire agli utenti di accedere ai dati sensibili:

• Valutare se e come i dati e i sistemi che richiedono l'autenticazione vengono utilizzati dagli agenti con trigger di eventi.
• Comprendere quali informazioni possono includere i trigger nei payload e quali azioni di informazione vengono generate utilizzando tali input di payload attraverso i test.
• Restringi l'ambito di ciò che attiva un trigger utilizzando i parametri del trigger e fornisci istruzioni al tuo agente su come gestire i dati del payload.

La condivisione del flusso cloud con riconoscimento della soluzione deve essere attivata

I creatori possono aggiungere trigger di eventi agli agenti solo negli ambienti in cui è attivata la condivisione del flusso cloud con riconoscimento della soluzione.

Se non puoi aggiungere trigger e i criteri di prevenzione della perdita dei dati della tua organizzazione consentono i trigger, questa opzione potrebbe essere disattivata nel tuo ambiente. Contatta l'amministratore del tuo ambiente per attivare la condivisione cloud con riconoscimento della soluzione.

Risoluzione dei problemi relativi al connettore

Gli agenti potrebbero non essere in grado di eseguire correttamente tutti i connettori. Se un agente non riesce ripetutamente a richiamare un connettore, è consigliabile creare un'azione del flusso di Power Automate che usi il connettore problematico per completare l'azione.