Pubblicare agenti in Microsoft 365 Copilot e Microsoft Teams

Dopo aver sviluppato e testato un agente, il passo successivo è spesso quello di condividerlo con gli altri utenti nelle piattaforme in cui già operano. La pubblicazione di un agente Foundry in Microsoft 365 Copilot e Teams consente di interagire e individuare l'agente tramite l'interfaccia utente di Microsoft 365 Copilot e Teams. Ciò che viene pubblicato è l'endpoint stabile dell'agente, quindi gli utenti finali interagiscono sempre con un'entità agente coerente, mentre si esegue facilmente l'implementazione di nuove versioni dell'agente che ricevono traffico attraverso l'endpoint. Si pubblica in M365/Teams dal portale Foundry.

Importante

Gli agenti di pubblicazione per Microsoft 365 Copilot e Microsoft Teams si trovano nella fase di "Early Access Preview" e sono concessi in licenza all'utente come parte dell'abbonamento Azure e soggetti ai termini applicabili alle "Anteprime" e "Anteprime di accesso anticipato" nei Supplemental Terms of Use for Microsoft Azure Previews e nel Microsoft Products and Services Data Protection Addendum ("DPA").

L'uso di Visione personalizzata di Azure AI per ospitare agenti che operano con server o agenti di terze parti è a proprio rischio. È consigliabile esaminare tutti i dati condivisi con server o agenti di terze parti e riconoscere le procedure di terze parti per la conservazione e la posizione dei dati.

Strumenti o servizi esterni (inclusi strumenti e servizi Microsoft esterni a Azure AI Foundry) con cui Visione personalizzata di Azure AI interagiscono sono soggetti ai propri termini di trattamento dei dati. Anche gli agenti pubblicati in Copilot o Teams sono soggetti a termini supplementari.

È responsabilità dell'utente gestire se i dati verranno trasmessi al di fuori dei limiti di conformità e geografici Azure dell'organizzazione e di eventuali implicazioni correlate.

Nota

Se si esegue la migrazione da un modello di pubblicazione precedente, vedere Eseguire la migrazione da Applicazioni agente al nuovo modello di agente.

Prerequisiti

  • Accesso al portale di Microsoft Foundry

  • Un progetto Foundry con una versione dell'agente che hai testato e vuoi pubblicare

  • Le assegnazioni di ruolo seguenti:

  • Una sottoscrizione Azure in cui è possibile creare Azure servizio Bot risorse

  • Testa attentamente l'agente nel portale Foundry prima di pubblicarlo. Verificare che risponda correttamente ed eventuali strumenti funzionino come previsto.

  • Seleziona la versione dell'agente attivo con cui vuoi che i consumatori interagiscano in Microsoft 365 e Teams.

  • Verificare che i provider di risorse Azure necessari siano registrati nella sottoscrizione. Il processo di pubblicazione crea una risorsa Azure servizio Bot, che richiede il provider Microsoft.BotService.

    Se si usa interfaccia della riga di comando di Azure, è possibile registrare il provider con:

    az provider register --namespace Microsoft.BotService

Selezionare una versione dell'agente attivo nell'interfaccia utente di Foundry

Per altre informazioni sulla selezione di una versione dell'agente attivo e sulla configurazione di altre impostazioni dell'agente, vedere Pubblicare e condividere agenti.

  1. Nel portale di Microsoft Foundry selezionare Publish.

    Risultato specificato: viene aperto un elenco a discesa di pubblicazione che mostra gli URL degli endpoint, la versione attiva e un collegamento per la pubblicazione in Teams e Microsoft 365 Copilot. Menu a tendina della pubblicazione espanso che mostra le opzioni

  2. Selezionare l'icona a forma di freccia a destra di Versione attiva.

    Risultato previsto: viene aperto un popup con opzioni per usare sempre la versione più recente o selezionare una versione specifica. Screenshot del popup della versione attiva che mostra l'uso sempre delle opzioni di versione più recenti e specifiche.

  3. Seleziona la versione attiva da cui desideri ricevere il traffico dall'endpoint stabile del tuo agente.

    Risultato previsto: l'elenco a discesa pubblica si chiude e il pulsante Pubblica visualizza un segno di spunta per indicare l'esito positivo. ::image type="content" source="../media/success-select-version.png" alt-text="Screenshot del pulsante Pubblica con un segno di spunta che indica che la versione è stata scelta con successo."::

Pubblicare in Microsoft 365 e Teams

  1. Nel portale di Microsoft Foundry selezionare Publish e quindi selezionare Pubblica in Teams e Microsoft 365 Copilot.

    Risultato specificato: viene visualizzata la finestra di dialogo Publish in Teams e Microsoft 365.

  2. Una risorsa Azure servizio Bot viene creata automaticamente o visualizzata come di sola lettura se ne esiste già una.

  3. Completare i metadati necessari:

    Campo Descrizione
    Nome Nome visualizzato per l'agente (visualizzato nel store degli agenti)
    Versione di pubblicazione Numero di versione in tre parti (major.minor.patch)
    Breve descrizione Descrizione di una frase delle operazioni dell'agente
    Descrizione Descrizione più lunga delle responsabilità dell'agente e delle azioni che può eseguire
    Sviluppatore Nome o nome dell'organizzazione (in Autore)

    Per aggiungere metadati facoltativi, espandere Altro e completare i campi seguenti:

    Campo Descrizione
    Sito Web per sviluppatori URL del sito Web (HTTPS obbligatorio)
    Condizioni per l'utilizzo URL delle condizioni per l'utilizzo (HTTPS obbligatorio)
    Informativa sulla privacy URL dell'informativa sulla privacy (HTTPS obbligatorio)

    Avviso

    Non includere segreti, chiavi API o informazioni riservate in alcun campo di metadati. Questi campi sono visibili agli utenti.

  4. Selezionare Avanti: Opzioni di pubblicazione.

  5. Scegliere come pubblicare. È possibile pubblicare l'agente direttamente da Foundry o scaricare e personalizzare il manifesto dell'agente, quindi trasferire manualmente il manifesto in Teams.

Pubblicazione diretta

  1. Nel passaggio Opzioni di pubblicazione selezionare la scheda Pubblicazione diretta .

    Risultato previsto: viene visualizzata la sezione Scegliere chi può usare questo agente .

  2. In Scegli chi può usare questo agente selezionare un ambito:

    Opzione Comportamento Approvazione dell'amministratore Migliore per
    Solo tu Disponibile immediatamente. L'agente viene visualizzato in I tuoi agenti nell'archivio agenti. Condividilo con altri inviando il link dell'agente. Non obbligatorio Test personali, piccoli team, piloti
    Utenti dell'organizzazione L'agente viene inviato per l'approvazione dell'amministratore. L'amministratore Microsoft 365 esamina la richiesta e assegna l'accesso. Dopo l'approvazione, l'agente viene visualizzato in Creato dalla tua organizzazione per tutti gli utenti tenant. Obbligatorio Distribuzione a livello di organizzazione, distribuzioni di produzione

    Solo tu:

    • Disponibile immediatamente dopo la pubblicazione: non è necessaria l'approvazione dell'amministratore.
    • Inizialmente, solo tu vedi l'agente sotto I tuoi agenti nell'archivio agenti.
    • Condividere con utenti specifici inviando il collegamento dell'agente.

    Persone dell'organizzazione:

    • Dopo la pubblicazione, un amministratore Microsoft 365 deve esaminare e approvare la richiesta nel interfaccia di amministrazione di Microsoft 365.

    • Dopo l'approvazione, l'agente viene visualizzato in Creato dalla tua organizzazione nell'archivio agenti per tutti gli utenti del tenant.

    • Le politiche delle app nel tenant controllano quali utenti possono accedere all'agente.

    • Per controllare lo stato di approvazione, passare al interfaccia di amministrazione di Microsoft 365 e cercare l'agente in Requests.

      Uno screenshot del negozio Agent in Microsoft 365 Copilot.

  3. Selezionare Pubblica.

    Risultato previsto: Una finestra di dialogo Pubblicazione riuscita conferma che l'agente è stato pubblicato correttamente.

Scaricare e personalizzare

Se si vuole personalizzare il manifesto dell'agente prima della distribuzione:

  1. Nel passaggio Opzioni di pubblicazione selezionare la scheda Scarica e personalizza .

    Risultato previsto: la scheda visualizza le istruzioni per dopo il download e un pulsante Scarica ZIP .

  2. Selezionare Scarica ZIP.

    Risultato previsto: Un .zip file contenente il manifesto dell'agente viene scaricato nel computer locale.

  3. Personalizzare il manifesto nel pacchetto scaricato in base alle esigenze.

  4. In Microsoft Teams caricare il pacchetto scaricato

    1. Vai a App>Gestire le tue app>Carica un'app
    2. Selezionare Carica un'app personalizzata o Invia un'app all'organizzazione e scegliere il file scaricato .zip .

Aggiornare un agente pubblicato in M365/Teams

Aggiorna la versione dell'agente attivo

Per implementare una nuova versione dell'agente, aggiornare il selettore di versione dell'agente nel portale di Foundry. L'URL dell'endpoint stabile rimane invariato: non è necessario ripubblicare in M365/Teams.

Aggiornare i metadati dell'utente finale in M365/Teams

Per aggiornare i metadati visibili in Teams e M365 (nome visualizzato, descrizioni, URL), nell'elenco a discesa Publish selezionare Aggiornare le proprietà di visualizzazione dell'agente Teams e di Microsoft 365 Copilot. I campi aggiornati sovrascrivono i valori esistenti; i campi non modificati vengono portati avanti; e la versione incrementerà automaticamente se non viene incrementata manualmente.

Limitazioni

Limitazione Descrizione
Caricamenti di file e generazione di immagini in Microsoft 365 Questi non funzionano per gli agenti pubblicati in Microsoft 365. Lavorano in Microsoft Teams.
Collegamento Privato Non supportato per Le integrazioni di Teams o Azure servizio Bot.
Streaming e citazioni Gli agenti pubblicati non supportano risposte o citazioni in streaming.

Risoluzione dei problemi

Problema Causa Risoluzione
Errore durante la pubblicazione dell'agente Metadati o versione non validi Verificare che l'agente abbia un'identità univoca (agent.identity non è Null). Verificare che il nome dello sviluppatore sia di 32 caratteri o meno.
La creazione del servizio Azure Bot fallisce Autorizzazioni mancanti o provider non registrato Verificare di avere l'autorizzazione per creare risorse. Registrare Microsoft.BotService, se necessario.
Il campo servizi bot di Azure mostra un errore per 403 AuthorizationFailed per Microsoft.BotService/botServices/write L'identità tua non dispone dell'autorizzazione per creare o aggiornare la risorsa di Azure servizio Bot nel gruppo di risorse di destinazione. Attribuire il ruolo di Collaboratore Azure servizio Bot al gruppo di risorse che contiene il servizio bot, quindi aggiornare le credenziali e riaprire il flusso di pubblicazione.
L'agente dell'ambito dell'organizzazione non viene visualizzato Approvazione dell'amministratore in sospeso Confermare un amministratore approvato nell'interfaccia di amministrazione di M365. Controllare i criteri delle app.
Agent funziona in Foundry ma non riesce dopo la pubblicazione Identità agente mancante di autorizzazioni Assegnare ruoli di controllo degli accessi in base al ruolo (RBAC) all'identità dell'agente per qualsiasi risorsa di Azure a cui accede.
La pubblicazione fallisce a causa di un errore di identità L'agente non ha un'identità univoca (agent.identity è null) Vedere la guida alla migrazione per la procedura per risolvere questo problema.
Gli utenti non riescono a trovare l'agente Ambito errato o approvazione in sospeso Per Ambito singolo, condividere il collegamento diretto. Per l'ambito dell'organizzazione, confermate l'approvazione dell'amministratore.

Faq

Se si seleziona Ambito organizzazione, dove si approva l'agente?

Nel interfaccia di amministrazione di Microsoft 365. Dopo l'approvazione, l'agente viene visualizzato in Sviluppato dalla tua organizzazione nell'archivio agenti.

Se si pubblica l'agente in Ambito singolo (precedentemente denominato Ambito condiviso), come si condivide con altri utenti dell'organizzazione?

L'agente viene visualizzato sotto I tuoi agenti nell'archivio agenti per Microsoft 365 Copilot. È possibile condividerlo inviando il collegamento dell'agente agli utenti selezionati nell'organizzazione.

Schermata di come condividere un agente pubblicato con ambito individuale con altri nella tua organizzazione.

Cosa accade quando si crea una nuova versione dell'agente se l'agente viene pubblicato in M365?

Se il selettore di versione è impostato su "Usa sempre più recente" (impostazione predefinita), la nuova versione viene servita automaticamente in M365/Teams. Se aggiunto a una versione specifica, è necessario aggiornare il selettore di versione per gestire la nuova versione.

Contenuto correlato

  • Last updated on