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

問題:知識は会話で死ぬ

チームが解決するすべてのインシデントは、問題の原因、修正されたコマンド、次回最初に確認する内容など、貴重な知識を生み出します。 しかし、その知識は、誰も午前 3 時に読まないチャット スレッド、エンジニア メモリ、事後分析に存在します。

お客様のチームには複数の 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

フォルダーのアップロード

サポートされているすべてのファイルを一度にアップロードするには、フォルダー全体をアップロード ドロップ ゾーンにドラッグします。 このプロセスには、入れ子になったサブフォルダー内のファイルが含まれます。 ポータルでは、フォルダー階層からすべてのファイルが自動的に抽出され、サポートされていないファイルの種類が除外されます。

フォルダーのアップロードのしくみ:

1. システムは、入れ子になったサブフォルダーからフラット リストにすべてのファイルを抽出します。
2. システムには、サポートされている拡張子を持つファイルのみが含まれており、サポートされていない型をサイレント フィルター処理します。
3. システムは、異なるサブフォルダーの重複する名前を持つファイルを重複除去し、最初のファイルのみを保持します。
4. システムは、各ファイルを個別にアップロードし、インデックスを作成して検索します。

ナレッジ設定のアップロードでは、従来の Office 形式 (.doc、 .ppt、 .xls) と、チャット添付ファイルに含まれない追加の画像形式 (.bmp、 .tiff、 .tif) を受け入れます。 チャットの添付ファイルでは、ナレッジ設定ではサポートされないコード、スクリプト、インフラストラクチャ、Web 形式がサポートされます。

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

エージェントが会話中に ( ナレッジ ドキュメントのアップロード ツールを使用して) ドキュメントを作成すると、 .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 人のエンジニアの経験を共有チームの知識に変換します。

必要なもの

制限

他のものを使用する場合

関連する機能