Condividi tramite


Aggiungere un trigger di evento (anteprima)

I trigger di eventi consentono al tuo agente di reagire automaticamente quando si verifica un evento in altri sistemi. È quindi possibile definire un flusso specifico di azioni che l'agente deve eseguire in risposta o fornire all'agente istruzioni su come determinare le azioni migliori da intraprendere.

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.

Per indicazioni approfondite sul funzionamento dei trigger di evento e sulla correlazione con altri componenti di un agente, vai a Panoramica dei trigger di evento.

Nota

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

Per aggiungere un trigger di eventi all'agente:

  1. Nella pagina Panoramica dell'agente, vai alla sezione Trigger.

  2. Seleziona Aggiungi trigger. Screenshot del pannello Trigger nella pagina Panoramica.

  3. Seleziona il trigger desiderato.

  4. Fornisci i tuoi dettagli di autenticazione, se necessario.

  5. Seleziona Avanti.

    Nota

    Puoi usare i connettori di trigger di autenticazione solo usando l'account dell'autore agente (autenticazione dell'autore dell'agente). Puoi impostare un trigger per il tuo agente solo in base agli eventi nei sistemi a cui disponi dell'autorizzazione di accesso come autore agente. Per maggiori informazioni, vedi Limitazioni trigger di eventi.

  6. Configura il trigger in base alle esigenze e definisci i parametri dell'evento che attivano il trigger e il payload del trigger. I trigger forniscono contenuto di payload predefinito, ma puoi aggiungere contenuto e istruzioni personalizzati. Per altre informazioni, vai a Definire il payload del trigger.

Affinché un agente reagisca a un trigger di evento, l'agente ha bisogno di azioni o argomenti da chiamare nella sua risposta e di istruzioni su quali chiamare. Per ulteriori informazioni, vedere Chiamare un'azione o un argomento.

Testare un trigger

Testa sempre un trigger e la sua reazione prima di pubblicarlo. Puoi testare come il tuo agente reagisce al trigger definito usando la chat dell'agente di prova.

Prima di pubblicare l'agente con un nuovo trigger di evento, l'agente non reagirà automaticamente al trigger. Invece, devi attivare manualmente il tuo agente selezionando un payload del trigger da inviare al tuo agente.

  1. Esegui l'evento di trigger una volta per generare un payload. Ad esempio, se si utilizza il trigger Quando mi viene assegnata una nuova attività di Microsoft Planner, assegna un'attività di prova a te stesso in Microsoft Planner per attivare il trigger.
  2. Seleziona l'icona Prova trigger accanto al trigger nella pagina Panoramica dell'agente. L'elenco include tutte le istanze recenti dell'evento.
  3. Scegli l'istanza che desideri provare e seleziona Avvia prova. Screenshot che mostra un payload di test da selezionare.

Puoi utilizzare la mappa attività per vedere come il tuo agente reagisce al payload del trigger durante i test. Per aprire la mappa attività, seleziona l'icona della mappa nella parte superiore del riquadro di test.

Modificare un trigger

Dopo aver creato un trigger, puoi modificare i parametri dell'evento e il payload attraverso Power Automate. Per aprire il trigger da Copilot Studio:

  1. Nella pagina Panoramica, trova il trigger.
  2. Seleziona l'icona Altro (), quindi Apri in Power Automate. Screenshot sull'apertura Power Automate per modificare un trigger.
  3. Seleziona il trigger, quindi vai alle schede Parametri e Codice per apportare le modifiche. Per informazioni sulle variabili e sugli operatori stringa che è possibile aggiungere, vai alla scheda Informazioni su .
  4. Apportare e salvare le modifiche. Per ulteriori informazioni su come apportare modifiche in Power Automate, vedi Introduzione ai trigger in Power Automate.

Pubblica un agente con un trigger

Dopo aver pubblicato un agente con trigger di evento, questo reagisce automaticamente ogni volta che vengono attivati i trigger dell'agente. Puoi vedere un registro dettagliato dei trigger e delle reazioni del tuo agente nella pagina Attività.

I trigger di eventi possono utilizzare solo le credenziali dell'autore dell'agente per l'autenticazione, ovvero le credenziali utilizzate per autorizzare le connessioni. Ciò può consentire agli utenti di un agente senza la propria autorizzazione la possibilità di accedere a dati e sistemi che non dovrebbero. Per maggiori informazioni, vai a Risoluzione dei problemi e limitazioni.