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:

  1. Declare o resultado que você deseja.
  2. Deixe o recurso identificar a stack do projeto e a configuração existente.
  3. Forneça os valores solicitados, como o modo de autenticação.
  4. Revise o código, manifesto e as alterações de configuração que ele faz.
  5. 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 precisar de registro e observabilidade, mas sem conta de usuário.
  • 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. Este caminho requer o programa Frontier de versão prévia.
Skill Purpose
a365-setup Instala a CLI do Agente 365, valida os pré-requisitos do Azure, detecta a pilha de agentes e então delega para 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 modelo de identidade do agente no Microsoft Entra, cria uma identidade de agente a partir dele e configura as permissões do Entra ID de que o agente precisa e, em seguida, oferece observabilidade e ferramentas como recursos complementares.
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. Pede o tipo de agente e o modo de autenticação; veja Identidade do agente.
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 caminho 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.

Pilhas compatíveis

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

Linguagem Frameworks
.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.
  • Ciente do estado. As habilidades detectam o que já está configurado, por isso pulam, em vez de repetir etapas já concluídas.
  • Com barreira de segurança. As habilidades não modificam arquivos fora do seu projeto e verificam se a compilação 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.

Conteúdo relacionado

  • Última atualização em