Compartir vía

Aptitudes del agente de Azure

Azure Agent Skills es un catálogo de habilidades legibles por inteligencia artificial creado por Microsoft para el desarrollo de Azure. Cada aptitud es un índice estructurado del contenido autoritativo de Microsoft Learn, empaquetado para que los asistentes de codificación de IA puedan detectarlo y usarlo para proporcionar instrucciones precisas y up-to-date sobre los servicios de Azure.

Las aptitudes siguen el estándar abierto Agent Skills y funcionan con cualquier asistente de codificación de IA compatible, incluidos GitHub Copilot, Claude Code, Cursor, Cli de Gemini, Cli del Codex y otros.

Casos de uso

  • Proporcionar a los asistentes de codificación de IA una guía de nivel experto Azure basada en documentación oficial
  • Mejora de la precisión e integridad de las respuestas del agente para las tareas de desarrollo de Azure
  • Permitir a los desarrolladores obtener procedimientos recomendados, flujos de solución de problemas, patrones de arquitectura e instrucciones de seguridad directamente en su editor
  • Proporcionar conocimientos estructurados actualizados que complementen herramientas de datos dinámicas como servidores MCP

Cómo funcionan las aptitudes del agente

Las aptitudes del agente son módulos ligeros y basados en el sistema de archivos. Cada aptitud es una carpeta que contiene un archivo con frontmatter YAML (nombre, descripción, compatibilidad) y contenido estructurado organizado por categoría (Solución de problemas, Procedimientos recomendados, Arquitectura, Seguridad, Configuración, etc.).

Las aptitudes usan la divulgación progresiva para cargar contenido de forma eficaz:

  1. Detección: el asistente de IA lee el y la de la aptitud del texto preliminar de YAML para determinar su relevancia.
  2. Instrucciones : cuando se desencadena, el asistente carga el contenido completo , que contiene vínculos de documentación mantenidos organizados por tema.
  3. Captura : el asistente recupera el contenido más reciente de Microsoft Learn mediante el servidor MCP de Learn o una herramienta de captura web.

Esta arquitectura separa el índice de conocimiento (qué buscar y cuándo) de la entrega de contenido (capturando los documentos más recientes en el momento de la consulta), lo que garantiza que las aptitudes permanezcan actualizadas a medida que evoluciona la documentación.

El catálogo de aptitudes se genera y mantiene automáticamente mediante una canalización creada específicamente que examina Azure documentación del producto, identifica contenido de procedimientos y toma de decisiones de alto valor y lo transforma en archivos de aptitudes estructurados. El pipeline evalúa continuamente cambios en el contenido de upstream y genera actualizaciones incrementales.

Catálogo de aptitudes

El repositorio contiene 193 skills que abarcan los servicios principales de Azure en estas categorías:

Categoría Habilidades Ejemplos
Infraestructura y administración 27 Azure Resource Manager, Copia de seguridad, Monitoreo, Política, Gestión de costos, Arc
Especializado 27 Quantum, Maps, VMware Solution, SAP, Health Data Services, Virtual Desktop
Networking 24 Red virtual, Front Door, Firewall, VPN Gateway, ExpressRoute, Load Balancer
IA y ML 20 Servicios de IA, Machine Learning, Inteligencia de Documentos, Voz, Servicio de Bots
Datos y análisis 20 Cosmos DB, SQL Database, Data Factory, Synapse Analytics, Databricks
Seguridad e identidad 17 Key Vault, RBAC, Sentinel, Defender for Cloud, Confidential Computing
DevOps 14 Azure DevOps, Canalizaciones, Container Registry, Deployment Environments, Dev Box
Compute 13 Funciones, Aplicaciones de contenedor, Máquinas virtuales, Servicio de Kubernetes, Servicio de aplicaciones
Integración 12 Logic Apps, API Management, Event Grid, Service Bus, Event Hubs
Storage 9 Blob Storage, Archivos, Elastic SAN, NetApp Files, Almacenamiento de Contenedores
IoT & Edge 7 IoT Hub, IoT Central, IoT Edge, Operaciones de IoT, Digital Twins

Los conjuntos seleccionados basados en roles están disponibles para escenarios comunes (Essentials, Infrastructure, Data Engineering, AI/ML, Security, DevOps).

El catálogo completo de aptitudes está disponible en docs/CATALOG.md.

Requisitos

  • Se requiere acceso a la red . Las aptitudes hacen referencia a las direcciones URL de documentación de Microsoft Learn que el asistente de IA captura en el momento de la consulta.
  • Asistente de codificación de IA compatible que admite el estándar abierto de aptitudes del agente ( formato).
  • Recomendado: El servidor MCP de Microsoft Learn para obtener una recuperación óptima de la documentación. Si el servidor Learn MCP no está disponible, las habilidades recurren a las capacidades de búsqueda web integradas en la mayoría de los asistentes de IA.

No se requiere autenticación para usar las habilidades. Las habilidades son archivos estáticos que funcionan localmente en el entorno de desarrollo.

Cómo empezar

Installation

  1. Clone el repositorio:

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

  2. Copie las carpetas de habilidades en el directorio de habilidades del asistente de IA.

    Asistente de IA Ruta de acceso de nivel de proyecto Ruta de acceso global
    GitHub Copilot {project}/.github/skills/ ~/.copilot/skills/
    Claude Code {project}/.claude/skills/ ~/.claude/skills/
    Codex CLI {project}/.codex/skills/ ~/.codex/skills/
    Cursor {project}/.cursor/skills/ —
    Gemini CLI {project}/.gemini/skills/ —

    Importante

    Copie las carpetas dentro de (por ejemplo, , ), no la propia carpeta.

  3. Usuarios de VS Code: Activar chat: Usar aptitudes del agente () en Configuración.

  4. Empiece a formular preguntas a su asistente de IA Azure. Las aptitudes se activan automáticamente en función de la consulta.

Uso

Una vez instalado, haga preguntas al asistente de INTELIGENCIA ARTIFICIAL de forma natural:

  • "Ayúdame a configurar Azure Functions con Durable Functions"
  • "¿Cuáles son los procedimientos recomendados para Azure Container Apps?"
  • "Recibo errores de limitación en mi cuenta de almacenamiento: ¿cómo puedo diagnosticarlo?".

El asistente detectará automáticamente las aptitudes pertinentes, cargará las instrucciones estructuradas y capturará la documentación más reciente de Microsoft Learn para proporcionar respuestas precisas y fundamentadas.

Compatibility

Estas aptitudes funcionan con cualquier asistente de codificación de IA que admita la especificación de aptitudes del agente:

Asistente para codificación de IA Tipo Ruta de aptitudes
GitHub Copilot Extensión de VS Code .github/skills/
Claude Code 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 antigravedad DeepMind IDE .agent/skills/
OpenCode CLI de código abierto .agent/skills/

Relación con el servidor MCP de Learn

Las aptitudes del agente y el servidor MCP de Learn son complementarios:

  • Learn MCP Server proporciona herramientas : búsqueda, captura y recuperación de ejemplo de código en el contenido de Microsoft Learn
  • Las aptitudes del agente proporcionan conocimientos : instrucciones estructuradas sobre qué buscar, cuándo y cómo aplicarla

Las aptitudes usan el servidor MCP de Learn (o una capacidad de recuperación equivalente) como mecanismo de entrega de contenido. Juntos, proporcionan a los asistentes de inteligencia artificial el criterio para identificar lo que es relevante y la capacidad de recuperar el contenido autoritativo más reciente.

Disponibilidad y precios

Azure Agent Skills está disponible públicamente como repositorio de código abierto bajo licencia dual:

  • Contenido de documentación: Creative Commons Attribution 4.0 International
  • Código: Licencia MIT

No hay ningún cargo por usar las habilidades.

Limitaciones

  • Las aptitudes requieren acceso a la red para capturar documentación de Microsoft Learn. Sin acceso a la red, las habilidades proporcionan índices de enlaces curados, pero no pueden recuperar el contenido completo.
  • Actualmente, el catálogo de aptitudes cubre 193 Azure servicios. La cobertura se está expandiendo con cada ejecución de canalización a medida que se publica la nueva documentación.
  • Las aptitudes se generan a partir de la documentación de Microsoft Learn disponible públicamente. El contenido de los módulos de aprendizaje, las rutas de aprendizaje y los cursos dirigidos por instructores no se incluye en este momento.
  • La canalización de generación se ejecuta de manera incremental. Puede haber un breve retraso entre las actualizaciones de documentación de Microsoft Learn y las actualizaciones de aptitudes correspondientes.

Cómo proporcionar comentarios

  • GitHub Problemas: https://github.com/MicrosoftDocs/agent-skills/issues (preferido para errores, huecos o solicitudes de características)
  • Contribuciones: el repositorio da la bienvenida a las solicitudes de incorporación de cambios. Consulte las guías de contribución en el README.

Pasos siguientes

  • Introducción al servidor MCP de Learn en VS Code
  • Especificación estándar abierta de aptitudes del agente
  • Repositorio de habilidades del agente de Azure
  • Agrupaciones de aptitudes seleccionadas por rol
  • Last updated on