Condividi tramite


Panoramica dei trigger di evento (anteprima)

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

Importante

L'uso dei trigger di evento è una funzionalità di anteprima pubblica. L'uso dei trigger di evento è gratuito per i partecipanti all'anteprima, ma richiede messaggi che vengono conteggiati ai fini delle quote di utilizzo. Le funzionalità di anteprima non sono destinate a essere utilizzate per la produzione e sono soggette a restrizioni. Vengono rese disponibili prima di una versione ufficiale in modo che i clienti possano accedervi con anticipo e fornire i loro commenti.

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 al design 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 al 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, vedere 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.

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.

Screenshot della libreria dei trigger di evento.

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. Il payload 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.

Screenshot dei campi per la definizione di un trigger.

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, senza che tu debba scrivere una guida lunga e complicata nelle istruzioni generali dell'agente o confondere l'agente su quali istruzioni applicare 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 Dataverse righe della tabella, 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.

Screenshot del campo delle istruzioni dell'agente.

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.

Screenshot del campo per l'aggiunta delle istruzioni di payload del trigger quando crei un trigger.

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 hai dato determinano l'azione o l'argomento che chiama in risposta. Le istruzioni permettono all'agente di selezionare un'azione o un argomento in base alle informazioni disponibili.

Il tuo 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 il agente determina l'azione o l'argomento da chiamare, vai a Come funziona la modalità generativa?

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

Screenshot di una mappa attività che mostra un'azione con un input mancante.

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. Il tuo 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 gestirne l'esecuzione in modo affidabile.

Se il tuo 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. Puoi vedere un registro dettagliato dei trigger e delle reazioni del tuo agente nella pagina Attività.

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ò può 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 funzionante che non richieda l'input dell'utente. Puoi anche indicare al tuo agente di non richiedere credenziali agli utenti.

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.

Risoluzione dei problemi e limitazioni

Limitazioni quote

Se i trigger si attivano troppo frequentemente, il tuo agente potrebbe finire per utilizzare più risorse del previsto. Il tuo agente potrebbe quindi superare i limiti della quota di carico del servizio e il tuo 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.

I trigger possono utilizzare solo le credenziali dell'autore

Attualmente, i trigger di evento possono utilizzare solo le credenziali dell'autore agente per l'autenticazione. Se pubblichi o condividi un agente con trigger di eventi autenticati, gli utenti potrebbero essere in grado di accedere alle informazioni o richiedere al agente di eseguire azioni utilizzando le credenziali dell'autore.

Per impedire agli utenti di accedere o modificare dati o sistemi protetti, valutare attentamente se e come i dati e i sistemi che richiedono l'autenticazione vengono utilizzati dagli agenti con trigger di evento. Gli autori devono prestare attenzione quando condividono o pubblicano agenti contenenti trigger di eventi.

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

Limitazioni relative all'utilizzo delle origini della Knowledge Base con trigger di evento

Gli agenti non possono fare riferimento ad alcune origini della Knowledge Base in risposta a un trigger di evento. Alcune origini della Knowledge Base richiedono un agente per fornire l'autenticazione per l'accesso, ma gli agenti non possono fornire tale autenticazione in modo autonomo.

Evita queste fonti di conoscenza, quando vi si fa riferimento in risposta a un trigger di evento:

  • SharePoint
  • Dataverse
  • Connettori Graph
  • Richieste di AI Builder

Fai invece riferimento a queste fonti di conoscenza in risposta a un trigger di evento:

  • Siti Web pubblici
  • File caricati
  • Dati enterprise, usando i connettori