Habilidades do Agente 365 para configuração guiada de agentes

As Habilidades do Agente 365 fornecem um caminho guiado para configurar um agente existente ao Agente 365 a partir de um assistente de codificação suportado. Você declara o resultado desejado, como adicionar observabilidade a esse agente, e a habilidade identifica o projeto, coleta os valores necessários, faz as alterações de integração e verifica o resultado.

As habilidades funcionam em todos os agentes de programação, incluindo Claude Code, GitHub Copilot CLI e o modo agente do VS Code.

Para instalar as habilidades e seguir o caminho de integração do seu agente, veja Início Rápido: Conecte um agente existente ao Agente 365.

Note

As habilidades substituem o fluxo de configuração anterior que usava um arquivo instructions.md.

Quando usar Habilidades

Conectar um agente existente à identidade corporativa, observabilidade, ferramentas governadas e notificações exige várias etapas ordenadas de configuração. Essas etapas incluem instalar a CLI do Agent 365, validar pré-requisitos do Azure, registrar um blueprint, configurar recursos do Entra, conectar exportadores do OpenTelemetry, conectar servidores Model Context Protocol (MCP) e testar localmente.

As habilidades executam essas etapas na ordem exigida para o caminho selecionado e validam o projeto resultante.

Como uma habilidade funciona

Cada habilidade segue o mesmo fluxo de trabalho:

Declare o resultado que você deseja.
Deixe o recurso identificar a stack do projeto e a configuração existente.
Forneça os valores solicitados, como o modo de autenticação.
Revise o código, manifesto e as alterações de configuração que ele faz.
Confirme que o projeto ainda está sendo construído e que a integração funciona.

Habilidades Disponíveis para o Agente 365

a365-setup é o ponto de entrada. Depois que valida os pré-requisitos, ele te direciona por um de dois caminhos, e você segue apenas esse caminho:

Agente padrão. a365-setup delega para make-a365-agent. Use esse caminho quando o agente não precisar de conta de usuário própria. Um agente padrão autentica com OBO ou S2S, então pode agir para um usuário logado ou rodar sem um.
Companheiro de equipe de IA. a365-setup delega para make-ai-teammate, para um agente que precisa de sua própria conta de usuário. Um colega de equipe de IA faz login como essa conta de usuário (Agentic-User). Este caminho requer o programa Frontier de versão prévia.

Para escolher um caminho e um modo de autenticação, veja Tipos de Agentes e modos de autenticação.

Skill	Purpose
`a365-setup`	Instala a CLI do Agente 365, valida os pré-requisitos do Azure e detecta a pilha de agentes. Para um agente padrão, pergunta se o agente autentica com OBO ou S2S. Então delega a `make-a365-agent` ou `make-ai-teammate`.
`make-a365-agent`	Fornece um agente padrão que não precisa de conta de usuário própria. Registra o blueprint de identidade do agente no Microsoft Entra, cria uma identidade de agente a partir dele e configura as permissões do Entra ID que o agente precisa: permissões delegadas para OBO ou permissões de aplicação para S2S. Em seguida, oferece observabilidade e ferramentas como complementos.
`make-ai-teammate`	Transforma um agente em um colega de equipe de IA com sua própria conta de usuário. Registra o blueprint de identidade do agente e cria uma identidade de agente a partir dele, depois adiciona a camada de hospedagem, o roteamento de mensagens e as notificações. Requer que `a365-setup` tenha sido executado primeiro.
`instrument-observability`	Integra o OpenTelemetry e o exportador de rastreamento do Agent 365 para que os spans do agente cheguem ao Microsoft Defender, ao Microsoft Purview e ao centro de administração do Microsoft 365. Suporta OBO, S2S e Agentic-User. Pede o tipo de agente e o modo de autenticação se `a365-setup` ainda não os tiver registrado.
`a365-code-validator`	Valida e diagnostica uma integração existente com o Agent 365, incluindo instrumentação, artefatos do Microsoft Entra, mensagens, acesso à ferramenta e configuração relacionada. Somente leitura por padrão. Use `instrument-observability` para adicionar observabilidade do zero.
`add-workiq-tools`	Conecta servidores MCP do Work IQ, incluindo Mail, Calendar e Word, para que o agente possa ler e agir com dados do Microsoft 365. Requer um modelo de permissões delegadas e é pulado automaticamente quando o modo de autenticação é S2S.
`purview-dlp-integration`	Adiciona verificações de prevenção contra perda de dados (DLP) do Microsoft Purview antes das chamadas do LLM do agente, usando o Microsoft Graph `processContent`, com auditoria opcional das respostas. Orienta a configuração da permissão do Graph e da política de DLP.
`test-local`	Roda um agente de equipe com IA localmente e abre o Agents Playground para testes interativos, sem necessidade de implantação na nuvem. Aplica-se ao fluxo do colega de equipe de IA.

Importante

make-ai-teammate 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.

Normalmente, você invoca uma habilidade dizendo o resultado em vez de nomear a habilidade. Por exemplo, adicione observabilidade a esse agente executa instrument-observability. Se o seu assistente de codificação disponibilizar a capacidade interna a365-code-validator, peça que valide esta integração do Agent 365; a capacidade também é descrita internamente como Validar & Diagnosticar. Disponibilidade e invocação dependem do assistente e do pacote de habilidades instalado. Para a formulação da solicitação usada em cada etapa, veja Quickstart: Conecte um agente existente ao Agente 365.

Tipos de agentes e modos de autenticação

Habilidades configuram tanto agentes padrão quanto colegas de equipe de IA. O caminho determina quais modos de autenticação estão disponíveis para o agente. O modo de autenticação, chamado modo de execução na identidade do Agente, determina sob qual identidade o agente atua ao chamar serviços downstream, como Microsoft Graph e servidores MCP.

Modo de autenticação	Path	O agente atua como	Use-o quando
OBO (em nome de)	Agente padrão	O usuário logado, com permissões delegadas	O agente trabalha no contexto do usuário, como ler o calendário desse usuário ou enviar e-mails para ele.
S2S (serviço a serviço)	Agente padrão	Sua própria identidade de agente, com permissões de aplicação	O agente roda sem um usuário logado, como para tarefas agendadas, monitoramento ou processamento em segundo plano.
Agentic-User	Colega de equipe de IA	Sua própria conta de usuário	O agente precisa de sua própria caixa de correio, presença no Teams ou outras experiências de Microsoft 365 baseadas no usuário. Requer o programa Frontier Preview.

Para um agente padrão, a365-setup pergunta se o agente usa OBO ou S2S, e habilidades posteriores reutilizam sua resposta. Um companheiro de IA sempre usa o Agentic-User, então a365-setup não pergunta. Configure um modo para cada agente nas habilidades. Se o agente precisar de permissões delegadas e de aplicação, execute a365 setup all --authmode both com a CLI do Agente 365. Para os papéis que cada modo exige, veja Permissões de identidade do agente.

O modo de autenticação altera o que as habilidades podem configurar:

make-a365-agent executa a365 setup all com --authmode obo ou --authmode s2s. OBO concede permissões delegadas à identidade do agente, e o S2S atribui permissões de aplicação a ele.
instrument-observability exporta telemetria pela rota S2S com um token exclusivo de app em todos os modos, então uma instância de agente registrado não precisa de permissão de observabilidade ou consentimento do administrador. Para OBO e Agentic-User, a habilidade configura o agente para obter esse token reutilizando as credenciais blueprint da conexão de hospedagem dela. Para S2S, ele adiciona um serviço de token que adquire e atualiza o token para agentes .NET, Node.js e Python. Veja Agent 365 habilitado usando S2S.
add-workiq-tools requer um token de usuário delegado, então funciona com OBO e Agentic-User , mas não com S2S. Se você escolher S2S, a365-setup remove o Work IQ das suas capacidades selecionadas.
purview-dlp-integration suporta autenticação delegada agêntica. Para S2S, ele suporta apenas agentes Node.js que utilizam autenticação Federated Managed Identity (FMI) com segredo do cliente.
test-local Vale apenas para colegas de equipe controlados pela IA.

Pilhas compatíveis

Skills detectam automaticamente a stack do projeto, então você não precisa mapear seu projeto manualmente. Esses são os stacks que as Habilidades detectam. O SDK também funciona com outros frameworks.

Linguagem	Estruturas
.NET	Microsoft Agent Framework, Kernel semântico, Fábrica de IA do Azure
Node.js	LangChain, SDK de Agentes OpenAI, SDK de Agentes Claude, Kernel semântico, Google ADK
Python	Microsoft Agent Framework, LangChain, OpenAI Agents SDK, Claude Agent SDK, Kernel semântico, Google ADK

Segurança e repetibilidade

As habilidades são projetadas para aplicar mudanças de configuração sem alterar o comportamento existente do seu projeto. Confirme esse comportamento com a lista de verificação de validação do SDK do Agente 365.

Aditivo e idempotente. As habilidades não apagam nem reestruturam código existente, e reexecutar uma habilidade não duplica o trabalho concluído.
Consciência do Estado. As habilidades detectam o que já está configurado, por isso pulam, em vez de repetir etapas já concluídas.
Com proteções. As habilidades não modificam arquivos fora do seu projeto e verificam se a build continua sendo concluída com sucesso antes de concluir.

Use Habilidades quando:

Você já tem um agente e quer incorporá-lo sem precisar fazer a integração manualmente.
Seu fluxo de trabalho de desenvolvimento já inclui um assistente de programação.
Você quer um processo de integração consistente e padronizado em todos os projetos.

Use a configuração manual quando:

Seu ambiente é não padrão e cada etapa precisa de controle individual.
Sua organização restringe os fluxos de trabalho dos assistentes de programação.
Você está solucionando problemas e quer executar cada etapa por conta própria.

Para o caminho manual, use os passos de configuração no Quickstart: conecte um agente existente ao Agent 365 e execute os comandos equivalentes da CLI do Agent 365 para o seu ambiente.

Comentários

Esta página foi útil?

Última atualização a 2026-10-16