次の方法で共有


Azureエージェントスキル

Azure エージェント スキルは、Azure開発のための AI 読み取り可能スキルの Microsoft が作成したファースト パーティのカタログです。 各スキルは、信頼できる Microsoft Learn コンテンツの構造化インデックスであり、AI コーディング アシスタントがそれを検出して使用して、Azure サービスに関する正確な up-to-date ガイダンスを提供できるようにパッケージ化されています。

スキルは、Agent Skills open standard に従い、GitHub Copilot、Claude Code、Cursor、Gemini CLI、Codex CLI などの互換性のある AI コーディング アシスタントと連携します。

活用事例

  • AI コーディング アシスタントに、公式ドキュメントに記載されている専門家レベルのAzureガイダンスを提供する
  • Azure開発タスクのエージェント応答の精度と完全性を向上させる
  • 開発者がベスト プラクティス、フローのトラブルシューティング、アーキテクチャ パターン、セキュリティ ガイダンスをエディターで直接取得できるようにする
  • MCPサーバーなどのライブデータツールを補完するために、最新の構造化された知識を提供します。

エージェント スキルのしくみ

エージェント スキルは、ファイル システム ベースの軽量の機能モジュールです。 各スキルは、YAML frontmatter (名前、説明、互換性) とカテゴリ (トラブルシューティング、ベスト プラクティス、アーキテクチャ、セキュリティ、構成など) 別に整理された構造化コンテンツを含む ファイルを含むフォルダーです。

スキルは、漸進的な表示を利用して、コンテンツを効率的に読み込みます。

  1. 検出 — AI アシスタントは、スキルの と を YAML frontmatter から読み取り、関連性を判断します
  2. 手順 — トリガーされると、アシスタントは完全な コンテンツを読み込みます。このコンテンツには、トピック別に整理されたドキュメント リンクが含まれます。
  3. Fetch — アシスタントは、 Learn MCP サーバー または Web フェッチ ツールを使用して Microsoft Learn から最新のコンテンツを取得します

このアーキテクチャでは 、ナレッジ インデックス (検索する内容とタイミング) を コンテンツ配信 (クエリ時に最新のドキュメントをフェッチ) から分離し、ドキュメントの進化に合わせ、スキルを最新の状態に保ちます。

スキル カタログは、製品ドキュメントAzureスキャンし、価値の高い手続き型コンテンツと意思決定コンテンツを識別し、構造化されたスキル ファイルに変換する専用のパイプラインによって自動的に生成および管理されます。 パイプラインは、アップストリーム コンテンツの変更を継続的に評価し、増分更新を生成します。

スキル カタログ

リポジトリには、193 スキルが含まれています。これらのカテゴリにわたるAzureのコア サービスをカバーします。

カテゴリ スキル 例示
インフラストラクチャと管理 二十七 Azure Resource Manager、バックアップ、監視、ポリシー、コスト管理、Arc
専門的な 二十七 Quantum、Maps、VMware Solution、SAP、Health Data Services、Virtual Desktop
ネットワーク 24 Virtual Network、Front Door、Firewall、VPN Gateway、ExpressRoute、Load Balancer
AI と ML 20 AI サービス、Machine Learning、ドキュメント インテリジェンス、音声、Bot Service
データと分析 20 Cosmos DB、SQL Database、Data Factory、Synapse Analytics、Databricks
セキュリティと ID 17 Key Vault、RBAC、Sentinel、Defender for Cloud、Confidential Computing
DevOps 14 Azure DevOps、パイプライン、コンテナー レジストリ、デプロイ環境、Dev Box
Compute 13 Functions、Container Apps、Virtual Machines、Kubernetes Service、App Service
Integration 12 Logic Apps、API Management、Event Grid、Service Bus、Event Hubs
Storage 9 Blob Storage、Files、Elastic SAN、NetApp Files、Container Storage
IoT と Edge 7 IoT Hub、IoT Central、IoT Edge、IoT Operations、Digital Twins

ロールベースの キュレーションされたバンドル は、一般的なシナリオ (Essentials、Infrastructure、Data Engineering、AI/ML、Security、DevOps) で使用できます。

完全なスキル カタログは docs/CATALOG.md で入手できます。

Requirements

  • ネットワーク アクセス が必要です。 スキルは、AI アシスタントがクエリ時にフェッチする Microsoft Learn ドキュメント URL を参照します。
  • Agent Skills オープン標準 ( 形式) をサポートする互換性のある AI コーディング アシスタント。
  • 推奨: 最適なドキュメントを取得するための Microsoft Learn MCP サーバー 。 Learn MCP サーバーを使用できない場合、スキルはほとんどの AI アシスタントに組み込まれている Web フェッチ機能にフォールバックします。

スキル自体を使用するために認証は必要ありません。 スキルは、開発環境でローカルに実行される静的ファイルです。

作業の開始

インストール作業

  1. リポジトリを複製します。

    git clone https://github.com/MicrosoftDocs/agent-skills.git
    
  2. から AI アシスタントのスキル ディレクトリにスキル フォルダーをコピーします。

    AI アシスタント プロジェクト レベルのパス グローバル パス
    GitHub Copilot {project}/.github/skills/ ~/.copilot/skills/
    Claude Code {project}/.claude/skills/ ~/.claude/skills/
    Codex CLI {project}/.codex/skills/ ~/.codex/skills/
    カーソル {project}/.cursor/skills/
    Gemini CLI {project}/.gemini/skills/

    Important

    フォルダー自体ではなく内のフォルダー (、など) をコピーします。

  3. VS Code ユーザー: チャットを有効にする: [設定] で エージェント スキル () を使用します。

  4. Azure の AI アシスタントに質問を始めてください。 スキルはクエリに基づいて自動的にアクティブ化されます。

使用方法

インストールしたら、AI アシスタントに自然に質問します。

  • "Durable Functionsを用いてAzure Functionsをセットアップする手伝いをしてください"
  • "Azure Container Appsのベスト プラクティスは何ですか?"
  • ストレージアカウントでスロットリングエラーが発生しています。これを診断するにはどうすればよいですか?

アシスタントは、関連するスキルを自動的に検出し、構造化されたガイダンスを読み込み、Microsoft Learn から最新のドキュメントを取得して、正確で根拠のある回答を提供します。

Compatibility

これらのスキルは、 エージェント スキル仕様をサポートする AI コーディング アシスタントと連携します。

AI コーディング アシスタント タイプ スキルの道
GitHub Copilot VS Code 拡張機能 .github/skills/
Claude Code Anthropic CLI .claude/skills/
Codex CLI OpenAI CLI .codex/skills/
カーソル AI対応IDE .cursor/skills/
Gemini CLI Google DeepMind .gemini/skills/
Antigravity IDE DeepMind IDE .agent/skills/
OpenCode オープン ソース CLI .agent/skills/

Learn MCP サーバーとの関係

エージェント スキルと Learn MCP サーバー は補完的です。

  • Learn MCP Server には、Microsoft Learn コンテンツに対する検索、フェッチ、コード サンプルの取得などの ツール が用意されています
  • エージェント スキル は 知識 を提供します。 何 を検索し、 いつ、 どのように 適用するかに関する構造化されたガイダンス

スキルは、Learn MCP サーバー (または同等のフェッチ機能) をコンテンツ配信メカニズムとして使用します。 AIアシスタントによって、関連性のある内容を特定する判断力と最新の信頼性のあるコンテンツを取得する能力が組み合わされます。

可用性と料金

Azure エージェント スキルは、デュアル ライセンスでオープンソース リポジトリとして一般公開されています。

  • ドキュメント コンテンツ: Creative Commons Attribution 4.0 International
  • コード: MIT ライセンス

スキルを使用する料金はかかりません。

制限事項

  • スキルでは、Microsoft Learn からドキュメントを取得するためにネットワーク アクセスが必要です。 ネットワーク アクセスがないと、スキルはキュレーションされたリンク インデックスを提供しますが、完全なコンテンツを取得することはできません。
  • スキル カタログには現在、193 Azure サービスが含まれます。 新しいドキュメントが発行されると、パイプラインが実行されるごとにカバレッジが拡大し続けます。
  • スキルは、一般公開されている Microsoft Learn ドキュメントから生成されます。 現時点では、トレーニング モジュール、ラーニング パス、インストラクター主導のコースのコンテンツは含まれていません。
  • 生成パイプラインは段階的に実行されます。 Microsoft Learn のドキュメント更新と対応するスキル更新プログラムの間には、少し時間がかかる場合があります。

フィードバックの提供方法

次のステップ