Azure SRE Agent 向けの Azure MCP サーバー ツール

Azure MCP Server は、自然言語プロンプトを使用して、activate、add、apply、create、deactivate、delete、generate、get、investigate、kusto、list、mcp、message、pagerduty、pause、plan、reindex、resume、search、servicenow、test、validate、yolo などを含む Azure SRE Agent リソースを管理するのに役立ちます。

Azure SRE Agent は、チームが運用環境の問題を診断して解決し、運用上の問題を減らし、平均解決時間 (MTTR) を短縮するのに役立つ、AI を利用した信頼性アシスタントです。 詳細については、Azure SRE エージェントのドキュメントを参照してください。

ツール パラメーター: Azure MCP Server ツールは、タスクを完了するために必要なデータのパラメーターを定義します。 これらのパラメーターの一部は、各ツールに固有であり、ここに記載されています。 その他のパラメーターはグローバルであり、すべてのツールで共有されます。 詳細については、「 ツールパラメーター」を参照してください。

エージェント: サブエージェントを作成または更新する

このツールは、ターゲット SRE エージェント リソースのサブエージェントを作成または更新します。 サブエージェントを識別するサブスクリプション、エージェント、および名前を指定します。 このツールは、変更をべき等的に適用するため、同じ値を持つ要求を繰り返しても重複は作成されません。 サブエージェントを作成または更新するために必要なパラメーターを指定します。

プロンプトの例を次に示します。

  • "SRE エージェント 'sre-agent-prod' に名前 'subagent-01' を持つサブエージェントを作成します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
氏名 必須 SRE エージェント アイテムの名前。
説明 Optional SRE Agent アイテムの説明。
手順 Optional サブエージェント向けの指示。
ツール Optional 添付するツール名。 複数の値がサポートされています。
ハンドオフ Optional サブエージェントの引き継ぎ先の名前。 複数の値がサポートされています。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

エージェント: サブエージェントを削除する

このツールは、対象の SRE エージェント リソースからサブエージェントを削除します。

プロンプトの例を次に示します。

  • "'true' で確定されているサブスクリプション '12345-abcde' の SRE Agent 'prod-sre' から 'telemetry-agent' という名前のサブエージェントを削除します。"
  • confirm を 'true' にして、サブスクリプション 'my-subscription-id' の SRE エージェント 'staging-sre' からサブエージェント 'backup-monitor' を削除します。
  • "'true' を確認して SRE エージェント 'sre-agent-prod' からサブエージェント名 'subagent-01' を削除します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
氏名 必須 SRE エージェント アイテムの名前。
確認 必須 破壊的な操作の確認

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

エージェント: 構成の詳細を取得する

名前付き SRE エージェントの構成の詳細を表示します。 このツールは、指定された SRE エージェントのエンドポイント、プロビジョニング状態、場所、設定を返します。 リソース グループで結果をフィルター処理できます。

プロンプトの例を次に示します。

  • "リソース グループ 'rg-sre-prod' の SRE エージェント 'sre-agent-north' の詳細を表示します。"
  • "リソース グループ 'prod-rg' の SRE エージェント 'sre-agent-eastus' の構成を確認します。"
  • "指定したサブスクリプション全体の SRE エージェント 'ops-agent-west' のエンドポイントとプロビジョニング状態を表示します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

エージェント: リソースを一覧表示する

このツールは、Azure SRE Agent のリソースを一覧表示します。 リソース グループで結果をフィルター処理できます。 各結果には、 nameidlocationresourceGroupprovisioningState、および endpointが含まれます。 ツールで SRE エージェント リソースが見つからない場合は、空のリストが返されます。

プロンプトの例を次に示します。

  • 自分のサブスクリプション内の Azure SRE Agent リソースを一覧表示して。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

エージェント ツール: カスタム ツールを作成または更新する

このツールは、ターゲット SRE エージェント リソースのカスタム ツールを作成または更新します。 エージェント、名前、およびツールの種類を指定します。 指定した名前のツールが存在する場合、このツールは構成を更新します。それ以外の場合は、新しいツールが作成されます。 パラメーター テーブルに従って構成値を指定します。

プロンプトの例を次に示します。

  • "ツールの種類が 'collector' に設定されているサブスクリプション 'contoso-sub' にあるエージェント 'sre-agent-prod' でカスタム ツール 'log-collector' を作成します。"
  • "SRE エージェント 'sre-agent-prod' で、'custom-kusto-tool' という名前のカスタム ツールを作成します。ツールの種類は 'KustoTool' です。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
氏名 必須 SRE エージェント アイテムの名前。
ツールの種類 必須 KustoTool や LinkTool などのカスタム ツールの種類。
コネクタ Optional Kusto ツールのコネクタ名。
データベース名 Optional Kusto ツール用の Kusto データベース。
説明 Optional SRE Agent アイテムの説明。
パラメーター Optional ツール パラメーター定義の JSON 配列。
Query Optional Kusto ツール用の Kusto クエリ。
URL テンプレート Optional リンク ツールの URL テンプレート。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

エージェント ツール: カスタム ツール定義を取得する

対象の SRE エージェント リソースからカスタム ツール定義を取得します。 このツールでは、エージェントと名前のパラメーターが必要であり、指定されたエージェントと名前のカスタム ツール定義が返されます。

プロンプトの例を次に示します。

  • "SRE エージェント 'sre-agent-prod' からカスタム ツール名 'deploy-helper' の定義を取得します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
氏名 必須 SRE エージェント アイテムの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

エージェント ツール: ツールの一覧表示

このツールは、対象の SRE エージェント リソースのカスタム ツールを一覧表示します。 各カスタム ツールの名前、バージョン、および状態が返されるため、デプロイを確認し、問題をトラブルシューティングできます。

プロンプトの例を次に示します。

  • "SRE エージェント 'sre-agent-prod' のカスタム ツールを一覧表示します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

アーキテクチャ: アーキテクチャを計画する

サイト信頼性エンジニアリング (SRE) エージェント アーキテクチャを計画して生成します。 このツールは、要件を分析し、エージェント、ツール、コネクタ、トリガーの構造化された設計を生成します。 高レベルの要件と制約を提供すると、このツールはコンポーネントの責任、相互作用パターン、デプロイに関する考慮事項、セキュリティとアクセス制御の推奨事項、監視の提案を返します。 出力を使用して、実装、ツールの選択、統合計画をガイドします。

出力には次のものが含まれます。

  • 責任と境界を持つコンポーネント リスト。
  • 統合用のコネクタとトリガーの定義。
  • デプロイとスケーラビリティに関する考慮事項 (リージョンとオーケストレーションの推奨事項を含む)。
  • セキュリティとロールベースのアクセス制御 (RBAC) のガイダンス。
  • 監視とアラートの提案を含む、可観測性とインシデント対応のパターン。

プロンプトの例を次に示します。

  • ""自動インシデント トリアージと Kusto 統合を使用したマルチテナント可観測性" 要件の SRE エージェント アーキテクチャを計画します。"
パラメーター 必須またはオプション Description
必要条件 必須 アーキテクチャの要件。
Kusto コネクタ Optional Kusto コネクタの名前。
トリガーの種類 Optional トリガーの種類 (手動やスケジュールなど)。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

一般的なプロンプト: プロンプトを作成または更新する

このツールは、SRE エージェントで名前付き共通プロンプトを作成または更新します。 再利用可能なプロンプト テンプレートが保存されるため、チームはガイダンスを一元化し、重複を減らすことができます。 ツールは、作成または更新されたプロンプト オブジェクトを返します。

プロンプトの例を次に示します。

  • "SRE Agent 'sre-agent-prod' で、名前が 'restart-service' の共通プロンプトとコンテンツ 'Describe how to restart the app service during an incident' を作成します。"
パラメーター 必須またはオプション Description
コンテンツ 必須 プロンプトの内容。
氏名 必須 SRE エージェント アイテムの名前。
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

一般的なプロンプト: プロンプトを削除する

このツールは、名前で識別されたプロンプトを SRE エージェントから完全に削除します。 ツールがプロンプト定義を消去する前に、削除を確認します。 このアクションは、元に戻すことはできません。

プロンプトの例を次に示します。

  • confirm を 'true' にして、SRE エージェント 'sre-agent-westus' から共通プロンプト名 'cpu-throttle-guidance' を完全に削除してください。
パラメーター 必須またはオプション Description
氏名 必須 SRE エージェント アイテムの名前。
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
確認 必須 破壊的な操作の確認

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

一般的なプロンプト: プロンプト テキストを取得する

このツールは、サイト信頼性エンジニアリング (SRE) エージェント上の特定の名前付き共通プロンプトの全文を表示します。 名前を指定すると、このツールはプロンプト テキストを返して、デバッグまたはレビューのプロンプトを検査または監査できるようにします。

プロンプトの例を次に示します。

  • "SRE エージェント 'sre-agent-westus' の "deploy-checklist" という名前の共通プロンプトを表示してください。"
パラメーター 必須またはオプション Description
氏名 必須 SRE エージェント アイテムの名前。
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

一般的なプロンプト: プロンプトを一覧表示する

このツールは、SRE エージェントで使用可能なすべての一般的なプロンプトを一覧表示します。 登録されたプロンプト名と説明のコレクションを返します。 結果は、使用可能なプロンプトを検出し、その説明を確認するのに役立ちます。

プロンプトの例を次に示します。

  • "SRE エージェント 'sre-agent-prod' の一般的なプロンプトを一覧表示します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
検索 Optional オプションの検索フィルター。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

コネクタ: Kusto コネクタを作成または更新する

このツールは、Azure SRE エージェント リソースの Azure Data Explorer (Kusto) にコネクタを作成または更新します。 コネクタを使用すると、エージェントはAzure Data Explorer クラスターからデータを取り込み、クエリを実行できます。

プロンプトの例を次に示します。

  • "クラスター URL 'https://my-resource.eastus.kusto.windows.net' と名前 'kusto-connector-prod' を使用して SRE エージェント 'sre-agent-01' に Kusto コネクタを作成します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
クラスター URL 必須 Azure Data Explorer クラスターの URL。
氏名 必須 SRE エージェント アイテムの名前。
データベース名 Optional Kusto ツール用の Kusto データベース。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

コネクタ: コネクタを作成または更新する

このツールは、Azure SRE エージェント リソースのコネクタを作成または更新します。 エージェント、コネクタ名、コネクタの種類を指定します。 接続資格情報と追加の構成設定を指定することもできます。 成功すると、このツールはコネクタ リソースを返します。

リソース名Azure名前付け規則に従い、ロールベースのアクセス制御 (RBAC) アクセス許可でコネクタの更新が許可されていることを確認します。 エージェントの sre-agent-prod やリソース グループの rg-sre-prod など、現実的な名前を使用します。

プロンプトの例を次に示します。

  • "'mcp-connector' という名前の SRE エージェント 'sreagent-prod' に MCP コネクタを作成し、「http」と入力します。
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
氏名 必須 SRE エージェント アイテムの名前。
タイプ 必須 MCP コネクタの種類: stdio または http。
引数 Optional stdio MCP コネクタの引数。
認証の種類 Optional HTTP MCP コネクタの認証の種類。
ベアラートークン環境 Optional ベアラー トークンを含む環境変数。
命令 Optional stdio MCP コネクタのコマンド。
エンドポイント Optional HTTP MCP コネクタ エンドポイント。
Envs JSON Optional stdio MCP コネクタの環境変数の JSON オブジェクト。
ヘッダー JSON Optional HTTP ヘッダーの JSON オブジェクト。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

コネクタ: コネクタを削除する

このツールは、Azure SRE エージェント リソースからコネクタを削除します。

プロンプトの例を次に示します。

  • "'true' を確認して SRE エージェント 'sre-agent-prod' からコネクタ 'metrics-collector' を削除します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
氏名 必須 SRE エージェント アイテムの名前。
確認 必須 破壊的な操作の確認

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

コネクタ: コネクタの詳細を取得する

このツールは、Azure SRE エージェント リソースで構成するコネクタの詳細を取得します。 コネクタのプロパティ、構成、状態を表示して、コネクタのトラブルシューティングや文書化に役立てることができます。 エージェントと名前のパラメーターを指定して、Azure SRE エージェント リソースとコネクタを識別します。

プロンプトの例を次に示します。

  • "SRE エージェント 'sre-agent-prod' のコネクタ 'github-connector' の詳細を表示します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
氏名 必須 SRE エージェント アイテムの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

コネクタ: コネクタを一覧表示する

このツールは、Azure SRE エージェント リソースで構成するコネクタを一覧表示します。 コネクタ名、コネクタの種類、登録状態が返されるため、統合を確認して問題のトラブルシューティングを行うことができます。

プロンプトの例を次に示します。

  • "SRE エージェント 'sreagent-prod' で構成されているコネクタを一覧表示します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

コネクタ: テスト コネクタ

このツールはコネクタをテストし、コネクタが公開するツールを一覧表示します。 コネクタの接続を確認し、使用可能なツール (各ツールの名前と機能を含む) を調べることができます。 コネクタをテストするには、エージェントと名前のパラメーターを指定します。

プロンプトの例を次に示します。

  • SRE エージェント 'sre-agent-prod' でコネクタ名 'my-connector' をテストし、そのツールを一覧表示します。
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
氏名 必須 SRE エージェント アイテムの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

ドキュメント: リファレンス ドキュメントを取得する

このツールは、サイト信頼性エンジニアリング (SRE) エージェントの概念に関するリファレンス ドキュメントを返します。 アラート、インシデント対応、正常性チェック、テレメトリなど、SRE エージェントのトピックの定義、構成の詳細、使用例を取得できます。 トピックの参照エントリを取得するトピックを指定します。

プロンプトの例を次に示します。

  • "トピック 'incident-response' の SRE エージェントのドキュメントを表示してください。"
パラメーター 必須またはオプション Description
Topic 必須 ドキュメントのトピック。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

ドキュメント メモリ: ナレッジ ベースにドキュメントを追加する

このツールは、名前によって SRE エージェント ナレッジ ベースにドキュメントを追加します。 マークダウン (*.md) コンテンツをアップロードすると、ツールによってインデックスが作成され、検索拡張生成 (RAG) ベースのナレッジ取得が行われます。 わかりやすい名前を使用して、ドキュメントを簡単に見つけることができます。

プロンプトの例を次に示します。

  • 'SRE エージェントのナレッジベースに、「インシデント対応手順書: サービス停止を一次切り分けし、オンコール担当者に連絡する手順」という内容の「incident-runbook」という名前のドキュメントを追加してください。'
パラメーター 必須またはオプション Description
コンテンツ 必須 ナレッジ ベースに追加するドキュメント コンテンツ。
氏名 必須 SRE エージェント アイテムの名前。
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

ドキュメント メモリ: ナレッジ ベース ドキュメントを削除する

名前でドキュメントを指定します。 このツールは、確認後にナレッジ ベース ドキュメントを削除します。 削除は永続的であり、元に戻すことはできません。 このツールを実行する前に、ドキュメントが存在するかどうかを確認します。

プロンプトの例を次に示します。

  • "'true' を確認して、SRE エージェント 'sre-agent-westus' からナレッジ ベース ドキュメント名 'sre-kb-doc-01' を削除します。"
パラメーター 必須またはオプション Description
氏名 必須 SRE エージェント アイテムの名前。
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
確認 必須 破壊的な操作の確認

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

ドキュメント メモリ: インデックス付きナレッジ ベース ドキュメントを一覧表示する

このツールは、SRE エージェントがメモリに格納するすべてのインデックス付きナレッジ ベース ドキュメントを一覧表示します。 検索フィルターやクエリを使用せず、すべてのドキュメント名とそのメタデータを返します。 完全なナレッジ ベースを参照すると、対象の検索を実行する前に、使用可能なドキュメントを見つけるのに役立ちます。

プロンプトの例を次に示します。

  • "フィルター処理を行わずに、SRE エージェント 'sre-agent-prod' メモリに格納されているすべてのインデックス付きナレッジ ベース ドキュメントの完全な一覧を取得します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

ドキュメントメモリ: ナレッジ ベースのインデックスを再作成する

このツールは、ナレッジ ベースのインデックス再作成をトリガーします。 これを使用して、保存されたドキュメントの再処理、埋め込みの更新、検索インデックスの再構築を行い、検索結果に最近のコンテンツとメタデータの変更が反映されるようにします。 インデックスの再作成時間は、データセットのサイズとサーバーの負荷によって異なります。 数分以上かかる場合があります。 ツールが起動したら、サーバーの管理エンドポイントを使用してインデックス再作成の進行状況を監視します。

プロンプトの例を次に示します。

  • "SRE エージェント 'sre-agent-westus' のナレッジ ベース ドキュメントのインデックスを再作成します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

ドキュメントメモリ: 検索ナレッジ ベース

このツールは、セマンティック検索を使用して SRE エージェントナレッジ ベースを検索し、クエリに最も関連するドキュメントを返します。 インシデントやアラートに関連するトラブルシューティング手順、ランブック、事後報告、監視プレイブックを見つけるのに役立ちます。

プロンプトの例を次に示します。

  • "SRE エージェントのナレッジ ベースで 'ディスク IO 待機時間' を検索します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
Query 必須 関連するナレッジ ベース ドキュメントの検索に使用される検索クエリ。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

フック: フックを削除

このツールは、Azure SRE エージェント リソースからフックを削除します。

プロンプトの例を次に示します。

  • confirm に 'true' を指定して、SRE エージェント 'sre-agent-prod' からフック名 'backup-trigger' を削除します。
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
氏名 必須 SRE エージェント アイテムの名前。
確認 必須 破壊的な操作の確認

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

フック: 詳細を取得する

このツールは、Azure SRE エージェント リソースで構成したフックの詳細を返します。 フックの構成を確認し、その現在の状態を確認し、トリガー設定または宛先エンドポイントを確認できます。

プロンプトの例を次に示します。

  • "SRE Agent 'sre-agent-prod' でフック 'deploy-hook' の詳細を表示してください。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
氏名 必須 SRE エージェント アイテムの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

フック: フックを一覧表示する

Azure SRE エージェント リソースに構成されているフックを一覧表示します。 このツールを使用して、指定されたエージェントのフック名、フックの種類、および現在の状態を表示します。 出力を使用して、 Agentに適用されるデプロイ、監視、クリーンアップ フックを検査します。

プロンプトの例を次に示します。

  • "SRE エージェント 'sre-agent-prod' 用に構成されたフックを一覧表示します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

フック: フック スレッドのアクティブ化

このツールは、Azure SRE エージェント リソース上のスレッドのオンデマンド フックをアクティブにします。 フックの構成済みアクションが直ちにトリガーされます。

プロンプトの例を次に示します。

  • "SRE エージェント 'sreagent-prod' のスレッド 'thread-42' でフック 'health-check' をアクティブにします。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
フック名 必須 フック名。
スレッド ID 必須 SRE エージェントのスレッド ID。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

フック: フック スレッドを非アクティブ化する

このツールは、Azure SRE エージェント リソース上のスレッドのオンデマンド フックを非アクティブ化します。 フックとターゲット のスレッドを識別するために、エージェント、フック名、およびスレッド ID を指定します。 ツールは、フック構成を削除せずに、指定されたスレッドでフックの実行を停止します。 変更を適用するには、Azure SRE エージェント リソースに対する適切なアクセス許可が必要です。

プロンプトの例を次に示します。

  • "SRE エージェント 'sre-agent-prod' のスレッド ID 'thread-7' でフック 'on-demand-restart' を非アクティブ化します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
フック名 必須 フック名。
スレッド ID 必須 SRE エージェントのスレッド ID。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

フック: フック スレッドの状態を一覧表示する

このツールは、Azure SRE エージェント リソース上のスレッドのフックアクティブ化状態を一覧表示します。 指定したスレッドに対してフックが有効か無効か、保留中かを返します。 結果を使用してフックの構成を確認し、スレッドの動作のトラブルシューティングを行います。

プロンプトの例を次に示します。

  • "SRE エージェント 'sre-agent-prod' のスレッド ID 'thread-42' のフックアクティブ化の状態を一覧表示します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
スレッド ID 必須 SRE エージェントのスレッド ID。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

インシデント: アクティブなインシデントを一覧表示する

このツールは、サイト信頼性エンジニアリング (SRE) エージェントのアクティブなインシデントを一覧表示します。 タイトル、状態、影響を受けるサービス、および調査の詳細を含む、開いているインシデント スレッドが返されます。 出力を使用して、進行中の調査を確認し、影響を受けるサービスを確認します。

プロンプトの例を次に示します。

  • "SRE エージェント 'sre-agent-west' のアクティブなインシデントを一覧表示します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

インシデント: インシデントを作成する

このツールを使用して、エージェントのインシデント調査スレッドを作成します。 インシデントの詳細をログに記録し、影響を受けるサービスを関連付け、重大度を設定して対応の優先順位を付けることができます。 このツールを実行するときに、インシデントの説明、サービス、重大度、およびタイトルを指定します。

プロンプトの例を次に示します。

  • タイトル「データベースレイテンシの急増」、説明「SQL読み取りで高いレイテンシを確認」、サービス「payments-api, auth-service」、重大度「high」、エージェント「sre-agent-westus」でインシデントを作成してください。
パラメーター 必須またはオプション Description
説明 必須 SRE Agent アイテムの説明。
サービス 必須 影響を受けるサービス名。
重症度 必須 インシデントの重大度: 重大、高、中、低。
タイトル 必須 インシデントのタイトル。
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

インシデント: 計画を作成する

このツールは、フィルターを使用してインシデントのスコープを設定し、ハンドラーを使用して対応手順を定義するインシデント対応計画を作成して有効にします。 プラン メタデータ、監視するサービス、重大度、応答ステップ、トリガー条件を指定します。 このツールは入力を検証し、一致したインシデントの処理を開始するようにプランをアクティブにします。

プロンプトの例を次に示します。

  • "インシデント応答プラン名 'db-failover-plan' サービス 'payments-api' 重大度 'critical' 手順 'notify on-call;run db failover' Trigger condition 'database connection lost' を作成して有効にします。"
パラメーター 必須またはオプション Description
氏名 必須 SRE エージェント アイテムの名前。
サービス 必須 影響を受けるサービス名。
重症度 必須 インシデントの重大度: 重大、高、中、低。
手順 必須 インシデント対応手順。
トリガーの条件 必須 インシデント対応計画をトリガーするテキスト。
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
エージェント モード Optional エージェント モード: 自律またはレビュー。
エスカレーション Optional エスカレーション手順。
Runbook URL Optional ランブック URL。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

インシデント: プランを一覧表示する

このツールは、SRE エージェントで構成されたインシデント対応計画を一覧表示します。 各プランの名前、ID、および状態を表示できます。 この情報は、アクティブなプランを特定し、その構成を確認するのに役立ちます。

プロンプトの例を次に示します。

  • "SRE エージェント 'sre-agent-prod' で構成されたインシデント対応計画を一覧表示します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

インシデント: エージェントを PagerDuty に接続する

サイト信頼性エンジニアリング (SRE) エージェントを PagerDuty に接続します。 このツールは、インシデントアラートとインシデント管理を可能にする PagerDuty コネクタを作成します。 コネクタは、環境変数に格納されている API キーを使用します。

プロンプトの例を次に示します。

  • "API キー env 'PAGERDUTY_API_KEY' と名前 'pagerduty-connector' を使用して SRE エージェント 'sre-agent-prod' を PagerDuty に接続します。"
パラメーター 必須またはオプション Description
API キー環境 必須 API キーを含む環境変数。
氏名 必須 SRE エージェント アイテムの名前。
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
サブドメイン Optional PagerDuty サブドメイン。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

インシデント: ServiceNow コネクタを設定する

このツールは、インシデント管理の統合を可能にする ServiceNow MCP コネクタを作成します。 環境変数に格納されている資格情報を使用し、ServiceNow と SRE エージェントの間でインシデントの作成、更新、解決を有効にします。

プロンプトの例を次に示します。

  • "認証の種類が 'basic'、インスタンス URL 'https://my-resource.service-now.com'、名前が 'sre-agent-prod' の ServiceNow に SRE エージェントを接続します。"
パラメーター 必須またはオプション Description
認証の種類 必須 HTTP MCP コネクタの認証の種類。
インスタンス URL 必須 ServiceNow インスタンス URL。
氏名 必須 SRE エージェント アイテムの名前。
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
Password env Optional パスワードを含む環境変数。
Token env Optional ベアラー トークンを含む環境変数。
Username env Optional ユーザー名を含む環境変数。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

スケジュールされたタスク: スケジュールされたタスクを作成する

このツールは、SRE エージェントのスケジュールされたタスクを作成します。 cron 式を使用して定義したスケジュールで指定されたメッセージが送信されるため、エージェントは自動化された作業を実行できます。 スケジュールされたタスクを作成するときに、タスクの詳細を指定します。

プロンプトの例を次に示します。

  • "cron 式 '0 9 * * 1' で毎週月曜日に実行される SRE エージェント 'sre-agent-west' で定期的なタスクをスケジュールします。名前は 'weekly-restart'、メッセージ 'Restart service' です。"
パラメーター 必須またはオプション Description
Cron 式 必須 スケジュールの cron 式。
メッセージ 必須 エージェントが定義されたスケジュールで実行されるプロンプト。
氏名 必須 SRE エージェント アイテムの名前。
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
説明 Optional SRE Agent アイテムの説明。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

スケジュールされたタスク: スケジュールされたタスクを削除する

このツールは、SRE エージェントのスケジュールされたタスクを削除します。

プロンプトの例を次に示します。

  • "'true' を確認して、スケジュールされたタスク 'task-12345' を SRE エージェント 'sre-agent-west' から削除します。"
パラメーター 必須またはオプション Description
タスク ID 必須 スケジュールされたタスク ID。
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
確認 必須 破壊的な操作の確認

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

スケジュールされたタスク: スケジュールされたタスクを取得する

このツールは、SRE エージェントのスケジュールされたタスクをタスク ID で取得します。 タスクの構成や現在の状態などの詳細を表示できます。

プロンプトの例を次に示します。

  • "SRE エージェント 'sre-agent-west' のタスク ID 'task-1234' でスケジュールされたタスクを表示します。"
パラメーター 必須またはオプション Description
タスク ID 必須 スケジュールされたタスク ID。
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

スケジュールされたタスク: スケジュールされたタスクを一覧表示する

このツールは、SRE エージェントが管理するスケジュールされたタスクを一覧表示します。 スケジュールされたジョブの検査、スケジュールの確認、状態、次回の実行時、最終実行時などのタスク メタデータの表示を行うことができます。 このツールは、タスク名、状態、スケジュール、次回の実行時刻、最終実行時のフィールドを含む、スケジュールされたタスクの読み取り専用リストを返します。

プロンプトの例を次に示します。

  • "SRE エージェント 'sre-agent-01' のスケジュールされたタスクを一覧表示します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

スケジュールされたタスク: スケジュールされたタスクを一時停止する

サイト信頼性エンジニアリング (SRE) エージェントのスケジュールされたタスクを一時停止します。 このツールは、タスクの更新された状態と関連するメタデータを返します。 メンテナンス中またはトラブルシューティング中に自動アクティビティを一時的に停止するには、スケジュールされたタスクを一時停止します。

プロンプトの例を次に示します。

  • "SRE エージェント 'sre-agent-west' のタスク ID 'task-1234' でスケジュールされたタスクを一時停止します。"
パラメーター 必須またはオプション Description
タスク ID 必須 スケジュールされたタスク ID。
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

スケジュールされたタスク: スケジュールされたタスクを再開する

このツールは、SRE エージェントのスケジュールされたタスクを再開します。 ツールを実行すると、エージェントはスケジュールに従ってスケジュールされたタスクの実行を再開します。

プロンプトの例を次に示します。

  • "SRE エージェント 'sre-agent-west' のタスク ID 'task-123' でスケジュールされたタスクを再開します。"
パラメーター 必須またはオプション Description
タスク ID 必須 スケジュールされたタスク ID。
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

スキル: スキルを作成する

このツールは、対象の SRE エージェント リソースに対してカスタム スキルを作成または更新します。

プロンプトの例を次に示します。

  • "'auto-scale-skill' という名前の新しいスキルを、コンテンツ '{"type":"script","script":"scale.sh"}' で SRE エージェント 'sreagent-prod' に追加します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
コンテンツ 必須 スキルの内容
氏名 必須 SRE エージェント アイテムの名前。
説明 Optional SRE Agent アイテムの説明。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

スキル: スキルを削除する

このツールは、SRE エージェント リソースからカスタム スキルを削除します。

プロンプトの例を次に示します。

  • "'true' に設定された SRE Agent 'sre-agent-west' から 'error-logger' という名前のスキルを削除します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
氏名 必須 SRE エージェント アイテムの名前。
確認 必須 破壊的な操作の確認

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

スキル: スキルを一覧表示する

対象の SRE エージェント リソースのカスタム スキルを一覧表示します。 このツールは、名前、バージョン、状態など、指定された SRE エージェントに登録されている各カスタム スキルの詳細を返します。 出力を使用して、カスタム スキルの構成を確認または監査します。

プロンプトの例を次に示します。

  • "SRE エージェント 'sre-agent-prod' で使用できるすべてのスキルを一覧表示します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

スレッド: スレッドを作成する

このツールは、Site Reliability Engineering (SRE) エージェントに新しいスレッドを作成し、開始メッセージを送信して会話を開始します。 エージェントの最初の応答が返されます。

プロンプトの例を次に示します。

  • "SRE エージェント 'sre-agent-01' で新しいスレッドを開始し、"API ゲートウェイの待機時間の増加を調査する" というメッセージを表示します。"
パラメーター 必須またはオプション Description
メッセージ 必須 送信するメッセージ。
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

スレッド: スレッドの削除

このツールは、サイト信頼性エンジニアリング (SRE) エージェント スレッドを削除します。

プロンプトの例を次に示します。

  • "'true' を確認して SRE エージェント 'sreagent-prod' からスレッド ID 'thread-12345' を削除します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
確認 必須 破壊的な操作の確認
スレッド ID 必須 SRE エージェントのスレッド ID。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

スレッド: メッセージを取得する

このツールは、特定の SRE エージェント スレッドのメッセージを取得し、タイムスタンプや送信者 ID などのメッセージの内容とメタデータを返します。 返されたメッセージを使用して、会話履歴を確認したり、エージェントの動作のトラブルシューティングを行ったりします。

プロンプトの例を次に示します。

  • "SRE エージェント 'sre-agent-prod' のスレッド ID '42' のメッセージを表示します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
スレッド ID 必須 SRE エージェントのスレッド ID。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

スレッド: YOLO モード

このツールは、指定された SRE エージェントの調査を開始し、保留中のすべての承認を付与するため、エージェントは人間の承認ゲートなしで続行されます。 このツールは、調査アクションを記録し、監査の承認を付与します。

プロンプトの例を次に示します。

  • "yolo モードで、SRE Agent 'sre-agent-prod' のメッセージ 'Investigate service crash in frontend' を調査して、すべての保留中の承認を自動で付与します。"
パラメーター 必須またはオプション Description
メッセージ 必須 送信するメッセージ。
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
最大イテレーション数 Optional 自動フォローアップの最大繰り返し回数。
タイムアウト時間 (秒) Optional 調査のタイムアウト時間(秒)

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

スレッド: インシデントを調査する

サイト信頼性エンジニアリング (SRE) エージェントで問題またはインシデントを調査します。 このツールを使用して調査メッセージを送信し、調査が完了するまでエージェントがフォローアップの質問をします。 調査の詳細をメッセージに入力します。 影響を受けるリソース、タイムスタンプ、エラー メッセージ、最近の構成の変更、再現手順など、関連するコンテキストを含めます。 メッセージを簡潔にし、集中して、エージェントがより効率的に解決できるようにします。

プロンプトの例を次に示します。

  • "SRE エージェント 'sre-agent-prod' に関する次の問題を調査します。"デプロイ後にプライマリ API から 500 エラーが返される" というメッセージが表示されます。"
パラメーター 必須またはオプション Description
メッセージ 必須 送信するメッセージ。
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
最大イテレーション数 Optional 自動フォローアップの最大繰り返し回数。
タイムアウト時間 (秒) Optional 調査のタイムアウト時間(秒)

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

スレッド: エージェント チャット スレッドを一覧表示する

このツールは、SRE エージェントのチャット スレッドを一覧表示します。 スレッド ID、参加者、メタデータ、および最新のメッセージを含むスレッド オブジェクトの読み取り専用リストが返されるため、アクティブな会話と過去の会話を確認できます。

プロンプトの例を次に示します。

  • "SRE エージェント 'sreagent-prod' のアクティブなスレッドを一覧表示します。"
パラメーター 必須またはオプション Description
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

スレッド: スレッドにメッセージを送信する

このツールは、既存のサイト信頼性エンジニアリング (SRE) エージェント スレッドにメッセージを送信します。 指定したメッセージをスレッドに投稿し、スレッドの更新された状態を返します。 簡潔なメッセージを使用して、コンテキスト、状態の更新、またはトラブルシューティングのメモを進行中のスレッドに追加します。

プロンプトの例を次に示します。

  • エージェント 'sre-agent-westus' のスレッドID 'thread-12345' にメッセージ '再起動が完了しました。ログを監視しています' を送信してください。
パラメーター 必須またはオプション Description
メッセージ 必須 送信するメッセージ。
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。
スレッド ID 必須 SRE エージェントのスレッド ID。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

ワークフロー: ワークフローを適用して展開する

YAML ワークフローを適用して SRE エージェントにデプロイします。 このツールは、指定された SRE エージェント リソースで ExtendedAgent または ExtendedAgentTool YAML 構成をアップロードしてアクティブ化します。

プロンプトの例を次に示します。

  • 内容が 'apiVersion: sre/v1\nkind: ExtendedAgent\nmetadata:\n name: deploy-workflow' のワークフロー YAML を、SRE エージェント 'sre-agent-prod' に適用します。
パラメーター 必須またはオプション Description
YAML コンテンツ 必須 YAML コンテンツ。
Agent 必須 ターゲットAzure SRE エージェント リソースの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

ワークフロー: ワークフロー定義を生成する

名前付きサイト信頼性エンジニアリング (SRE) エージェント ツールまたはエージェントの YAML ワークフロー定義を生成します。 このツールは、 ExtendedAgentKustoTool、および LinkTool リソースに対して検証済みの YAML 構成を作成します。 生成されたワークフローは、環境間で一貫して SRE エージェント ツールをデプロイおよび管理するのに役立ちます。

プロンプトの例を次に示します。

  • description が「インシデント検索用の Kusto クエリ ツール」、kind が「tool」、name が「kusto-search-tool」の YAML ワークフローを生成してください。
パラメーター 必須またはオプション Description
説明 必須 SRE Agent アイテムの説明。
Kind 必須 YAML の種類: エージェントまたはツール。
氏名 必須 SRE エージェント アイテムの名前。
コネクタ Optional Kusto ツールのコネクタ名。
データベース名 Optional Kusto ツール用の Kusto データベース。
モデルまたは型 Optional KustoTool や LinkTool などのツールの種類。
パラメーター Optional name:description としてのパラメーター。
Query Optional Kusto ツール用の Kusto クエリ。
ツール Optional 添付するツール名。 複数の値がサポートされています。
ハンドオフ Optional サブエージェントへのハンドオフ名。 複数の値がサポートされています。
URL テンプレート Optional リンク ツールの URL テンプレート。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

ワークフロー: ワークフローを検証する

このツールは、SRE エージェント ワークフロー YAML を検証し、構造と構文の一般的な問題にフラグを設定します。 無効な YAML、形式が正しくない手順、正しくない run 文字列、および必要なキーがないかどうかを確認します。 YAML contentを指定すると、ツールは、行番号と推奨される修正プログラムで識別された問題を返します。 ツールで検出される一般的なエラーについては、次の例を参照してください。

プロンプトの例を次に示します。

  • 次の SRE Agent ワークフロー YAML コンテンツ 'apiVersion: sre/v1\nkind: ExtendedAgent\nmetadata:\n name: deploy-workflow' を検証してください。
パラメーター 必須またはオプション Description
YAML コンテンツ 必須 YAML コンテンツ。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須