Compartilhar via

Habilidades do agente de Azure

Azure Agent Skills é um catálogo de primeira parte criado pela Microsoft de habilidades legíveis por IA para Azure desenvolvimento. Cada habilidade é um índice estruturado de conteúdo autoritativo do Microsoft Learn, empacotado para que os assistentes de codificação de IA possam descobri-lo e usá-lo para fornecer orientações precisas e atualizadas sobre os serviços Azure.

As habilidades seguem o padrão Agent Skills e funcionam com qualquer assistente de codificação de IA compatível, incluindo GitHub Copilot, Claude Code, Cursor, Gemini CLI, Codex CLI e outros.

Casos de uso

  • Forneça aos assistentes de codificação de IA orientações de nível de especialista Azure fundamentadas na documentação oficial
  • Melhorar a precisão e a integridade das respostas do agente para tarefas de desenvolvimento Azure
  • Permitir que os desenvolvedores obtenham práticas recomendadas, solucionando problemas de fluxos, padrões de arquitetura e diretrizes de segurança diretamente em seu editor
  • Fornecer conhecimento atualizado e estruturado que complementa ferramentas dinâmicas de dados, como servidores MCP

Como funcionam as habilidades do agente

As habilidades do agente são módulos de funcionalidade leves baseados em sistema de arquivos. Cada habilidade é uma pasta que contém um arquivo com frontmatter YAML (nome, descrição, compatibilidade) e conteúdo estruturado organizado por categoria (solução de problemas, práticas recomendadas, arquitetura, segurança, configuração e muito mais).

As habilidades usam a divulgação progressiva para carregar conteúdo com eficiência:

  1. Descoberta – o assistente de IA lê as informações da habilidade e do frontmatter YAML para determinar a relevância.
  2. Instruções – Quando disparado, o assistente carrega o conteúdo completo , que contém links de documentação coletados organizados por tópico
  3. Busca — O assistente recupera o conteúdo mais recente do Microsoft Learn usando o Learn MCP Server ou uma ferramenta de busca da Web

Essa arquitetura separa o índice de conhecimento (o que pesquisar e quando) da entrega de conteúdo (buscando os documentos mais recentes no momento da consulta), garantindo que as habilidades permaneçam atualizadas à medida que a documentação evolui.

O catálogo de habilidades é gerado e mantido automaticamente por um pipeline criado especialmente para esse fim, que examina a documentação de produtos do Azure, identifica conteúdo valioso sobre processos e tomada de decisões e o transforma em arquivos de habilidades estruturados. O fluxo de trabalho avalia continuamente as modificações no conteúdo de entrada e produz atualizações incrementais.

Catálogo de habilidades

O repositório contém habilidades 193 abrangendo os principais serviços do Azure entre estas categorias:

Categoria Habilidades Exemplos
Infraestrutura &gerenciamento 27 Azure Resource Manager, Backup, Monitor, Política, Gerenciamento de Custos, Arc
Especializada 27 Quantum, Mapas, Solução VMware, SAP, Serviços de Dados de Saúde, Área de Trabalho Virtual
Rede 24 Rede Virtual, Porta de Entrada, Firewall, Gateway VPN, ExpressRoute, Balanceador de Carga
IA & ML 20 Serviços de IA, Aprendizado de Máquina, Inteligência de Documentos, Serviço de Bot de fala
Dados & Análise 20 Cosmos DB, Banco de Dados SQL, Data Factory, Synapse Analytics, Databricks
Segurança & Identidade 17 Key Vault, RBAC, Sentinel, Defender para Nuvem, Computação Confidencial
DevOps 14 Azure DevOps, Pipelines, Registro de Contêiner, Ambientes de Implantação, Dev Box
Computação 13 Funções, Aplicativos de Contêiner, Máquinas Virtuais, Serviço do Kubernetes, Serviço de Aplicativo
Integration 12 Aplicativos Lógicos, Gerenciamento de API, Malha de Eventos, Barramento de Serviço, Hubs de Eventos
Armazenamento 9 Armazenamento de Blobs, Arquivos, SAN Elástico, NetApp Files, Armazenamento de Contêiner
IoT & Edge 7 Hub IoT, IoT Central, IoT Edge, Operações de IoT, Gêmeos Digitais

Os pacotes personalizados baseados em funções estão disponíveis para cenários comuns (Essenciais, Infraestrutura, Engenharia de Dados, IA/ML, Segurança, DevOps).

O catálogo de habilidades completo está disponível em docs/CATALOG.md.

Requirements

  • O acesso à rede é necessário. As habilidades fazem referência às URLs de documentação do Microsoft Learn que o assistente de IA busca no momento da consulta.
  • Um assistente de codificação de IA compatível que dá suporte ao padrão aberto de Habilidades do Agente ( formato).
  • Recomendado: o Servidor MCP do Microsoft Learn para recuperação de documentação ideal. Se o Learn MCP Server não estiver disponível, as habilidades voltarão aos recursos de busca da Web integrados à maioria dos assistentes de IA.

Nenhuma autenticação é necessária para usar as funcionalidades em si. As habilidades são arquivos estáticos que são executados localmente em seu ambiente de desenvolvimento.

Como começar

Installation

  1. Por favor, clone o repositório:

    git clone https://github.com/MicrosoftDocs/agent-skills.git

  2. Copie as pastas de habilidades do diretório de habilidades do assistente de IA:

    Assistente de IA Caminho no nível de projeto Caminho global
    GitHub Copilot {project}/.github/skills/ ~/.copilot/skills/
    Código Claude {project}/.claude/skills/ ~/.claude/skills/
    Codex CLI {project}/.codex/skills/ ~/.codex/skills/
    Cursor {project}/.cursor/skills/ —
    Gemini CLI {project}/.gemini/skills/ —

    Importante

    Copie as pastas dentro (por exemplo, , não a própria pasta.

  3. Usuários do VS Code: Habilitar Chat: Usar Habilidades do Agente () em Configurações.

  4. Comece a fazer perguntas ao assistente de IA Azure. As habilidades são ativadas automaticamente com base na consulta.

Usage

Depois de instalado, faça perguntas naturalmente ao assistente de IA:

  • "Me ajudar a configurar Azure Functions com Durable Functions"
  • "Quais são as melhores práticas para Aplicativos de Contêiner do Azure?"
  • "Estou recebendo erros de limitação na minha conta de armazenamento – como fazer para diagnosticar isso?"

O assistente descobrirá automaticamente as habilidades relevantes, carregará as diretrizes estruturadas e buscará a documentação mais recente do Microsoft Learn para fornecer respostas precisas e fundamentadas.

Compatibilidade

Essas habilidades funcionam com qualquer assistente de codificação de IA que dê suporte à especificação de Habilidades do Agente:

Assistente de Codificação de IA Tipo Caminho de habilidades
GitHub Copilot Extensão do VS Code .github/skills/
Código Claude Anthropic CLI .claude/skills/
Codex CLI OpenAI CLI .codex/skills/
Cursor IDE nativo de IA .cursor/skills/
Gemini CLI Google DeepMind .gemini/skills/
IDE de antigravidade DeepMind IDE .agent/skills/
OpenCode CLI de software livre .agent/skills/

Relação com o Learn MCP Server

As habilidades do agente e o Servidor do Learn MCP são complementares:

  • O Learn MCP Server fornece ferramentas – pesquisa, busca e recuperação de exemplo de código no conteúdo do Microsoft Learn
  • As habilidades do agente fornecem conhecimento – diretrizes estruturadas sobre o que pesquisar, quando e como aplicá-lo

As habilidades usam o Learn MCP Server (ou funcionalidade de busca equivalente) como seu mecanismo de entrega de conteúdo. Juntos, eles dão aos assistentes de IA o julgamento para identificar o que é relevante e a capacidade de recuperar o conteúdo autoritativo mais recente.

Disponibilidade e preços

Azure Agent Skills está disponível publicamente como um repositório de software livre sob licença dupla:

  • Conteúdo da documentação: Creative Commons Attribution 4.0 International
  • Código: Licença do MIT

Não há custo para usar as habilidades.

Limitações

  • As habilidades exigem acesso à rede para buscar a documentação do Microsoft Learn. Sem acesso à rede, as habilidades fornecem índices de links curados, mas não podem recuperar o conteúdo completo.
  • Atualmente, o catálogo de habilidades abrange 193 serviços de Azure. A cobertura está se expandindo com cada execução do pipeline à medida que a nova documentação é publicada.
  • As habilidades são geradas com base na documentação do Microsoft Learn disponível publicamente. O conteúdo de módulos de treinamento, roteiros de aprendizagem e cursos ministrados por instrutor não está incluído no momento.
  • O pipeline de geração é executado incrementalmente. Pode haver um pequeno atraso entre as atualizações de documentação no Microsoft Learn e as atualizações de habilidades correspondentes.

Como fornecer comentários

Próximas etapas

  • Introdução ao Learn MCP Server no VS Code
  • Especificação padrão aberta para habilidades de agente
  • Repositório das Habilidades do Agente do Azure
  • Conjuntos de habilidades curados por função
  • Last updated on