Ciclo de vida do desenvolvimento do Agente 365

Importante

Você precisa fazer parte do programa de prévia Frontier para obter acesso antecipado ao Microsoft Agent 365. A Frontier conecta você diretamente às mais recentes inovações de IA da Microsoft. Prévias da Frontier estão sujeitas aos termos de pré-visualização existentes dos seus contratos com clientes. Como esses recursos ainda estão em desenvolvimento, sua disponibilidade e capacidades podem mudar ao longo do tempo.

Durante o ciclo de vida do desenvolvimento, você constrói dois artefatos. Um agente Agente 365 exige que estes artefatos existam:

• Identidade do Agente – Use a CLI do Agente 365 para configurar o blueprint do agente. Depois de configurar o blueprint, você pode criar instâncias de agentes e usuários de agentes no centro de administração do Microsoft 365 e no Teams. Saiba mais sobre a identidade do agente.
• Código do agente – Use o SDK do Agente 365 para estender seu código de agente com observabilidade, ferramentas e notificações. O repositório de Amostras do Agente 365 de código aberto fornece amostras que ajudam você a iniciar rapidamente o desenvolvimento do Agente 365.

As seções a seguir listam etapas do ciclo de desenvolvimento do Agente 365 onde você constrói esses artefatos:

1. Build e run agent
2. Configuração do Setup Agent 365
3. Projeto do agente de configuração
4. Implantar
5. Publicar agente no centro de administração do Microsoft 365
6. Criar instâncias de agente

Dica

Quer automatizar os passos 2 a 5? A configuração guiada por IA utiliza um agente de codificação de IA (como GitHub Copilot, Claude Code ou OpenAI Codex) para guiá-lo interativamente durante a instalação, configuração, criação de blueprints, implantação e publicação. Tudo a partir de um único arquivo de instruções.

1. Construir e rodar agente

Configure o código do agente para guardar a lógica do seu agente. Esse código pode ser um agente existente ou você pode criar um novo agente.

Construa seu agente usando qualquer SDK de agente e hospeda-o em qualquer serviço em nuvem. Se você ainda não tem um agente, pode usar samples que usam alguns dos SDKs de agentes mais populares para começar rapidamente: microsoft/Agent365-Samples.

Dependendo dos recursos do Agent 365 que você gostaria de adicionar ao seu agente, use o SDK do Agent 365 para adicionar:

• Observabilidade – Aqui você tem duas opções:

  • Auto-instrumentação se você estiver usando um dos SDKs de agente mais populares suportados (OpenAI, LangChain, Agent Framework) OU
  • Instrumentação manual , caso contrário.

• Notificações – Permite que desenvolvedores criem agentes que respondam a eventos e notificações de aplicativos Microsoft 365.

• Ferramentas – Permite que desenvolvedores adicionem várias funcionalidades poderosas de ferramentas aos seus agentes, como E-mail, Calendário e Word.

  • Comece o desenvolvimento e os testes localmente, sem autenticação ou dependências externas, usando servidores de ferramentas simuladas.
  • Quando estiver pronto, mude para servidores MCP de produção com autenticação completa e integração com Microsoft 365 para funcionalidade ao vivo.

• Identidade de Agente - Permite que desenvolvedores criem agentes que possam usar suas próprias identidades únicas para chamadas de ferramentas, observabilidade e mais.

Quando terminar, seu agente deve rodar no Visual Studio Code ou outro IDE sem erros. Aprenda a testar agentes localmente e teste com aplicações do Microsoft 365 usando Dev Tunnels antes de implantar na nuvem.

2. Configuração do Agente de Configuração 365

A CLI do Agente 365 precisa conhecer seu locatário, assinatura e outros detalhes para criar os recursos necessários para o agente, como o Agente Blueprint.

Siga estes passos para criar uma configuração válida do Agente 365: Configuração do Agente 365. Alternativamente, a configuração guiada por IA pode automatizar essa etapa e todas as restantes usando um agente de codificação por IA, como GitHub Copilot, Claude Code ou OpenAI Codex.

Observação

Se você já tem um agente implantado, precisa especificar o endpoint de mensagens na configuração conforme descrito em Set agent messaging endpoint.

Quando terminar, você deve ter um arquivo de configuração válido chamado a365.config.json com todos os detalhes preenchidos corretamente.

3. Projeto do agente de configuração

O blueprint define a identidade do seu agente, permissões e requisitos de infraestrutura. Cada instância de agente que é integrada é criada a partir desse blueprint de agente.

Você precisa de um arquivo de configuração válido do Agent 365 da etapa 2.

Aprenda como configurar o blueprint do agente

Quando terminar, você tem todos os recursos necessários do Azure: agente blueprint, permissões MCP no blueprint, service principal.

4. Implantação

Implante o código do seu agente em uma aplicação online para que cada instância de agente possa rodar nele.

Essa etapa é opcional se você já tiver seu agente rodando no Azure ou em outro serviço em nuvem como Amazon Web Services (AWS) ou Google Cloud Platform (GCP).

Para implantar, você precisa do código de agente funcional desde a etapa 1.

Aprenda como implantar um agente no Azure.

Observação

Se você já tem um agente implantado, precisa especificar o endpoint de mensagens na configuração. Aprenda como definir o endpoint de mensagens do agente. Por exemplo:

• Defina o endpoint de mensagens de endpoint a ponto final na AWS
• Defina o endpoint de mensagens de endpoint para endpoint no GCP

Quando terminar, você tem um aplicativo web funcionando no Azure (ou outra nuvem) rodando o código do seu agente do Agent 365. Você pode configurá-lo ainda mais para melhorar a confiabilidade e a disponibilidade, adicionando mais instâncias de servidor.

5. Publicar agente no centro de administração do Microsoft 365

Administradores podem criar instâncias e gerenciar governança pelo centro de administração do Microsoft 365 quando você publica seu agente.

Aprenda a publicar um agente no centro de administração da Microsoft.

Quando terminar, você deve ter um agente visível no registro no centro de administração da Microsoft.

6. Criar instâncias de agente

Crie instâncias de agentes a partir do blueprint do agente usado como modelo.

Você precisará dos seguintes itens:

• Blueprint do agente configurado corretamente conforme descrito na etapa 3.
• A aplicação do agente foi publicada corretamente conforme descrito no passo 5.

Aprenda a criar instâncias de agentes.

Quando você termina, seu agente aparece no seu organigrama, reportando-se a você e disponível para comunicação via Teams ou e-mail. Esse processo pode levar alguns minutos.