Compartilhar via

Implantar e publicar agentes

Importante

Você precisa fazer parte do programa de versão preliminar do Frontier para obter acesso antecipado ao Microsoft Agent 365. A Frontier conecta você diretamente às mais recentes inovações de IA da Microsoft. As versões preliminares da Frontier estão sujeitas aos termos de versão preliminar existentes dos contratos de cliente. Como esses recursos ainda estão em desenvolvimento, sua disponibilidade e capacidades podem mudar ao longo do tempo.

Você criou seu agente e o testou localmente — agora é hora de trazê-lo à vida na nuvem. Implantar e publicar seu agente o torna disponível em toda a sua organização, permitindo que equipes descubram, criem instâncias de agentes e interajam com ele via Microsoft 365.

Este guia guia como implantar seu código de agente no Azure e publicá-lo no Microsoft Admin Center, onde ele se torna um ativo descobrível para sua organização.

Visão geral

O processo de implantação e publicação envolve dois passos principais:

  1. Implantar - Implante seu agente no Azure Web App (opcional, pule se seu agente já estiver rodando e acessível)
  2. Publicar - Publica seu agente na loja de agentes no centro de administração do Microsoft 365

Após a publicação, complete o onboarding criando uma instância de agente pelo Microsoft Teams.

Importante

O create-instance comando é temporariamente removido. Ele contornava as etapas obrigatórias de registro, o que limitaria a funcionalidade do agente. Esse comando pode ser reintroduzido em uma versão posterior, assim que estiver em conformidade com o fluxo de trabalho recomendado. Use o publish comando seguido de criar uma instância de agente pelo Microsoft Teams.

Pré-requisitos

Para começar, você deve ter os seguintes itens:

Permissões e acesso necessários

  • Uma conta de usuário do Microsoft Entra com uma das seguintes funções:
    • Administrador Global
    • Administrador de ID de Agente
    • Desenvolvedor de ID de Agente
  • Um usuário com acesso de Colaborador na assinatura do Azure

Ferramentas necessárias

Etapas necessárias de configuração

Antes de implantar e publicar, certifique-se de completar estas etapas em ordem:

  1. Blueprint de agente criado - Complete as etapas de configuração em Registrar agentes para criar seu blueprint de agente
  2. Agente testado localmente - Verifique se seu agente funciona corretamente com o Agents Playground (veja Testar agentes localmente)
  3. Arquivos de configuração prontos - Garantir a365.config.json e a365.generated.config.json estar atualizado

Passo 1: Implantar no Azure

O a365 deploy comando implanta seu agente no Azure Web App criado durante a configuração. Isso faz o upload do código do seu agente para o Azure, tornando-o disponível para rodar na nuvem e lidar com solicitações do Microsoft 365.

Implantar agentes

Este é o comando de implantação:

a365 deploy

O comando deploy para agentes .NET:

  • Detecta arquivos de projeto .NET (*.csproj, *.fsproj, ou *.vbproj)
  • Restaura pacotes NuGet usando dotnet restore
  • Publica aplicação usando dotnet publish com configuração de Release
  • Cria manifesto Oryx com comando DLL de entrada (por exemplo, dotnet YourApp.dll)
  • Configura o tempo de execução do Azure com base na versão .NET detectada (padrão: DOTNET|8.0)
  • Implanta via zip com progresso em tempo real

Aviso

Gerenciamento de segredos: Quando você implanta, variáveis do ambiente (incluindo chaves de API e segredos) são armazenadas como Configurações de Apps do Azure. Embora variáveis de ambiente sejam comumente usadas para configuração, elas são armazenadas em texto simples. Para ambientes de produção, a Microsoft recomenda o uso do Azure Key Vault para segredos sensíveis. Para obter mais informações, confira Armazenamento seguro de segredos do aplicativo em desenvolvimento no ASP.NET Core. Trate esses arquivos como informações confidenciais e nunca os registre no controle do código-fonte.

Verificar implantação

Após a conclusão da implantação:

  1. Navegue até o seu aplicativo Web no portal do Azure.
  2. No aplicativo, vá até Configurações>Configurações Avançadas.
  3. Verifique os registros de implantação no Centro de Implantação

Passo 2: Publique no Centro de Administração da Microsoft

O a365 publish comando publica seu agente na loja de agentes no centro de administração do Microsoft 365, tornando-o detectável e instalável. Essa etapa final torna seu agente disponível para organizações criarem instâncias de agente e usarem dentro do ambiente Microsoft 365.

4. Publicar Agente

Execute o comando publicar:

a365 publish

Publicar comando.

  • Extrai templates de manifestos de recursos incorporados (caso manifest a pasta não exista)
  • Atualizações manifest.json com ID do blueprint do agente
  • Pausas para você personalizar os campos do manifesto (versão, nomes, descrições, informações do desenvolvedor, ícones)
  • Pacote de pacotes (manifest.zip)
  • Envia para a loja do agente no centro de administração do Microsoft 365
  • Cria identidade federada para integração com o Teams
  • Atribui permissões necessárias para o Grafo

Personalizar manifesto

A CLI pausa durante a publicação para permitir que você personalize seu manifesto de agente:

=== CUSTOMIZE YOUR AGENT MANIFEST ===

Your manifest has been updated at: [path]\manifest\manifest.json

When you're done customizing, type 'continue' (or 'c') and press Enter to proceed:

Passos manuais:

  1. Abra manifest.json em um editor de texto.

  2. Personalize os campos exigidos:

    • Atualize o número da versão. Incremente a partir do anterior se for reenviado.
    • Defina um nome significativo do agente. Os nomes devem ter igual ou menos que 30 caracteres.
    • Escrever descrições de PR
    • Informações do desenvolvedor
    • Opcionalmente, substituir arquivos de ícones

  3. Atualizar o arquivo de manifesto

  4. Volte para o CLI e digite continue ou c e pressione Enter.

A CLI completa o processo de publicação e seu agente agora está disponível no Microsoft 365 Admin Center. No entanto, antes de poder testar seu agente ou permitir que usuários criem instâncias, é necessário configurar o blueprint do agente no Portal do Desenvolvedor.

Passo 3: Configurar o blueprint do agente no Portal do Desenvolvedor

Após a publicação, você deve configurar o blueprint do agente no Portal de Desenvolvedores do Teams para conectar seu agente à infraestrutura de mensagens do Microsoft 365. Sem essa configuração, seu agente não receberá mensagens do Teams, e-mail ou outros serviços do Microsoft 365.

Obtenha seu ID de planta

Execute o seguinte comando para exibir sua configuração:

a365 config display -g

Copie o agentBlueprintId valor da saída.

Abra seu navegador e navegue até a página de configuração:

https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration

Substitua <your-blueprint-id> pelo agentBlueprintId valor que você copiou.

Observação

Se você não tiver acesso ao Portal do Desenvolvedor, entre em contato com o administrador do seu inquilino para conceder acesso ou completar essa configuração em seu nome.

Configurar o agente

No Portal do Desenvolvedor:

  1. Defina o tipo de agente para baseado em bots
  2. Defina o ID do Bot para seu agentBlueprintId valor
  3. Selecione Salvar

Captura de tela mostrando a página de configuração do Portal do Desenvolvedor com o Tipo de Agente configurado como Baseado em Bot e o campo ID do Bot preenchido.

Essa configuração é necessária antes de você poder criar instâncias de agente no Teams.

Para mais informações sobre Blueprints de Identidade de Agente e configuração do Portal de Desenvolvedores, veja Configurar o Blueprint de Identidade de Agente.

Passo 4: Teste seu agente implantado

Depois de implantar e publicar seu agente, você pode testá-lo no Microsoft 365 para garantir que ele funciona corretamente em produção. Uma vez implantado, seu agente se integra aos serviços do Microsoft 365, incluindo Teams (chats, canais, reuniões), e-mail e calendário (envio/recepção, agendamento), SharePoint e OneDrive (acesso a documentos, compartilhamento de arquivos) e ferramentas de colaboração (presença organizacional, tarefas do Planner, comentários de documentos).

Importante

Usuários agentes precisam de licenças apropriadas do Microsoft 365 para acessar esses serviços. Licenças comuns incluem Microsoft 365 E5, Teams Enterprise e Microsoft 365 Copilot.

Visualizar agente implantado no Centro de Administração

Após a publicação, seu agente aparece no Microsoft Admin Center para contratação. Pode levar algum tempo para se propagar.

Navegue até o Centro de administração do Microsoft 365.

  • Veja seu agente publicado
  • Gerenciar configurações do aplicativo
  • Uso de agentes de monitoramento
  • Configurar permissões

Agente de testes no Teams

Após implantar, publicar, configurar seu blueprint de agente e criar um usuário agente, você pode testar o usuário agente diretamente no Microsoft Teams:

Observação

Requisito da licença: Certifique-se de ter a licença "Microsoft Agent 365 Frontier" atribuída à sua conta. Essa licença é necessária para criar instâncias de agentes e interagir com agentes no Microsoft Teams. Entre em contato com o administrador do seu inquilino se você não tiver essa licença.

Importante

Antes de testar, certifique-se de ter concluído o Passo 3: Configurar o blueprint do agente no Portal do Desenvolvedor. Seu agente não receberá mensagens até que essa configuração esteja concluída.

  1. Crie uma instância de agente no Teams

    • Abra o Microsoft Teams usando sua conta
    • Navegue até a loja do Teams e pesquise pelo seu agente publicado
    • Crie uma nova instância de agente a partir do seu blueprint de agente

  2. Comece a testar

    • Comece um novo chat com sua instância de agente recém-criada
    • Envie mensagens de teste para verificar a funcionalidade do agente

  3. Exemplo de mensagem de teste

    Envie esta mensagem para testar a funcionalidade do e-mail (atualize o e-mail do destinatário conforme necessário):

    Send an email to recipient@contoso.com with subject "Hello from Teams" and message "This is a test message from my agent!"

    O agente deve processar a solicitação e enviar o e-mail sem exigir mais confirmação.

Próximas etapas

Parabéns! Seu agente agora está ao vivo na nuvem e pronto para trabalhar ao lado das equipes no Microsoft 365. O que começou como código local agora é um assistente pronto para empresas e descoberto, onde os usuários podem criar instâncias de agentes em toda a sua organização.

Enquanto seu corretor lida com solicitações do mundo real, considere os próximos passos:

  • Monitore o desempenho: Use recursos de observabilidade para acompanhar o comportamento dos agentes e otimizar respostas
  • Adicione mais ferramentas: Explore o catálogo de ferramentas para expandir as capacidades do seu agente
  • Itere e melhore: Atualize o código do seu agente, reimplante e republique (lembre-se de incrementar o número da versão!)
  • Escale em toda a sua organização: Compartilhe histórias de sucesso do seu agente para impulsionar a adoção

A jornada do seu agente do desenvolvimento à implantação está completa — mas seu impacto está apenas começando.

Conteúdo relacionado

  • Last updated on