Condividi gli agenti con altri utenti e creatori (GitHub Copilot)

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.

Puoi condividere i tuoi agenti con altri nella tua organizzazione così che possano vedere, testare e utilizzare i tuoi agenti. Per ciascun agente, puoi condividere con:

  • Singoli utenti usando la propria email o il nome utente
  • Tutti i membri nei gruppi di sicurezza che specifichi
  • L'intera organizzazione

Caution

Questo articolo descrive come condividere gli agenti che crei utilizzando l'esperienza del nuovo agente. Se stai usando l'interfaccia classica degli agenti, vedi Condividere gli agenti con altri maker. Quando utilizzi la nuova esperienza di condivisione, puoi concedere i diritti di visualizzazione solo agli agenti che condividi. Per concedere i diritti di montaggio:

  1. Accesso ad agenti harness standard e flussi di agenti per consentire la modifica durante la condivisione.
  2. Aggiungi gli utenti all'ambiente dell'agente, poi assegna diritti di modifica agli utenti tramite i ruoli di sicurezza dell'ambiente. Scopri di più in Controllo su come gli agenti vengono condivisi e Assegna ruoli di sicurezza agli utenti.

Prerequisites

  • Autenticazione utente per l'agente è configurata su Esegui l'autenticazione con Microsoft.
  • Gli utenti con cui condividi hanno una licenza Microsoft Copilot Studio per ogni utente. Gli utenti che non hanno una licenza possono iscriversi a una prova.
  • Gli agenti che vuoi condividere sono pubblicati su Teams + Microsoft 365, con l'agente Make disponibile in Microsoft Copilot attivato. Se il tuo agente non è pubblicato, ti verrà chiesto di salvarlo e pubblicarlo prima di condividerlo.

Condividere un agente per la visualizzazione e il test

Annotazioni

  • Quando si condivide un agente per la visualizzazione e il test, non è possibile condividerlo con i gruppi Microsoft 365 con SecurityEnabled impostato su false. Per modificare questa impostazione, vedi Condividi un'app con i gruppi Microsoft 365 nella documentazione di Power Apps.

  • Quando un agente condiviso invoca un workflow che utilizza un nodo agente per chiamare un altro agente con la connessione dell'utente, l'utente deve avere accesso all'ambiente del workflow. Condividere l'agente iniziale non concede questo accesso. Senza di esso, l'azione del nodo agente fallisce prima di chiamare il secondo agente.

Importante

La condivisione di agenti di Copilot Studio con connessioni a servizi esterni, ad esempio Azure Databricks Genie, può risultare complessa perché le connessioni sono associate all'identità di ogni singolo utente agente. Questo significa che un agente potrebbe funzionare per te ma non per altri utenti.

Per affrontare questo comportamento, si utilizza uno dei seguenti approcci:

  • Usa un principio di servizio per l'autenticazione, se supportato.
  • Configura le connessioni a livello di ambiente affinché l'agente funzioni usando un'identità condivisa e non specifica per l'utente.
  • Richiedere agli utenti di autenticarsi individualmente quando è richiesta l'autenticazione basata su OAuth.

Per condividere un agente:

  1. Apri l'agente dalla pagina Agenti.
  2. Seleziona l'icona Condividi ( ) vicino a Pubblica nella barra del menu in alto.

    Annotazioni

    Se non hai ancora pubblicato il tuo agente, ti verrà chiesto di farlo prima di continuare.

  3. Nel pannello Condivisione che si apre, inserisci il nome utente, gli indirizzi e-mail dei singoli utenti o dei gruppi di sicurezza con cui vuoi condividere l'agente.
    • Gli utenti e i gruppi compaiono nelle Persone che possono usare il campo agente mentre li selezioni con uno stato In attesa .
  4. Seleziona Condividi per condividere l'agente.

I visualizzatori possono vedere l'agente nel proprio elenco di agenti, aprirlo per consultarne i dettagli e testarlo, ma non possono modificare l'agente o i suoi contenuti.

Per permettere ad altri di modificare l'agente, puoi accedere agli agenti e ai flussi di agente standard per abilitare la modifica durante la condivisione, oppure assegnare ruoli di editor agli utenti nell'ambiente.

Se vuoi solo condividere l'agente affinché altre persone lo usino, senza vedere o testare, sotto Organizzazione, apri il menu a tendina e seleziona Accesso utente finale. Questa azione permette a chiunque nella tua organizzazione di trovare e utilizzare l'agente, ma non può vedere i dettagli dell'agente né modificarli.

Cambia l'impostazione in Nessuna autorizzazione, se non specificata per smettere di condividere l'agente con tutti gli utenti nell'organizzazione. Gli utenti e i membri dei gruppi con cui hai condiviso l'agente continueranno ad avere accesso all'agente.

Condividi un agente autonomo che gli utenti possono eseguire (anteprima)

Puoi condividere un agente pubblicato che ha trigger con gli utenti che devono eseguire l'agente usando le proprie credenziali. Prima di condividere, configura i trigger dell'agente e gli strumenti per l'autenticazione degli utenti. Gli utenti completano le connessioni richieste nella pagina dell'agente condiviso e possono modificare solo le opzioni di trigger consentite.

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.

  1. Apri l'agente dalla pagina Agenti.

  2. Seleziona l'icona Condividi ( ) vicino a Pubblica nella barra del menu in alto.

    Annotazioni

    Se non hai ancora pubblicato il tuo agente, ti verrà chiesto di farlo prima di continuare.

  3. Nel pannello Condividi che appare, seleziona la barra di ricerca. Inserisci il nome utente, gli indirizzi email dei singoli utenti o dei gruppi di sicurezza con cui vuoi condividere l'agente. Assicura che Can use appaia accanto alla barra di ricerca.

  4. Se hai già condiviso l'agente con gli utenti, cambia il loro permesso in Può usare.

    Schermata del menu a tendina dei permessi del pannello Condividi con Può usare selezionato e evidenziato, insieme alle opzioni Può modificare, Può visualizzare le analisi e Rimuovi l'accesso.

  5. Seleziona Copia link di condivisione, poi Copia link per la configurazione.

  6. Invia il link agli utenti finali con cui hai condiviso l'agente autonomo.

I destinatari possono usare il link per attivare l'agente per sé stessi, collegare l'agente con le proprie credenziali e gestire le impostazioni di trigger consentite. Scopri di più in Imposta un agente autonomo condiviso.

Limitations

La condivisione degli agenti autonomi presenta le seguenti limitazioni:

  • Credenziali del flusso di lavoro come strumento: Se il tuo agente chiama un flusso di lavoro come strumento, quel flusso può accettare solo credenziali utente finale per l'autenticazione. I flussi di lavoro che utilizzano credenziali riservate al maker non sono supportati per gli agenti autonomi.

  • Invocazione degli strumenti per gli utenti: Gli utenti di un agente autonomo condiviso non possono specificare o modificare i parametri degli strumenti. Le chiamate agli strumenti vengono invocate ed eseguite completamente con l'IA, in base alle specifiche del produttore.

  • Portale di gestione agente: Gli utenti finali devono aggiungere ai preferiti l'URL di gestione dell'agente per controllare lo stato del loro agente, correggere l'agente, acconsentire agli aggiornamenti apportati dal maker all'agente e altre attività di gestione.

  • Visibilità della condivisione: gli utenti non ricevono notifiche quando un creatore condivide un agente con loro. I produttori devono copiare e inviare il link per l’utilizzo agli utenti finali.

Smetti di condividere un agente

Puoi interrompere la condivisione di un agente con singoli utenti, un gruppo di sicurezza o con chiunque nell'organizzazione.

Per interrompere la condivisione di un agente:

  1. Apri l'agente dalla pagina Agenti.

  2. Seleziona l'icona Condividi ( ) vicino a Pubblica nella barra del menu in alto.

  3. Nel pannello Condivisione , sotto Persone che possono usare l'agente, seleziona l'icona di cancella ("X") accanto a ogni gruppo o utente. Puoi annullare la cancellazione se necessario.

  4. Per smettere di condividere con tutti nella tua organizzazione, sotto Tutti nell'organizzazione seleziona Nessun permesso, salvo specifico. Gli utenti e i membri dei gruppi con cui hai condiviso individualmente l'agente hanno comunque accesso all'agente.

  5. Seleziona Condividi per smettere di condividere con la tua organizzazione o con gli utenti o gruppi rimossi.

Passaggi successivi dopo aver condiviso un agente

Oltre a condividere il tuo agente, puoi anche:

  • Ultimo aggiornamento: