Azure Agent Skills

Azure Agent Skills — це каталог навичок для читання ШІ, розроблений компанією Microsoft, для розробки Azure. Кожна навичка — це структурований індекс авторитетного контенту Microsoft Learn, створений так, щоб асистенти з програмування з ШІ могли знаходити і використовувати його для надання точних up-to-датових рекомендацій щодо Azure сервісів.

Навички відповідають відкритому стандарту Agent Skills і працюють з будь-яким сумісним AI-помічником програмування, включно з GitHub Copilot, Claude Code, Cursor, Gemini CLI, Codex CLI та іншими.

Випадки використання

  • Надайте асистентам програмування AI експертні поради з Azure, засновані на офіційній документації
  • Підвищення точності та повноти відповідей агентів для завдань розробки Azure
  • Дайте змогу розробникам отримувати найкращі практики, процеси усунення несправностей, архітектурні шаблони та рекомендації з безпеки безпосередньо у своєму редакторі
  • Надайте структуровані знання з up-toдатою, які доповнюють інструменти для живих даних, такі як сервери MCP

Як працюють навички агента

Агентські навички — це легкі модулі на основі файлової системи. Кожна навичка — це папка, що містить файл із фронтматером YAML (назва, опис, сумісність) та структурованим контентом, організованим за категоріями (Усунення несправностей, Найкращі практики, Архітектура, Безпека, Конфігурація тощо).

Навички використовують поступове розкриття інформації для ефективного завантаження контенту:

  1. Виявлення — AI-асистент читає навичку та фронтматер YAML, щоб визначити релевантність
  2. Інструкції — При спрацьовуванні асистент завантажує повний контент, який містить ретельно підібрані посилання на документацію, організовані за темами
  3. Fetch — Асистент отримує останній контент з Microsoft Learn за допомогою Learn MCP Server або веб-інструменту для вилучення

Ця архітектура відокремлює індекс знань (що шукати і коли) від доставки контенту (отримання найсвіжішої документації під час запиту), забезпечуючи актуальність навичок у міру розвитку документації.

Каталог навичок автоматично генерується та підтримується спеціально створеним конвеєром, який сканує документацію продукту Azure, виявляє цінний процедурний і прийнятий рішень контент і перетворює його на структуровані файли навичок. Конвеєр постійно оцінює зміни вмісту в попередній сегменті та створює поступові оновлення.

Каталог навичок

Репозиторій містить 193 skills охоплюючи основні послуги Azure у таких категоріях:

Категорія Уміння. Приклади
Інфраструктура та управління 27 Azure Resource Manager, резервне копіювання, моніторинг, політика, управління витратами, arc
Спеціалізованих 27 Quantum, карти, VMware Solution, SAP, Health Data Services, Virtual Desktop
Networking 24 Virtual Network, Front Door, Firewall, VPN Gateway, ExpressRoute, Load Balancer
AI та ML 20 AI Services, Machine Learning, Document Intelligence, Speech, Bot Service
Дані та аналітика 20 Cosmos DB, SQL Database, Data Factory, Synapse Analytics, Databricks
Безпека та ідентичність 17 Key Vault, RBAC, Sentinel, Defender for Cloud, Confidential Computing
DevOps 14 Azure DevOps, Pipelines, Container Registry, Deployment Environments, Dev Box
Compute 13 Функції, Container Apps, Virtual Machines, Kubernetes Service, App Service
Інтеграція 12 Логічні додатки, управління API, сітка подій, Service Bus, хаби подій
Сховище 9 Blob Storage, файли, Elastic SAN, файли NetApp, контейнерне зберігання
IoT та Edge 7 IoT Hub, IoT Central, IoT Edge, IoT Operations, Digital Twins

Доступні ролеві кураторські пакети для поширених сценаріїв (Essentials, Infrastructure, Data Engineering, AI/ML, Security, DevOps).

Повний каталог навичок доступний на docs/CATALOG.md.

Вимоги

  • Потрібен доступ до мережі. Навички посилаються на URL-адреси документації Microsoft Learn, які AI-асистент отримує під час запиту.
  • Сумісний AI-асистент програмування , який підтримує відкритий стандарт Agent Skills ( формат).
  • Рекомендується: Microsoft Learn MCP Server для оптимального пошуку документації. Якщо Learn MCP Server недоступний, навички повертаються до можливостей веб-вилучення, вбудованих у більшість AI-асистентів.

Для використання самих навичок не потрібна автентифікація. Навички — це статичні файли, які працюють локально у вашому середовищі розробки.

Початок роботи

Інсталяція

  1. Клонуйте репозиторій:

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

  2. Скопіюйте папки навичок у каталог навичок вашого AI-асистента:

    AI Assistant Шлях на рівні проєкту Глобальний шлях
    GitHub Copilot {project}/.github/skills/ ~/.copilot/skills/
    Клод Код {project}/.claude/skills/ ~/.claude/skills/
    Кодекс CLI {project}/.codex/skills/ ~/.codex/skills/
    Курсор {project}/.cursor/skills/ —
    Близнюки CLI {project}/.gemini/skills/ —

    Важливий

    Скопіюйте папки всередині (наприклад, , ), а не саму папку.

  3. Користувачі VS Code: Увімкнути чат: Використовувати навички агента () у налаштуваннях.

  4. Почніть ставити питання своєму AI-асистенту в Azure. Навички активуються автоматично залежно від вашого запиту.

Використання

Після встановлення ставте запитання своєму AI-асистенту природно:

  • "Допоможіть мені налаштувати Azure Functions з Durable Functions"
  • "Які найкращі практики для Azure Container Apps?"
  • "У мене почалися помилки тротлінгу на обліковому записі зберігання — як це діагностувати?"

Асистент автоматично виявить релевантні навички, завантажить структуровані рекомендації та отримає найновішу документацію з Microsoft Learn, щоб надати точні, обґрунтовані відповіді.

Сумісність

Ці навички працюють з будь-яким AI-помічником програмування, який підтримує специфікацію Agent Skills:

Асистент програмування ШІ Тип Шлях розвитку навичок
GitHub Copilot Розширення VS Code .github/skills/
Клод Код Антропічний CLI .claude/skills/
Кодекс CLI OpenAI CLI .codex/skills/
Курсор AI-нативний IDE .cursor/skills/
Близнюки CLI Погугліть DeepMind .gemini/skills/
Antigravity IDE DeepMind IDE .agent/skills/
OpenCode Відкритий CLI .agent/skills/

Зв'язок із сервером Learn MCP

Навички агента та сервер Learn MCP доповнюють один одного:

  • Learn MCP Server надає інструменти — пошук, вилучення та пошук зразків коду на основі контенту Microsoft Learn
  • Агентські навички надають знання — структуровані рекомендації щодо того, що шукати, коли і як це застосовувати

Skills використовують Learn MCP Server (або еквівалентну можливість отримання інформації) як механізм доставки контенту. Разом вони дають асистентам ШІ право визначати релевантне і отримувати найновіший авторитетний контент.

Доступність і ціни

Azure Agent Skills є публічно доступним як відкритий репозиторій за подвійною ліцензією:

  • Документація: Creative Commons Attribution 4.0 International
  • Код: Ліцензія MIT

Використання навичок безкоштовно.

Обмеження

  • Навички потребують доступу до мережі для отримання документації з Microsoft Learn. Без доступу до мережі навички надають кураторські індекси посилань, але не можуть отримати повний контент.
  • Каталог навичок наразі охоплює 193 сервіси Azure. Покриття розширюється з кожним запуском конвеєра, оскільки публікується нова документація.
  • Навички генеруються з публічно доступної документації Microsoft Learn. Контент навчальних модулів, навчальних шляхів та курсів під керівництвом викладачів наразі не включений.
  • Генераційний конвеєр працює поступово. Може бути коротка затримка між оновленнями документації Microsoft Learn і відповідними оновленнями навичок.

Надання відгуку

  • GitHub Проблеми: https://github.com/MicrosoftDocs/agent-skills/issues (переважно для багів, прогалин або запитів на функції)
  • Внески: Репозиторій приймає pull requests. Дивіться керівництво щодо внесків у README.

Наступні кроки

  • Last updated on