Partilhar via

Implementar o seu agente no Azure manualmente

Executar um agente SDK de Agentes do Microsoft 365 no Azure requer os seguintes passos:

Este documento aborda a implementação de um agente criado no Azure e no Teams ou no Microsoft 365 Copilot.

Se ainda não criou um agente, comece por Início Rápido: Crie e teste um agente básico usando C#.

Publique o seu agente numa aplicação web

Um agente SDK é uma aplicação Web. Para publicar o seu agente, pode usar os métodos que normalmente usaria para implementar uma aplicação web no Azure:

  • Implementar como um pacote ZIP numa aplicação do Serviço de Aplicações do Azure
  • Publicação do Visual Studio numa aplicação ou contentor do Serviço de Aplicações do Azure
  • Outras implementações de contentor suportadas pelo Azure
  • Implementação do Toolkit de Agentes do Microsoft 365

Importante

Se estiver a utilizar um Serviço de Aplicações do Azure e Credenciais Federadas ou Identidade Gerida pelo Utilizador, tem de adicionar essa identidade em Definições e, em seguida, em Identidade.

Depois de o código do seu agente ser implementado, tem uma URL base, como example.azurewebsites.net.

No Azure, aceda seu recurso do Azure Bot. Em Configuração, altere o Ponto final de mensagens para https://{yourwebsite}/api/messages. Substitua {yourwebsite} pelo URL base da sua aplicação web.

Teste no Webchat

Para ver a sua mensagem no Webchat, selecione Testar no Webchat no seu recurso do Azure Bot e envie mensagens para o seu agente.

Preparar o manifesto do Teams e do Microsoft 365 Copilot

Para o Microsoft Teams e o Microsoft 365 Copilot, tem de criar e carregar um manifesto. Não é possível fornecer um exemplo de manifesto que cubra todas as necessidades do Teams ou do Microsoft 365 Copilot. As funcionalidades do Teams exigem um conteúdo de manifesto específico.

Estes passos fornecem uma descrição geral de um agente básico do Teams no estilo "chat".

  1. Crie uma pasta vazia no seu projeto.
  2. Copie o conteúdo dos Ficheiros de manifesto do Teams para a pasta.
  3. Na pasta, abra manifest.json e faça as seguintes edições:
    • Em todos os locais onde veja a cadeia de carateres do marcador de posição <<AAD_APP_CLIENT_ID>>, substitua-a por ClientId para o seu recurso do Azure Bot.
    • Substitua <<BOT_DOMAIN>> pelo URL da base do seu agente.
    • Compacte o conteúdo da pasta para criar um manifest.zip com o conteúdo:
      • manifest.json
      • outline.png
      • color.png

Implementar no Microsoft 365

  1. O seu recurso do Azure Bot deve ter o canal do Microsoft Teams adicionado em Canais.

  2. Navegue para o Portal de Administração do Microsoft (MAC). Em Definições e Aplicações Integradas, selecione Carregar Aplicação Personalizada.

  3. Selecione o manifest.zip criado na secção anterior e carregue o ficheiro.

Após um curto período de tempo, o agente aparece no Microsoft Teams e no Microsoft 365 Copilot.

  • Last updated on