Condividi tramite

Distribuire manualmente l'agente in Azure

L'esecuzione di SDK per agenti Microsoft 365 in Azure richiede la procedura seguente:

Questo documento illustra la distribuzione di un agente creato in Azure e Teams o Microsoft 365 Copilot.

Se non è ancora stato creato un agente, inizia con Avvio rapido: creare e testare un agente di base usando C#.

Pubblicare l'agente in Azure come applicazione web

  1. Distribuire il codice dell'agente in Azure. Un agente agents SDK è un'applicazione Web. Per pubblicare l'agente, puoi usare i metodi normalmente usati per distribuire un'applicazione Web in Azure:

    • Distribuire un pacchetto ZIP in un'app App Service di Azure
    • Pubblicazione di Visual Studio in un'app di Azure App Service o in un contenitore
    • Altre distribuzioni di contenitori supportate da Azure
    • Distribuzione del Toolkit degli agenti di Microsoft 365

    Importante

    Se stai usando un'app di Azure App Service e le credenziali federate o l'identità gestita assegnata dall'utente, è necessario aggiungere tale identità in Impostazioni>Identità.

    Dopo aver distribuito il codice dell'agente, ha un URL di base, ad esempio example.azurewebsites.net.

  2. In Azure vai alla risorsa di Azure Bot. In Configurazione, modifica l'endpoint di messaggistica in https://{yourwebsite}/api/messages. Sostituisci {yourwebsite} con l'URL di base dell'app Web.

Test nella chat Web

Per visualizzare il messaggio nella chat Web, seleziona Test in chat Web nella risorsa del bot di Azure e invia messaggi all'agente.

Preparare il manifesto di Teams e Microsoft 365 Copilot

Per Microsoft Teams e Microsoft 365 Copilot, devi creare e caricare un manifesto. Non è possibile fornire un esempio di manifesto che copre tutte le esigenze di Teams o Microsoft 365 Copilot. Le funzionalità di Teams richiedono contenuti del manifesto specifici.

Questi passaggi offrono una panoramica di un agente di Teams di base in stile "chat".

  1. Crea una cartella vuota nel progetto.
  2. Copia dei contenuti dei file manifesto di Teams nella cartella.
  3. Nella cartella, apri manifest.json e apporta le modifiche seguenti:
    • Ovunque vedi la stringa segnaposto <<AAD_APP_CLIENT_ID>>, sostituiscila con ClientId per la tua risorsa di Azure Bot.
    • Sostituisci <<BOT_DOMAIN>> con l'URL di base dell'agente.
    • Comprimi il contenuto della cartella per creare un manifest.zip che includa tali file:
      • manifest.json
      • outline.png
      • color.png

Distribuire in Microsoft 365

  1. Assicurarsi che la risorsa di Azure Bot abbia il canale di Microsoft Teams aggiunto in Canali.

  2. Vai al portale di amministrazione di Microsoft (MAC).

  3. In Impostazioni e App integrate, seleziona Aggiorna app personalizzata.

  4. Seleziona il file manifest.zip creato nella sezione precedente e caricalo.

Dopo un breve periodo di tempo, l'agente viene visualizzato in Microsoft Teams e Microsoft 365 Copilot.

  • Last updated on