Aggiungi trigger a un agente (GitHub Copilot) (anteprima)

[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]

Usa trigger per creare agenti autonomi alimentati dal harness GitHub Copilot. Gli agenti autonomi si attivano quando si verifica un evento in un servizio connesso. Ad esempio, un agente può rispondere quando un elemento viene creato in SharePoint, arriva un'email o scatta un'ora pianificata.

Il trigger invia i dettagli dell'evento all'agente. Le istruzioni e gli strumenti del tuo agente determinano cosa farà l'agente con quei dettagli.

Annotazioni

Il framework utilizzato per costruire questo agente utilizza una fatturazione basata sull'uso. Utilizzare, costruire, testare e valutare agenti potrebbe consumare Copilot Credits. Scopri di più in Panoramica della fatturazione basata sull'uso.

[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]

Prima di aggiungere un trigger

Prima di aggiungere un trigger:

Aggiungi e configura un trigger

  1. Apri l'agente in Copilot Studio.

  2. Selezionare Triggers.

    Screenshot del pannello di configurazione dell'agente in Copilot Studio con la sezione Trigger evidenziata, che mostra trigger come Chat con l'agente e Nuova email.

  3. Selezionare il trigger.

  4. Configurare il trigger:

    1. Configura la connessione usata per il trigger. Se vedi un segno verde, la tua connessione funziona. Se non vedi una spunta verde, seleziona l'account, poi scegli un altro account o crea una nuova connessione.

      Screenshot del pannello di attivazione della nuova email con la connessione Office 365 Outlook evidenziata, che mostra un'icona di avviso invece di un segno verde.

      Annotazioni

      Alcuni trigger, come i trigger Recurrence, Copilot e Teams, non richiedono una verifica della connessione.

    2. Opzionalmente, aggiungi istruzioni extra che vuoi inviare al tuo agente per questo trigger. Questo passaggio è particolarmente importante quando hai più trigger nel tuo agente e ciascuno guida l'esecuzione dell'agente in modo diverso.

    3. Configura le opzioni di Trigger che determinano quando l'agente deve essere invocato quando viene rilevato l'evento di trigger.

    4. Se condividi questo agente con altri utenti, scegli quali opzioni gli utenti possono o non possono configurare da soli attivando o disattivando Editable by user per ogni opzione.

      Schermata delle opzioni del trigger Nuovo messaggio email con i campi Cartella, To, CC e To o CC e gli interruttori «Modificabile dall'utente» attivati e evidenziati.

    5. Espandi i parametri avanzati per configurare qualsiasi parametro avanzato ti serve.

  5. Seleziona Aggiungi trigger.

Test e pubblica l'agent

Testa ogni trigger prima di pubblicare l'agente.

  1. Testa un trigger selezionando il pulsante con l'icona della fiaschetta ( ). Per arrivare al pulsante, procedi in uno dei seguenti modi:

    • Seleziona il trigger dalla scheda Build .
    • Apri la scheda Anteprima .
  2. Esegui una delle operazioni seguenti:

    • Seleziona Inizia ad ascoltare per il primo test. Genera un evento che corrisponda alla configurazione del trigger, come inviare un'email o creare un elemento SharePoint. Il tuo agente aspetta che si verifichi l'evento trigger e reagisce eseguendo un test. Sulla base dei risultati, modifica le istruzioni, gli strumenti, la personalizzazione dei trigger o il messaggio del tuo agente per adattarli alle tue esigenze.
    • Scegli un evento trigger precedente (ultima email, file e così via) dall'elenco Test con eventi trigger precedenti. Questa azione invoca l'agente con quell'evento di attivazione.

Pubblica e attiva un agente autonomo

L'agente non si esegue autonomamente finché non lo pubblichi. Ripubblica l'agente dopo aver cambiato un trigger, le sue istruzioni o i suoi strumenti. Aggiornare un agente richiede agli utenti di accettare le nuove modifiche.

  1. Seleziona Pubblica per aggiornare l'ultima versione dell'agente con il trigger.

  2. Dopo aver pubblicato, usa la finestra di conferma per scegliere chi vuoi che utilizzi l'agente:

    • Attivalo per me: Solo tu, il maker, puoi usare l'agente, usando le tue credenziali maker.
    • Condividi con altri: Permette agli altri utenti di usare l'agente, con le proprie credenziali. Devi anche condividere l'agente con quegli utenti.

    Screenshot della finestra di dialogo 'Il tuo agente è stato pubblicato' con le opzioni Attiva questo agente per me e Condividi con gli altri.

Attivami

Annotazioni

L'uso degli agenti autonomi viene fatturato secondo le tariffe di fatturazione di Copilot Studio.

Attiva per me ti porta alla gestione agenti, dove attivi l'agente. Dopo aver attivato l'agente, il suo agente inizia a funzionare per tuo conto.

Puoi anche accedere a Gestione agenti e attivare il tuo agente autonomo dal link sotto il nome dell'agente.

Condividi con altri

Per consentire alle persone di usare un agente autonomo con le proprie credenziali, configurare i suoi trigger e strumenti per l'autenticazione degli utenti, quindi condividere l'agente pubblicato. I destinatari completano tutte le connessioni richieste e possono modificare solo le opzioni di trigger che permetti.

Annotazioni

L'utilizzo autonomo di ogni utente finale viene sommettato e fatturato tramite l'ambiente sottostante in cui l'agente è ospitato. Scopri di più in Panoramica della fatturazione per agenti alimentata dal GitHub Copilot harness.

Scopri di più in Condividi un agente autonomo. Per le istruzioni per gli utenti finali su come configurare un agente condiviso, vai su Configura un agente condiviso.