Partilhar via

Implementar e publicar agentes

Importante

É necessário fazer parte do programa de pré-visualização Frontier para obter acesso antecipado ao Microsoft Agent 365. A Frontier liga-o diretamente às mais recentes inovações de IA da Microsoft. As pré-visualizações da Frontier estão sujeitas aos termos de pré-visualização existentes dos seus contratos com clientes. Como estas funcionalidades ainda estão em desenvolvimento, a sua disponibilidade e capacidades podem mudar ao longo do tempo.

Construiu o seu agente e testou-o localmente—agora é altura de o dar vida na cloud. Implementar e publicar o seu agente torna-o disponível em toda a sua organização, permitindo que as equipas o descubram, contratem e interajam com ele através do Microsoft 365.

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

Descrição geral

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

  1. Deploy - Deploye o seu agente para Azure Web App
  2. Publicar - Publica o seu agente na loja de agentes no centro de administração do Microsoft 365

Depois de completar estes passos, o seu agente estará disponível no Microsoft Admin Center, onde poderá ser descoberto e contratado pelas organizações.

Pré-requisitos

Antes de começar, confirme que tem o seguinte:

Permissões necessárias e acesso

  • Inquilino Microsoft Entra com uma das seguintes funções:
    • Administrador Global
    • Administrador de ID de Agente
    • Agent ID Developer
  • Azure subscription with contributor access

Ferramentas necessárias

Passos de configuração necessários

Antes de implementar e publicar, certifique-se de que completa estes passos por ordem:

  1. Identidade do agente criada - Complete todos os passos em Registar agentes para criar o seu blueprint e instância do agente
  2. Agente testado localmente - Verifique se o seu agente funciona corretamente com o Agents Playground (ver Agentes de teste localmente)
  3. Ficheiros de configuração prontos - Garantir a365.config.json e a365.generated.config.json estar atualizados

Passo 1: Implementar para Azure

O a365 deploy comando coloca o seu agente na aplicação Web do Azure criada durante a configuração. Isto carrega o código do seu agente para o Azure, tornando-o disponível para correr na cloud e tratar pedidos do Microsoft 365.

Agente de implementação

Execute o comando de deployment:

a365 deploy

O comando deploy para agentes .NET:

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

Aviso

Gestão de segredos: Quando implementa, as variáveis do ambiente (incluindo chaves API e segredos) são armazenadas como Definições de Aplicações Azure. Embora as variáveis de ambiente sejam comumente usadas para configuração, são armazenadas em texto simples. Para ambientes de produção, a Microsoft recomenda usar o Azure Key Vault para segredos sensíveis. Para mais informações, consulte Armazenamento seguro de segredos de aplicação em desenvolvimento no ASP.NET Core e fornecedor de configuração Azure Key Vault. Nunca comprometa .env ficheiros com informação sensível no controlo de versão.

Verificar a Implementação:

Após a conclusão do destacamento:

  1. Navegue até ao Serviço de Aplicações no portal do Azure
  2. Na aplicação Web, aceda a Definições>Definições Avançadas.
  3. Verifique os registos de implementação no Centro de Implementação

Passo 2: Publicar no Microsoft Admin Center

O a365 publish comando publica o seu agente para a loja de agentes no centro de administração do Microsoft 365, tornando-o detetável e instalável. Este passo final torna o seu agente disponível para as organizações contratarem e utilizarem no seu ambiente Microsoft 365.

Agente de publicação

Execute o comando publicar:

a365 publish

Comando Publicar.

  • Extrai modelos de manifestos de recursos incorporados (se manifest a pasta não existir)
  • Atualizações manifest.json com o ID do blueprint do agente
  • Pausas para personalizares os campos do manifesto (versão, nomes, descrições, informações do programador, ícones)
  • Pacote de aplicações de pacotes (manifest.zip)
  • Carrega para a loja de agentes no centro de administração do Microsoft 365
  • Cria identidade federada para integração com o Teams
  • Atribui permissões de grafo necessárias

Personalizar manifesto

A CLI pausa durante a publicação para permitir que personalize o 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. Abrir manifest.json no seu editor de texto
  2. Personalize os campos obrigatórios:
    • Atualizar o número da versão. Incremente em relação ao anterior se voltar a carregar.
    • Defina um nome significativo do agente. Os nomes devem ser iguais ou inferiores a 30 caracteres.
    • Escreva descrições claras
    • Informações do programador
    • Opcionalmente, substituir ficheiros de ícones
  3. Guardar o ficheiro do manifesto
  4. Volte ao CLI e escreva continue ou c e pressione Enter.

Testar o seu agente implementado

Depois de implementares e publicares o teu agente, podes testá-lo no Microsoft 365 para garantir que funciona corretamente em produção. Uma vez implementado, o seu agente integra-se com os serviços do Microsoft 365, incluindo o Teams (chats, canais, reuniões), email e calendário (envio/receção, agendamento), SharePoint e OneDrive (acesso a documentos, partilha de ficheiros) e ferramentas de colaboração (presença organizacional, tarefas do Planner, comentários de documentos).

Importante

Os utilizadores agentes necessitam de licenças Microsoft 365 adequadas para aceder a estes serviços. Licenças comuns incluem Microsoft 365 E5, Teams Enterprise e Microsoft 365 Copilot.

Ver agente destacado no Centro de Administração

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

Navegue até ao Centro de Administração do Microsoft 365 - Agentes para:

  • Consulte o seu agente publicado
  • Definições de gestão
  • Utilização de agentes de monitorização
  • Configurar permissões

Agente de testes no Teams

Depois de implementar e publicar o seu agente, pode testá-lo diretamente no Microsoft Teams:

  1. Portal Aberto para Desenvolvedores

  2. Configurar blueprint do agente

    • Definir o tipo de agente para baseado em bots
    • Define o ID do bot a partir da tua a365 config display -g saída (usa o agentBlueprintId valor)
    • Guarde a configuração:

  3. Começar a utilizar o no Teams

    • Abra o Microsoft Teams usando a sua conta
    • Inicie uma nova conversa com o seu novo utilizador agente criado
    • Enviar mensagens de teste para verificar a funcionalidade do agente

  4. Exemplo de mensagem de teste

    Envie esta mensagem para testar a funcionalidade do email (atualize o email 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 o pedido e enviar o email sem exigir mais confirmação.

Próximos passos

Parabéns! O seu agente está agora disponível na cloud e pronto para trabalhar em conjunto com as suas equipas no Microsoft 365. O que começou como código local é agora um assistente identificável e pronto para empresas que pode ser contratado em toda a sua organização.

À medida que o seu agente trata de pedidos do mundo real, considere os seguintes passos:

  • Monitorizar o desempenho: Utilizar funcionalidades de observabilidade para acompanhar o comportamento dos agentes e otimizar as respostas
  • Adicione mais ferramentas: Explore o catálogo de ferramentas para expandir as capacidades do seu agente
  • Iterar e melhorar: Atualize o código do seu agente, reimplemente e republique (lembre-se de incrementar o número de versão!)
  • Escale em toda a sua organização: Partilhe as histórias de sucesso do seu agente para impulsionar a adoção

A jornada do seu agente desde o desenvolvimento até à implementação está concluída — mas o seu impacto está apenas a começar.

Conteúdos relacionados

  • Last updated on