SRE エージェントAzureは、チームがシステムのトラブルシューティングに使用するのと同じコンテキストを使用できる場合に、より効果的です。 調査時にゼロから始めることなくエージェントが参照できるよう、ランブック、ドキュメント、Webページ、リポジトリを連携します。
ヒント
- Builder > ナレッジ ベースを使用して、ファイル、Web ページ、リポジトリを 1 か所で管理します。
- インデックス付きナレッジは、調査とチャット中に自動的に使用できます。
- ドキュメントを直接アップロードしたり、チャットにファイルを添付したり、ソース対応分析のためにリポジトリを接続したりできます。
- 最も役に立つナレッジ ソースは、Runbook、アーキテクチャ ノート、トラブルシューティング ガイド、ソース コードなど、チームが既に依存しているナレッジ ソースです。
知識が重要な理由
エージェントには、監視ツールと接続されたシステムを通じて、Azure コンテキストが既に組み込まれています。 既定では持っていないのは、チームの内部知識です。 その知識には、一般的な復旧手順を説明する Runbook、共有依存関係を識別するアーキテクチャ ノート、または回帰を導入したデプロイを示すリポジトリが含まれます。
その知識を接続すると、エージェントは次のことができます。
- インシデント発生時にチームのランブックを参照する。
- チームが既に文書化したトラブルシューティング手順を再利用します。
- 症状をソース コードとデプロイ コンテキストと関連付ける。
- 人間が使用するのと同じドキュメントと参照を使用して、質問に回答します。
ナレッジベース内のナレッジを管理する
Builder > ナレッジ ベースを使用して、エージェントのナレッジ ソースを管理します。
このページには、次の各ソースが表示されます。
- 氏名
- ステータス
- Type
- 最終更新日
次の 3 種類のソースを使用できます。
| ソースの種類 | 提供される内容 | 追加する方法 |
|---|---|---|
| ファイル | ランブック、トラブルシューティングガイド、アーキテクチャドキュメント、および参考資料 | ポータルを使用してアップロードするか、チャット中にドキュメントを保存するようにエージェントに依頼する |
| Web ページ | 外部ドキュメント、内部 Wiki URL、およびステータス ページ | エージェントがコンテンツのインデックスを作成できるようにページ URL を追加する |
| リポジトリ | ソース コード、デプロイ ファイル、インフラストラクチャ定義 | GitHubまたはAzure DevOps リポジトリを接続する |
インデックス作成の状態と鮮度を確認する
各ナレッジ ソースには、次のいずれかの状態が表示されます。
| 地位 | Meaning |
|---|---|
| インデックス | コンテンツが処理され、検索可能である |
| Pending | コンテンツはまだ処理中です |
| インデックスが作成されていない | 処理に失敗したか、ソースにインデックスを作成できませんでした |
ソースのインデックスが作成されたら、状態インジケーターの上にマウス ポインターを置くと、タイムスタンプ で作成 済みであることが表示されます。 このタイムスタンプは、最新バージョンの Runbook またはドキュメントが処理されていることを確認する場合に便利です。
ドキュメントのアップロード
今後の会話でナレッジを利用できるようにする場合は、ドキュメントをアップロードします。
一般的な例を次に示します。
- インシデント実行計画書
- エスカレーションガイド
- アーキテクチャリファレンス
- トラブルシューティングのチェックリスト
ポータルを使用してファイルをアップロードすることも、会話のコンテンツをナレッジ ベースに保存するようにエージェントに依頼することもできます。
サポートされているファイル形式と制限については、「 ナレッジ ドキュメントのアップロード」を参照してください。
完全なワークフローについては、「 ナレッジ ドキュメントのアップロード」を参照してください。
チャットでファイルを共有する
1 つの会話でエージェントに即時コンテキストを付与する場合は、チャットの添付ファイルを使用します。 この方法は、スクリーンショット、ログ、構成ファイル、およびアクティブなトラブルシューティングに役立つその他の資料に役立ちます。
ヒント
チャットに添付するファイルが長期的な知識になる必要がある場合は、エージェントにナレッジ設定に保存するように依頼します。 エージェントはコピーをアップロードして、コンテンツがインデックス付けされ、後の会話で検索できるようにすることができます。
次の表は、長期的な知識のアップロードと一時的なチャットの添付ファイルを比較しています。
| Scenario | ナレッジ ベースへのアップロード | チャットで共有する |
|---|---|---|
| 最適な用途 | 今後の会話で参照できるようにしておきたいランブック、手順書、文書 | エージェントに今すぐ分析させるファイル |
| ストレージ スコープ | エージェント レベルで、今後の会話で検索可能 | スレッド レベルで、現在の会話で使用できる |
| 追加する方法 | ポータルでアップロードするか、エージェントにコンテンツの保存を依頼する | ドラッグ アンド ドロップ、クリップボードからの貼り付け、チャットでの + の使用 |
| 長期的な知識になる可能性があります | すでに蓄積された長期にわたる知識 | はい (エージェントに保存を依頼した場合) |
詳細については、「 チャットでファイルを共有する」を参照してください。
Web ページを追加する
アップロードされたファイルまたはリポジトリの外部に重要なガイダンスが存在する場合は、Web ページを追加します。
適切な候補は次のとおりです。
- 内部 Wiki の記事
- 公開製品ドキュメント
- サービスの状態ページ
- チームが管理する参照ページ
URL を追加すると、エージェントはページ コンテンツのインデックスを作成して、将来の調査中にその情報を参照できるようにします。
リポジトリを接続する
エージェントにソース対応のコンテキストが必要な場合は、GitHubまたはAzure DevOpsリポジトリに接続します。
接続されたリポジトリは、エージェントに役立ちます。
- ソース コードでエラー パターンを検索する
- インシデントと最近のコード変更の関連付け
- リファレンス デプロイメントと構成ファイル
- 根本原因分析中にリポジトリコンテンツを使用する
ソース コードを接続するには、「 ソース コードの接続」を参照してください。
適切なナレッジ ソースを選択する
必要なコンテキストの種類に一致するソースの種類を使用します。
| 接続する必要がある場合... | 用途 |
|---|---|
| ファイルとして保存されているランブックまたはトラブルシューティング ガイド | ナレッジ ドキュメントをアップロードする |
| 1 つのアクティブな調査のスクリーンショット、ログ、またはファイル | チャットでファイルを共有する |
| GitHubまたはAzure DevOps リポジトリ | ソース コードの接続 |
| Datadog や Splunk などの外部システム | MCP コネクタ |