Compartilhar via


Implantar seu agente no Azure manualmente

Executar um agente do SDK de Agentes do Microsoft 365 no Azure requer as seguintes etapas:

Este documento aborda a implantação de um agente que você criou no Azure e Teams ou Microsoft 365 Copilot.

Se você ainda não criou um agente, comece pelo Início rápido: crie e teste um agente básico usando C#.

Publicar o agente em um aplicativo da Web

Um agente do SDK é um aplicativo Web. Para publicar seu agente, você pode usar os métodos que normalmente usaria para implantar um aplicativo Web no Azure:

  • Implantar como um pacote ZIP em um aplicativo de Serviço de Aplicativo do Azure
  • O Visual Studio publica em um aplicativo ou contêiner de Serviço de Aplicativo do Azure
  • Outras implantações de contêineres com suporte pelo Azure
  • Implantação do Kit de Ferramentas para Agentes do Microsoft 365

Importante

Se você está usando um aplicativo de Serviço de Aplicativo do Azure e quer Credenciais Federadas ou Identidade Gerenciada pelo Usuário, precisa adicionar essa identidade em Configurações e depois em Identidade.

Uma vez que seu código de agente é implantado, ele tem uma URL base, como example.azurewebsites.net.

No Azure, vá para o recurso Bot do Azure. Em Configuração, altere o Ponto de extremidade de mensagens para https://{yourwebsite}/api/messages. Substitua {yourwebsite} pela URL base do seu aplicativo Web.

Testar no Webchat

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

Prepare seu manifesto do Teams e do Microsoft 365 Copilot

Para Microsoft Teams e Microsoft 365 Copilot, você precisa 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. Os recursos do Teams exigem conteúdo específico do manifesto.

Essas etapas fornecem uma visão geral de um agente básico do Teams de estilo "chat".

  1. Crie uma pasta vazia em seu projeto.
  2. Cópia do conteúdo dos Arquivos de manifesto do Teams na pasta.
  3. Na pasta, abra manifest.json e faça as seguintes edições:
    • Em Todos os Lugares você vê a cadeia de caracteres de espaço reservado <<AAD_APP_CLIENT_ID>>, substitua-a por ClientId para seu recurso de Bot do Azure.
    • Substitua <<BOT_DOMAIN>> pela URL base do seu agente.
    • Feche o conteúdo da pasta para criar um manifest.zip com o conteúdo:
      • manifest.json
      • outline.png
      • color.png

Implantar no Microsoft 365

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

  2. Navegue até o Portal de Administração do Microsoft (MAC). Em Configurações e Aplicativos Integrados, selecione Carregar Aplicativo Personalizado.

  3. Selecione o manifest.zip criado na seção anterior e carregue o arquivo.

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