Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 rodam em todos os agentes de codificação, incluindo Claude Code, GitHub Copilot CLI e modo agente 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
Habilidades substituem o fluxo de trabalho de configuração anterior que usava um instructions.md arquivo.
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 a habilidade identificar a pilha de projetos 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.
As sete habilidades
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-setupdelega paramake-a365-agent. Use esse caminho quando o agente precisar de registro e observabilidade, mas sem conta de usuário. -
Colega de equipe IA.
a365-setupdelega paramake-ai-teammate, para um agente que precisa de sua própria conta de usuário. Esse caminho requer o programa de pré-visualização Frontier.
| 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 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, depois 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. É preciso a365-setup ter corrido primeiro. |
instrument-observability |
Wires OpenTelemetry e o exportador de rastreamento Agent 365 para que os abrangências dos agentes alcancem Microsoft Defender, Microsoft Purview e o 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. |
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. Vale para o caminho dos companheiros de equipe da 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 seu assistente de codificação expor a capacidade interna a365-code-validator , peça para validar essa integração com o Agente 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.
Stacks suportados
As habilidades detectam automaticamente a pilha 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 | 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.
- Consciência do Estado. As habilidades detectam o que já está conectado, então pulam em vez de repetir etapas concluídas.
- Guarda-corrimão. As habilidades não modificam arquivos fora do seu projeto, e elas verificam que a build ainda passa antes de terminar.
Use Habilidades quando:
- Você já tem um agente e quer integrá-lo sem escrever a integração manualmente.
- Seu fluxo de trabalho de desenvolvimento já inclui um assistente de programação.
- Você quer uma integração consistente e repetível entre 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á fazendo solução de problemas e quer executar cada etapa sozinho.
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.