チュートリアル: Azure SRE エージェントでスキルを作成する

このチュートリアルでは、ドメイン知識とタスク プレイブックをエージェントに追加するカスタム スキルを作成します。 スキルは、特定のサービスのトラブルシューティングや診断手順の実行など、関連する場合にエージェントが自動的に読み込むモジュール型の機能です。

このチュートリアルでは、以下の内容を学習します。

推定時間: 10 分

前提条件

開始する前に、以下の前提条件を確認してください。

• Azure SRE エージェント ポータルで作成されたエージェント。
• エンコードするプロシージャまたはドメインの知識を明確に理解している。

サブエージェント ビルダーに移動する

スキルを作成および管理するサブエージェント ビルダーを開きます。

1. SRE エージェント ポータルを開きます。
2. エージェントを選択してください。
3. 左側のナビゲーションで [ビルダー ] を選択します。
4. サブエージェント ビルダーを選択します。

スキルの作成を開始する

ツール バーからスキル作成プロセスを開始します。

1. ツール バーの [ 作成 ] ドロップダウンを選択します。
2. [スキル] を選択します。

スキル作成ダイアログが開き、2 列のレイアウトが表示されます。 一方の側のフォーム フィールドと、 SKILL.mdを示すもう一方の側のコード エディター。

名前と説明を入力する

エージェントがこのスキルを使用するタイミングを決定するのに役立つ名前と説明を入力します。

名前はスキル全体で一意である必要があります。 説明はスキルの一覧に表示され、エージェントがこのスキルを使用するタイミングを決定するのに役立ちます。

スキルの手順を記述する

中央のエディターには、スキルの指示を含む SKILL.mdが表示されます。 ファイルは既定のテンプレートで始まります。

---
name:
description:
---

<!-- Add your skill instructions here -->

YAML フロント マター (name、 description、 tools) は、左側のフォーム フィールドと同期したままです。 Markdown の手順をフロントマターの下に記述します。

---
name: high-cpu-troubleshooting
description: Troubleshooting procedure for high CPU alerts on container apps
tools:
  - kusto_query
---

## When to use this skill
Use this skill when you receive a high CPU alert on any container app.

## Steps
1. Check upstream dependencies for cascading failures
2. Query connection pool metrics for the last hour
3. Review deployments in the last 24 hours
4. If a recent deployment correlates with CPU spike, identify the commit
5. Recommend rollback or fix based on findings

## Expected output
Structured report with: affected resource, root cause, recommended action, and evidence.

サポート ファイルを追加する

一方の側の [ファイル ] セクションには、ファイル ブラウザーが表示されます。 既定の SKILL.md以外にも、参照データ、テンプレート、クエリの例を追加できます。

• 新しいファイル アイコンを選択してファイルを追加します。
• 新しいフォルダー アイコンを選択して、ファイルをディレクトリに整理します。
• フォルダーをドロップ ゾーンにドラッグ アンド ドロップするか、[フォルダーの アップロード ] リンクを選択してフォルダー構造全体をアップロードします。

ブラウザーで任意のファイルを選択して、コード エディターで編集します。 エディターでは、Markdown、JSON、YAML、KQL、Python、シェル スクリプトの構文の強調表示がサポートされています。

ツールの選択

必要に応じて、実行中にスキルが使用するツールをアタッチします。

1. [ ツール ] セクションで [ ツール の選択] を選択します。
2. ツールを閲覧または検索します。 種類 (カスタム ツール、MCP ツール) でフィルター処理するか、名前で検索します。
3. このスキルに必要なツール ( kusto_query や azure_resource_healthなど) を確認します。
4. パネルを閉じます。

選択したツールは、取り外し可能な丸薬として表示されます。 これらのツールは、スキルのアクティブ化時に動的に使用できます。

カスタム ツールを作成するには、「 Kusto ツールの作成 」または 「Python ツールの作成」を参照してください。 ツールの詳細については、「 ツール」を参照してください。

スキルを作成する

[ 作成] を選択してスキルを保存します。

サブエージェント ビルダーの [ スキル ] タブにスキルが表示されます。 エージェントは、関連する状況が発生したときにスキルを自動的に使用できるようになりました。

スキルのテスト

メイン エージェントは既定でスキルを使用できるため、最初にサブエージェントを作成せずにチャットで直接テストできます。

新しいチャットでテストする

新しいチャット スレッドを使用して、エージェントがスキルをアクティブ化することを確認します。

1. サイドバーで [新しいチャット スレッド ] を選択します。
2. スキルをトリガーするプロンプトを入力します。 例: "コンテナー アプリに高い CPU が表示されています。調査できますか?
3. エージェントがスキルをアクティブ化し、定義した手順に従って実行されていることを確認します。

遊び場でテストする

プレイグラウンドを使用して、サブエージェントを使用してスキルをテストします。

1. サブエージェントを作成 し、このスキルを割り当てます。
2. サブエージェント ビルダーのツール バーで、[ テスト プレイグラウンド ビュー] トグルを選択します。
3. サブエージェントを選択し、テスト プロンプトを入力して、スキルが正しく使用されていることを確認します。

詳細については、「 エージェントプレイグラウンド」を参照してください。

スキルを編集する

既存のスキルを変更して、指示、ツール、またはサポート ファイルを更新できます。

1. [ スキル ] タブで、スキル名を選択するか、選択して [編集] を選択します。

2. 編集ダイアログが開き、現在のすべての値が事前設定されています。 必要なフィールドを変更します。

   変更する内容	更新する場所
   エージェントがそれを使用する場合	説明 と SKILL.md の手順
   どのような手順に従うか	エディター内の SKILL.md の内容
   使用可能なツール	ツール> ツールの選択
   参照データ	>ファイルの追加、編集、または削除

3. 保存を選びます。

効果的なスキルを書く際のヒント

エージェントが効果的に使用できるスキルを作成するには、次のガイドラインを使用します。

• 使用するタイミングについて具体的に確認します。 エージェントは説明と指示を読み取り、関連性を決定します。
• ステップ バイ ステップの手順を含めます。 番号付きの手順により、エージェントに明確なプレイブックが提供されます。
• 予想される出力を指定します。 結果に必要な形式をエージェントに伝えます。
• 参照データを追加します。 クエリ テンプレート、構成基準、または既知の適切な値をサポート ファイルとしてアップロードします。
• 関連するツールを割り当てます。 スキルに Kusto クエリや Azure アクションなどの特定のツールが必要な場合は、それらを追加します。

次のステップ

関連するコンテンツ

• スキル
• ナレッジ ドキュメントをアップロードする
• サブエージェント
• エージェントプレイグラウンド
• ツール
• Kusto ツールを作成する
• Python ツールを作成する
• スケジュールされたタスクを作成する
• プレイグラウンドでツールをテストする