このチュートリアルでは、ドメイン知識とタスク プレイブックをエージェントに追加するカスタム スキルを作成します。 スキルは、特定のサービスのトラブルシューティングや診断手順の実行など、関連する場合にエージェントが自動的に読み込むモジュール型の機能です。
このチュートリアルでは、以下の内容を学習します。
- エージェントキャンバスでスキルを作成する
- SKILL.md でスキル命令を記述する
- サポート ファイルとツールを追加する
- チャットまたはプレイグラウンドでスキルをテストする
- 既存のスキルを編集する
推定時間: 10 分
ヒント
スキルと知識のドキュメントが連携します。 スキルは、エージェントに何かを行う方法 (手順、プレイブック、ステップ バイ ステップの手順) を教えています。 ナレッジ ドキュメントでは、エージェントに知る必要がある内容 (参照データ、アーキテクチャ ドキュメント、Runbook) について説明します。 また、参照ドキュメントをサポート ファイルとしてスキルに直接添付することもできます。 ナレッジのアップロード フローについては、「 ナレッジ ドキュメントのアップロード」を参照してください。
前提条件
開始する前に、以下の前提条件を確認してください。
- Azure SRE エージェント ポータルで作成されたエージェント。
- エンコードするプロシージャまたはドメインの知識を明確に理解している。
エージェントキャンバスへナビゲーション
Agent Canvasを開けて、スキルを作成・管理できます。
- SRE エージェント ポータルを開きます。
- エージェントを選択してください。
- 左側のナビゲーションで [ビルダー ] を選択します。
- [エージェント キャンバス] を選択します。
- + スキルを作成 を選択します。
スキル作成ダイアログが開き、2 列のレイアウトが表示されます。 一方の側のフォーム フィールドと、 SKILL.mdを示すもう一方の側のコード エディター。
名前と説明を入力する
必要なスキル名を入力してください。 エージェントがスキルを使うタイミングを判断するための説明を加えましょう。
| フィールド | 値の例 |
|---|---|
| 名前 (必須) | high-cpu-troubleshooting |
| 説明 (オプション) | "コンテナー アプリでの CPU 使用率が高いアラートのトラブルシューティング手順。 アップストリームの依存関係、接続プール、および最近のデプロイを確認します。 |
名前はスキル全体で一意である必要があります。 説明はスキルの一覧に表示され、エージェントがこのスキルを使用するタイミングを決定するのに役立ちます。
ヒント
編集モードに切り替えるには、説明テキストの横にある [編集] を選択します。 終わったら、保存を選択します。
スキルの手順を記述する
中央のエディターには、スキルの指示を含む 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、シェル スクリプトの構文の強調表示がサポートされています。
ツールの選択
必要に応じて、実行中にスキルが使用するツールをアタッチします。
- [ ツール ] セクションで [ ツール の選択] を選択します。
- ツールを閲覧または検索します。 種類 (カスタム ツール、MCP ツール) でフィルター処理するか、名前で検索します。
- このスキルに必要なツール (
kusto_queryやazure_resource_healthなど) を確認します。 - パネルを閉じます。
選択したツールは、取り外し可能な丸薬として表示されます。 これらのツールは、スキルのアクティブ化時に動的に使用できます。
注
スキルに追加されたツールは、スキルのアクティブ化時に動的に使用できます。 より一貫性のある動作を行う場合は、代わりにサブエージェントでツールを直接構成します。
カスタム ツールを作成するには、「 Kusto ツールの作成 」または 「Python ツールの作成」を参照してください。 ツールの詳細については、「 ツール」を参照してください。
スキルを作成する
[ 作成] を選択してスキルを保存します。
あなたのスキルはエージェントキャンバスに表示されます。 エージェントは、関連する状況が発生したときにスキルを自動的に使用できるようになりました。
スキルのテスト
メイン エージェントは既定でスキルを使用できるため、最初にサブエージェントを作成せずにチャットで直接テストできます。
新しいチャットでテストする
新しいチャット スレッドを使用して、エージェントがスキルをアクティブ化することを確認します。
- サイドバーで [新しいチャット スレッド ] を選択します。
- スキルをトリガーするプロンプトを入力します。 例: "コンテナー アプリに高い CPU が表示されています。調査できますか?
- エージェントがスキルをアクティブ化し、定義した手順に従って実行されていることを確認します。
遊び場でテストする
プレイグラウンドを使用して、サブエージェントを使用してスキルをテストします。
- サブエージェントを作成 し、このスキルを割り当てます。
- Agent Canvasのツールバーで、 Test Playground ビューのトグルを選択してください。
- サブエージェントを選択し、テスト プロンプトを入力して、スキルが正しく使用されていることを確認します。
詳細については、「 エージェントプレイグラウンド」を参照してください。
スキルを編集する
既存のスキルを変更して、指示、ツール、またはサポート ファイルを更新できます。
Agent Canvasでスキルを選択し、その後 編集を選択します。
編集ダイアログが開き、現在のすべての値が事前設定されています。 必要なフィールドを変更します。
変更する内容 更新する場所 エージェントがそれを使用する場合 説明 と SKILL.md の手順 どのような手順に従うか エディター内の SKILL.md の内容 使用可能なツール ツール> ツールの選択 参照データ ファイルの追加、編集、または削除 保存を選びます。
効果的なスキルを書く際のヒント
エージェントが効果的に使用できるスキルを作成するには、次のガイドラインを使用します。
- 使用するタイミングについて具体的に確認します。 エージェントは説明と指示を読み取り、関連性を決定します。
- ステップ バイ ステップの手順を含めます。 番号付きの手順により、エージェントに明確なプレイブックが提供されます。
- 予想される出力を指定します。 結果に必要な形式をエージェントに伝えます。
- 参照データを追加します。 クエリ テンプレート、構成基準、または既知の適切な値をサポート ファイルとしてアップロードします。
- 関連するツールを割り当てます。 スキルに Kusto クエリや Azure アクションなどの特定のツールが必要な場合は、それらを追加します。