Azure SRE エージェントにナレッジ ドキュメントをアップロードする

エージェントは、会話プロセス中に、Runbook、トラブルシューティングガイド、ドキュメントをナレッジベースに直接アップロードすることによって、組織の知識をキャプチャします。 エージェントが修正プログラムを検出したり、インシデントを解決したりすると、構造化されたドキュメントが生成され、セマンティック検索用にインデックスが作成されるため、今後の調査のたびに過去の解決策からメリットが得られます。

エージェントが知識を取得する方法

エージェントは、[ナレッジ ドキュメントのアップロード] ツールを使用して、会話中にナレッジ設定に ドキュメントをアップロード できます。 エージェントは、修正プログラムを検出したり、トラブルシューティング ガイドを作成したり、調査結果を合成したりすると、その知識を直接格納し、今後のすべての会話を検索できるようにします。

Create a runbook from the steps we just followed to fix this database
connection pool exhaustion issue and save it to Knowledge settings.

エージェントによって構造化された Runbook が生成され、数秒でアップロードされます。 ドキュメントは自動的にインデックスが作成され、今後の調査のために検索できるようになります。

前と後

次の表は、ナレッジ ドキュメントのアップロード ツールを使用する前後のナレッジ キャプチャ ワークフローを比較しています。

このアプローチの違い

手動アップロードとは異なり、エージェントは事前に知識を作成します。 学習したことを忘れずに文書化する必要はありません。 エージェントが会話の一部として実行します。

チャット履歴とは異なり、アップロードされたドキュメントにはセマンティック検索用のインデックスが作成されます。 数か月後に同様の問題が発生した場合、エージェントは、古いスレッドをスクロールすることではなく、インテリジェントな取得によって関連する Runbook を自動的に検出します。

Wiki コネクタとは異なり、アップロードされたドキュメントには外部サービスは必要ありません。 ナレッジはエージェントのナレッジ設定に直接存在し、遅延を同期することなくすぐに利用できます。

どのように機能するのか

ナレッジ ドキュメントのアップロード ツールは、3 つのパラメーターを受け入れます。

エージェントがドキュメントをアップロードする場合:

1. エージェントはファイル名とコンテンツを検証します (ファイルあたり最大 16 MB)。
2. エージェントは、エージェントのナレッジ設定にドキュメントを格納します。
3. エージェントは、セマンティック検索のコンテンツのインデックスを作成します。
4. エージェントはアップロードを成功メッセージで確認します。

サポートされるファイル形式

エージェントは、それぞれ異なる形式をサポートする 3 つの方法でファイルを処理します。

チャットの添付ファイル

任意のチャットにファイルをドラッグして、トラブルシューティング スクリプト、構成ファイル、ネットワーク トレースなど、分析のための即時コンテキストをエージェントに提供します。

制限: ファイルあたり 10 MB ·メッセージあたり合計 50 MB ·メッセージあたり 5 つのファイル

ナレッジ設定のアップロード

Builder>Knowledge 設定を使用してファイルをアップロード>後の会話でエージェントが参照するドキュメントを保持するファイルを追加します。 システムは、セマンティック検索のためにアップロードされたファイルにインデックスを付けます。

制限: ファイルあたり 16 MB ·アップロードあたり 100 MB

エージェントによって生成されたドキュメント

エージェントは、会話中に ( ナレッジ ドキュメントのアップロード ツールを使用して) ドキュメントを作成すると、 .md または .txt ファイルが生成され、 ナレッジ設定に直接保存されます。 このプロセスは、エージェントに "これを Runbook として保存する" ように依頼したときに発生します。

例: インシデントの知識をキャプチャする

インシデント調査中に、エージェントに問い合わせてください。

We just resolved the high CPU issue on web-app-prod. It was caused by a
memory leak in the connection pool. Create a troubleshooting guide from
what we learned and upload it to Knowledge settings.

エージェントによって、次の構造化されたトラブルシューティング ガイドが生成されます。

• スコープ設定のステップ: 問題を特定する方法
• クイック軽減策: 影響を軽減するための即時アクション
• 根本原因分析: 調査対象
• 解決策の手順: 動作した修正プログラム
• 防止: 繰り返しを回避する方法

次に同様の CPU 問題が発生すると、エージェントは調査中にこのドキュメントを自動的に参照し、1 人のエンジニアの経験を共有チームの知識に変換します。

前提条件

ナレッジ ドキュメントのアップロード ツールを使用する前に、次の要件を満たしていることを確認してください。

制限

アップロードされたナレッジ ドキュメントには、次の制限が適用されます。

他のものを使用する場合

次の表では、別のアプローチがより適切なシナリオについて説明します。

概要

関連するコンテンツ