調査中にエージェントがチームの Runbook と手順を参照できるように、Azure DevOps Wiki を接続します。 Wiki コンテンツはインデックスが作成され検索可能であり、エージェントは適切なページを自動的に検索します。 コネクタでは、マネージド ID と個人用アクセス トークン (PAT) 認証の両方がサポートされます。
問題: インシデント中にナレッジが使用されない
チームは、Azure DevOps Wiki で Runbook、トラブルシューティング ガイド、運用手順の作成に数百時間を費やしています。 しかし、午前 3 時にインシデントが発生すると、誰も Wiki を検索しません。 オンコールエンジニアは、12 個のタブを開き、記憶を頼りに対処するか、エスカレーションするために Azure Monitor をチェックします。 正確にこのような状況のために書かれたドキュメントは手つかずです。
知識が存在します。 問題は Wiki ではなく、実際の問題のコンテキストで適切なタイミングで適切なページにアクセスすることです。
SRE エージェントがこの問題を解決する方法
Azure DevOps Wiki を 1 回接続すると、調査のたびにエージェントによって自動的に検索されます。
- Wiki ページのインデックス作成 - Azure DevOps Wiki のすべてのページのクロールとインデックス作成を行います。
- コンテキストに応じて検索 - 質問やインシデントが発生すると、エージェントは他のナレッジ ソースと共に Wiki を検索します。
- 特定のページを参照 する — 返信には、元の Wiki ページにリンクする引用文献が含まれます。
- 更新プログラムを取得 する - コネクタを再接続または更新して、更新された Wiki コンテンツのインデックスを再作成します。
前後
| シナリオ | の前に |
後の |
|---|---|---|
| インシデント対応 | インシデント中にオンコールユーザーが Wiki を検索しない | エージェントが Wiki をすべてのクエリに対して自動的に検索する |
| 知識アクセス | Wiki の知識が午前 3 時に使用されない | Runbook は、必要なそのタイミングで表示されます |
| オンボーディング | 新しいチーム メンバーが確認する Wiki ページがわからない | エージェントは、エクスペリエンスに関係なく関連するページを検索します |
| 検索品質 | Wiki 検索では、適切なキーワードを知る必要があります | エージェントがコンテキストを理解し、関連するコンテンツを検索する |
これは何が違うのか
静的ファイルのアップロードとは異なり、Wiki は有効なままです。 チームが Azure DevOps で Runbook を更新すると、エージェントが変更を受け取ります。 ファイルを再アップロードする必要はありません。
フルテキスト Wiki 検索とは異なり、エージェントはコンテキストを理解します。 キーワードと一致しません。 代わりに、質問を関連する Wiki コンテンツと関連付け、Azure Monitor のライブ テレメトリ、Kusto のログ、その他の接続されたソースと組み合わせて使用します。
外部 MCP ベースの Wiki アクセスとは異なり、組み込みのドキュメント コネクタには外部サーバーのセットアップは必要ありません。 Wiki の URL と認証を指定すると、エージェントが残りの部分を処理します。
どのように機能するのか
ドキュメント コネクタ (Azure DevOps サービスの種類) は、Wiki ページをクロールし、検索用にインデックスを作成します。 エージェントは、クエリを受け取ると、インデックス付きコンテンツを、アップロードされたファイル、Web ページ、接続されたリポジトリなどの他のナレッジ ソースと共に検索します。
コネクタでは、次の 2 種類の Azure DevOps コンテンツがサポートされています。
| コンテンツ タイプ | URL パターン | インデックスされるもの |
|---|---|---|
| ウィキ | https://dev.azure.com/{org}/{project}/_wiki/wikis/{wiki-name} |
すべての Wiki ページ (Markdown) |
| Wiki（範囲限定） | .../_wiki/wikis/{wiki-name}/{pageId}/Page-Name |
特定のページとそのサブページ |
| Git リポジトリ | https://dev.azure.com/{org}/{project}/_git/{repo} |
テキスト ファイル (Markdown、ドキュメント、コード) |
| レガシー Wiki | https://{org}.visualstudio.com/{project}/_wiki/wikis/{wiki-name} |
上記と同じ (レガシ URL 形式) |
注
Wiki URL にページ ID を含めると、コネクタはそのページとそのサブページにのみインデックスを作成します。 この方法は、wiki 全体のインデックスを作成せずに、 /Operations や /Runbooks などの特定のセクションをターゲットにするのに役立ちます。
ドキュメントの同期のしくみ
接続されると、エージェントはドキュメントインデックスを自動的に最新の状態に保ちます。 手動で何も再アップロードする必要はありません。
| 特徴 | 詳細情報 |
|---|---|
| 同期の頻度 | 24 時間ごとに自動クロール |
| サポートされている形式 |
.md、 .txt、 .rst、 .adoc、 .asciidoc、 .wiki、 .textile、 .org、 .htm、 .html、 .json、 .yaml、 .yml、 .xml、 .csv (15 ファイル形式) |
| インデックス作成プロセス | ドキュメントは、セマンティック検索用に仕分けされ、埋め込み、およびインデックス化されます。 |
| Updates | リポジトリの変更は次の同期サイクルで取得され、手動による操作は必要ありません |
エージェントは、各ドキュメントを意味的に意味のあるチャンクに分割し、ベクター埋め込みを生成し、検索インデックスに格納することで、各ドキュメントを処理します。 クエリが到着すると、エージェントはすべてのインデックス付きチャンクでセマンティック検索を実行し、正確なキーワードの一致に関係なく、最も関連性の高い一節を取得します。
チームは Runbook の更新、新しい手順の追加、Wiki ページの再構成を行うことができます。エージェントは 24 時間以内にこれらの変更を反映します。
前提条件
| Requirement | 詳細情報 |
|---|---|
| Azure DevOps Wiki | コンテンツを含む Azure DevOps プロジェクトの Wiki |
| 認証 | マネージド ID (推奨) または個人用アクセス トークン (PAT) |
| アクセス許可 | Wiki への読み取りアクセス |
認証オプション
次の表では、Azure DevOps Wiki コネクタで使用できる認証方法について説明します。
| メソッド | 最適な用途 | どのように機能するのか |
|---|---|---|
| マネージド ID | 運用環境 | エージェントのシステム割り当てマネージド ID またはユーザー割り当てマネージド ID を使用します。 ID を Azure DevOps 組織のユーザーとして追加する必要があります。 |
| 個人用アクセス トークン (PAT) | クイック セットアップ、テスト | コード (読み取り) スコープを使用して Azure DevOps で PAT を生成します。 |
たとえば、インシデントが発生した際にランブックを利用する方法
運用 Wiki に接続した後、エージェントに問い合わせてください。
Our payment service is returning 503 errors. What does our runbook say to do?
エージェントが Wiki を検索し、[Payment Service Troubleshooting]\(支払いサービスのトラブルシューティング\) ページを見つけて、文書化された手順で応答します。 応答には、Azure DevOps の元の Wiki ページにリンクする引用文献が含まれています。