Início Rápido: Conecte um agente existente ao Agente 365

Neste quickstart, você conecta um agente existente ao Agent 365 usando as Habilidades do Agente 365 no seu assistente de programação. O caminho começa registrando o agente, depois adiciona as capacidades que você escolher, e termina com a validação. Se você montar um companheiro de IA, que exige o programa de pré-visualização do Frontier, você também pode testá-lo localmente.

Cada etapa nomeia a habilidade que a executa e mostra um pedido de exemplo. Você invoca uma habilidade declarando o resultado, não digitando o nome da habilidade.

Pré-requisitos

  • Um agente existente em uma pilha suportada: Python, Node.jsou .NET.
  • Um tenant da Microsoft com o Agente 365 ativado. Faça login como Administrador Global ou como Desenvolvedor de ID de Agente, com um Administrador Global disponível para completar as concessões de permissões do OAuth.
  • Uma assinatura do Azure com permissão para criar recursos.
  • Um assistente de programação suportado: Claude Code, GitHub Copilot CLI ou modo agente VS Code.
  • A CLI do GitHub (gh), usada para instalar as habilidades.

O licenciamento depende das capacidades que você adota:

  • Identidade. Sem carteira adicional. O locatário deve ter o Agente 365 ativado.
  • Observabilidade. Pelo menos um usuário no tenant com uma licença Microsoft 365 E7 ou Microsoft Agent 365 atribuída. Sem ele, a telemetria é descartada silenciosamente.
  • Ferramentas (QI de Trabalho). Uma licença do Microsoft 365 Copilot. O MCP do Work IQ está em prévia.
  • Notificações. A conta de usuário de um agente, disponível apenas para inquilinos no programa de pré-visualização Frontier.

Tip

Primeiro, confirme se o SDK é o mecanismo de integração correto para o seu agente. Veja Escolha a opção de integração. Para o modelo de identidade por trás do registro, incluindo projetos, permissões e consentimento, veja os conceitos-chavede identidade do agente e ID do agente Microsoft Entra.

Instale as habilidades

Instale as habilidades no seu assistente de programação:

gh skill add microsoft/agent365-skills

O mesmo comando funciona para Claude Code, GitHub Copilot CLI e modo agente VS Code. Reinicie seu assistente depois para que ele aprenda as novas habilidades.

Configure e detecte o projeto

Abra seu projeto de agente no seu assistente de programação, depois execute:

Habilidade: a365-setup

montar este projeto para o Agente 365

Responda às perguntas sobre seu corretor. Quando a habilidade termina, ela valida seus pré-requisitos e detecta sua pilha.

Setup salva IDs e endpoints gerados em a365.generated.config.json. A configuração padrão de agente não precisa de um arquivo de configuração escrito manualmente; A configuração dos colegas de equipe por IA requer um arquivo criado a365.config.jsonmanualmente por .

a365-setup Depois, te direciona por um de dois caminhos de provisionamento. Complete o que ele selecionar, depois continue com os passos compartilhados que seguem:

Ambos os caminhos continuam em Instrumento para observabilidade.

Registrar o agente

Complete esta etapa se a365-setup você for direcionado para o caminho padrão do agente.

Habilidade: make-a365-agent

registre este agente com o Agente 365

Quando a habilidade termina, seu agente tem um blueprint registrado no Microsoft Entra, uma identidade de agente criada a partir dele e as permissões necessárias. O registro proporciona visibilidade do catálogo; O passo de observabilidade adiciona telemetria.

Adicionar mensagens e notificações

Complete essa etapa se a365-setup você for direcionado para o caminho dos companheiros de equipe da IA.

Habilidade: make-ai-teammate

Adicionar mensagens e notificações a este agente

A habilidade adiciona a camada de hospedagem e o roteamento de mensagens, e registra o agente. As pessoas podem então acessá-lo pelo Teams, Outlook, comentários no Word e e-mail.

Importante

Essa etapa dá ao seu agente sua própria conta de usuário, incluindo uma caixa de correio e presença no Teams. Essa funcionalidade está disponível apenas para inquilinos que participam do programa de prévia Frontier. Pule essa etapa se seu inquilino não estiver inscrito.

Instrumento para observabilidade

Complete essa etapa em qualquer um dos caminhos. A habilidade pergunta que tipo de agente você tem.

Habilidade: instrument-observability

adicionar observabilidade a esse agente

Quando solicitado, escolha o modo de autenticação que seu agente usa: OBO (em nome de um usuário logado), Agentic-User (a conta de usuário do agente, que requer o programa de pré-visualização Frontier) ou S2S (service-to-service, para operações em segundo plano). O exportador usa o mesmo modo com o qual seu agente autentica, então escolha o modo que corresponde ao seu modelo de permissões. Veja Identidade do Agente.

Após um teste, os spans do seu agente aparecem no Microsoft Defender, Microsoft Purview e no Centro de administração do Microsoft 365.

Importante

Duas coisas podem fazer a telemetria parecer que desapareceu, mesmo que a solicitação retorne HTTP 200. Se nenhum usuário no tenant tiver uma licença Microsoft 365 E7 ou Microsoft Agent 365 atribuída, toda a solicitação é descartada; a presença do SKU não é suficiente. Se a sequência não tiver um vão válido invoke_agent em sua raiz, os vãos permanecem consultáveis na caça avançada do Defender, mas não aparecem em nenhuma das três superfícies. O escampador raiz é o avanço de nível superior que o SDK emite para uma invocação de agente; Cada chamada de ferramenta e evento de inferência se encaixa dentro dela.

Conecte os dados do Microsoft 365

Complete essa etapa em qualquer um dos caminhos se seu agente ler ou agir com dados do Microsoft 365. As ferramentas do Work IQ exigem um modelo de permissões delegadas, então essa etapa é pulada automaticamente se você escolher S2S na etapa de observabilidade.

Habilidade: add-workiq-tools

Ligue o Correio e o Calendário do Work IQ

Diga as cargas de trabalho que você precisa, como Mail, Calendar ou Word. A habilidade conecta os servidores MCP do Work IQ correspondentes, e seu agente pode então acessar esses dados sob controle administrativo.

Importante

O Work IQ MCP está em prévia e exige uma licença Microsoft 365 Copilot. Um Administrador Global deve conceder permissões OAuth para os servidores Work IQ antes que seu agente possa chamá-los. Veja Adicionar e gerenciar ferramentas.

Testar localmente

Complete essa etapa se você estiver no caminho dos companheiros de equipe controlados pela IA, que requer o programa de prévia Frontier. O Agents Playground se conecta pelo endpoint de mensagens do agente, então não se aplica aos agentes padrão.

Habilidade: test-local

Teste esse agente localmente

Seu agente compete contra o Agents Playground, um colete local de teste, então você pode testar fumaça antes de ser implantado.

Valide o resultado

Seu agente deve começar e responder como fez antes da integração, e aparecer no Agente 365 sob sua identidade registrada.

Se seu assistente de codificação expor a capacidade interna de Validação e Diagnóstico do Agente 365, peça para ele validar essa integração com o Agente 365 para rodar o pré-voo em nível de código contra o projeto. Ele verifica lacunas na instrumentação, artefatos do Microsoft Entra, mensagens, acesso a ferramentas e configurações relacionadas. A capacidade também é chamada internamente de a365-code-validator; disponibilidade e roteamento exato dependem do assistente de codificação e do pacote de habilidades instalado.

Antes de implantar, trabalhe pela checklist de validação do SDK do Agente 365.

Troubleshoot

Use a tabela a seguir para identificar e resolver problemas comuns ao conectar seu agente ao Agente 365.

Sintoma Resolução
O assistente de programação descreve os comandos, mas não os executa Use um modo que tenha acesso ao terminal. No VS Code, use o modo agente. Os modos Perguntar e Editar não conseguem executar comandos de terminal.
Relatórios de configuração que faltam pré-requisitos do Azure Complete os pré-requisitos listados a365-setup e depois execute a habilidade novamente.
O registro do Blueprint falha, ou comandos da CLI retornam erros de autorização Confirme que você está logado com uma conta que tem permissão para registrar blueprints de identidade de agente no inquilino.
Nenhuma telemetria aparece Confirme que pelo menos um usuário do tenant tem uma licença Microsoft 365 E7 ou Microsoft Agent 365 atribuída, depois confirme que a execução emite um span válido invoke_agent em sua raiz, e então confirme que o modo de autenticação que você selecionou corresponde ao seu ambiente. Peça ao seu assistente de codificação para validar a integração com o Agent 365; A habilidade do validador instalado pode diagnosticar a instrumentação.
Um passo parece ter sido pulado As habilidades são conscientes do estado e pulam trabalhos já programados, então a etapa provavelmente já está concluída. Execute a habilidade específica novamente e informe o resultado explicitamente.
Os valores de configuração precisam mudar após a configuração Se sua configuração usar a365.config.json, edite e execute a365 config init -c ./a365.config.jsonnovamente , então execute novamente a habilidade relevante.

Conteúdo relacionado

  • Last updated on