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ê criar um colega de IA, para o qual é necessário o programa de versão preliminar do Frontier, também poderá 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 plataforma compatível: Python, Node.js ou .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.

Note

A configuração do Agent 365 usa o aplicativo empresarial Agent 365 CLI, gerenciado pela Microsoft, quando ele está disponível no seu tenant. Você não precisa criar um aplicativo cliente personalizado para esse caminho. Se o aplicativo corporativo não estiver disponível, a configuração volta a um aplicativo de propriedade do tenant chamado Agent 365 CLI. Um aplicativo cliente personalizado configurado explicitamente continua sendo suportado. Para mais informações, veja Registro de aplicativo cliente personalizado para CLI do Agente 365.

O licenciamento depende das capacidades que você adota:

  • Identity. 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 versão preliminar.
  • Notificações. Uma conta de usuário de agente, disponível apenas para locatários no programa de versão prévia 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 blueprints, permissões e consentimento, consulte Identidade do agente e Conceitos-chave do 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 seu stack de tecnologias.

A configuração salva os IDs e endpoints gerados em a365.generated.config.json. A configuração padrão do agente não precisa de um arquivo de configuração criado manualmente; a configuração do colega de equipe de IA requer um a365.config.json criado manualmente.

a365-setup Depois, te direciona por um de dois caminhos de provisionamento. Conclua a opção que ele selecionar e, em seguida, continue com as etapas comuns a seguir:

Ambos os caminhos continuam em Instrumento para observabilidade.

Registrar o agente

Conclua esta etapa se a365-setup encaminhou você para o fluxo 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

Conclua esta etapa se a365-setup encaminhou você para o caminho do colega de equipe de 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 conectado), Agentic-User (a própria conta de usuário do agente, que requer o programa de versão preliminar do Frontier) ou S2S (serviço a serviço, 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 uma execução de teste, os intervalos do seu agente são exibidos no Microsoft Defender, no 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 execução não tiver um span válido invoke_agent na raiz, os spans continuarão podendo ser consultados na busca avançada do Defender, mas não aparecerão em nenhuma das três áreas. O span raiz é o span de nível superior que o SDK emite para uma invocação de um agente; cada chamada de ferramenta e evento de inferência fica aninhado dentro dele.

Conecte os dados do Microsoft 365

Conclua esta etapa em qualquer um dos caminhos se o seu agente lê ou atua sobre 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

Conecte o E-mail 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.

Adicionar prevenção de perda de dados

Complete esta etapa opcional caso seu agente precise de prevenção de perda de dados (DLP) do Microsoft Purview. A habilidade suporta autenticação delegada por agentes e Node.js S2S com autenticação FMI secreta por cliente.

Habilidade: purview-dlp-integration

adicionar o DLP Purview a este agente

O recurso adiciona verificações do Microsoft Graph processContent para bloquear prompts antes de chegarem ao LLM quando houver correspondência com uma política de bloqueio de entrada, e orienta a configuração de permissões e de políticas de DLP. As verificações opcionais de resposta auditam as respostas, mas não filtram conteúdo sensível na saída. Por padrão, erros e expirações por tempo limite interrompem a interação, inclusive impedindo o envio de uma resposta se ela não passar pela auditoria.

Importante

Esta etapa exige que o Purview DLP para IA esteja habilitado no seu locatário, incluindo licenciamento, cobrança conforme o uso e configuração do DSPM para IA. Para .NET, verifique a proteção com melhor esforço contra a versão do seu SDK.

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 iniciar e responder como fazia antes da configuração inicial, e aparecer no Agent 365 com 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, consulte a lista de verificação de validação do SDK do Agent 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.
A instalação relata pré-requisitos do Azure ausentes Conclua os pré-requisitos que a365-setup lista e depois execute a habilidade novamente.
O registro do Blueprint falha, ou comandos da CLI retornam erros de autorização Confirme que você está conectado com uma conta que tenha permissão para registrar modelos de identidade de agente no locatário.
Nenhuma telemetria é exibida Confirme que pelo menos um usuário no tenant tem uma licença Microsoft 365 E7 ou Microsoft Agent 365 atribuída, depois confirme que a execução emite, na raiz, um span invoke_agent válido, 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 levam em conta o estado atual e pulam o trabalho que já está configurado, portanto a etapa provavelmente já foi 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 usa a365.config.json, edite-a e execute novamente a365 config init -c ./a365.config.json, depois execute a habilidade relevante novamente.

Conteúdo relacionado

  • Last updated on