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

このチュートリアルでは、将来の調査中に参照できるように、ナレッジ ドキュメントを Azure SRE エージェントにアップロードします。 チャットを使用して調査結果をナレッジ設定に直接保存する方法と、ポータル UI を使用して既存のファイルをアップロードする方法について説明します。

このチュートリアルでは、以下の内容を学習します。

推定時間: 10 分

前提条件

• 実行中の状態の Azure SRE エージェント
• エージェントへの書き込みアクセス許可
• エージェント実行モードが [確認] または [自律] に設定されている

手順 1: 調査から開始する

最高の知識ドキュメントは、実際の調査から得られたものです。 最初からコンテンツを作成する代わりに、エージェントが既に学習したことをキャプチャします。

1. sre.azure.com に移動し、エージェントを選択します。
2. 左側のサイドバーの [ チャット] で、以前の調査スレッド (エージェントが問題を診断または解決した会話) を見つけて選択します。

調査スレッドがまだない場合は、新しいチャットを開始し、エージェントに調査を依頼します。

Investigate high memory usage on our container apps

調査が完了するまで待ってから、手順 2 に進みます。

手順 2: エージェントに Runbook の作成を依頼する

同じ調査スレッドで、その結果を Runbook に変換し、ナレッジ設定に保存するようにエージェントに依頼します。 ファイル名について具体的に指定します。

Create a runbook from the investigation we just did. Include the root cause
analysis, the diagnostic steps, mitigations, and escalation triggers.
Save it to Knowledge settings as high-memory-runbook.md

エージェント:

1. 調査コンテキストを構造化された手順書に合成します。
2. 根本原因分析、診断手順、軽減策、エスカレーション トリガーなどのセクションを生成します。
3. ドキュメントをナレッジ設定に保存し、アップロードを確認します。

エージェントは、ドキュメントが保存されたことを確認し、ダウンロード リンクを提供します。 現在、ランブックはナレッジシステムに格納され、検索のためにインデックスが付けられています。

Checkpoint

• エージェントは、調査から構造化された Runbook を生成しました。
• エージェントは、ドキュメントが保存されたことを確認しました。

手順 3: ナレッジ設定内で確認する

1. 左側のサイドバーで[ ビルダー ]を選択してセクションを展開します。
2. ナレッジ設定 を選択します。

[ ナレッジ設定] ページには、 ファイル名、 状態、 種類、 最終更新日時の列が含まれるテーブルにドキュメントが表示されます。 [状態] 列には、ドキュメントのインデックスが作成され、検索の準備ができたときに✓インデックスが付けられます。

状態が [保留中] と表示されている場合は、[ 最新の情報に更新] を選択します。 インデックス作成は通常、数秒以内に完了します。

Checkpoint

• Builder → Knowledge 設定に移動しました
• ドキュメントが ✓インデックス付きの状態で表示されます

手順 4: ポータルを使用してファイルをアップロードする

個々のファイルまたはフォルダー全体を直接アップロードできます。 この方法は、チームが既に持っている既存の Runbook、ドキュメント、または参照資料に役立ちます。

個々のファイルをアップロードする

1. [ ナレッジ ソース ] ページで、[ ファイルの追加] を選択します。
2. ドロップ ゾーンにファイルをドラッグするか、[ ファイルの参照 ] を選択してファイルを選択します。
3. ファイルを追加 を選択します。

フォルダーをアップロードする

また、フォルダー全体 (入れ子になったサブフォルダーを含む) をドロップ ゾーンにドラッグすることもできます。

1. [ ナレッジ ソース ] ページで、[ ファイルの追加] を選択します。
2. ファイル マネージャーからドロップ ゾーンに直接フォルダーをドラッグします。
3. ポータルでは、サポートされているすべてのファイルがフォルダーとそのサブフォルダーから抽出され、ダイアログに一覧表示されます。
4. ファイルの一覧を確認します。各ファイルの横にある削除アイコンを選択して、不要なファイルを削除します。
5. [ ファイルの追加] を選択して、一覧表示されているすべてのファイルをアップロードします。

ポータルでは、サポートされていない拡張子を持つファイルが自動的に除外されます。 サポートされている拡張機能とサイズ制限の完全な一覧については、「 ナレッジ ドキュメントのアップロード」機能ページを参照してください。

最大ファイル サイズはファイルあたり 16 MB で、アップロードあたり最大 100 MB です。

Checkpoint

• [ ファイルの追加] を選択すると、アップロード ダイアログが表示されます。
• ファイルをアップロードするか、フォルダーを正常にドラッグしました。
• ファイルは 、ナレッジ ソース に ✓インデックス付きの 状態で表示されます。

手順 5: 新しい会話で取得をテストする

新しいチャット スレッドを開始し、アップロードしたドキュメントが回答する必要があることを質問します。

What are the steps for troubleshooting high memory usage on container apps?

エージェントはナレッジ設定を検索し、アップロードしたランブックを見つけて応答で参照します。 このプロセスでは、ナレッジのインデックスが作成され、取得可能であることが確認されます。

Checkpoint

• 新しいチャット スレッドを開始しました
• アップロードされたコンテンツに関連する質問
• エージェントは、その応答でアップロードされたドキュメントを参照しました

ナレッジ ドキュメントを削除する

1. Builder → Knowledge の設定に移動します。
2. ドキュメントの一覧で、チェック ボックスを使用して 1 つまたは複数のドキュメントを選択します。
3. ツール バーの [ 削除] を選択します。
4. 削除するドキュメントの一覧が確認ダイアログに表示されます。 [削除] を選択して確定します。

ドキュメントを削除すると、エージェントのナレッジ設定からドキュメントが削除され、検索結果に表示されなくなります。

学習した内容

• エージェントは、実際の調査を構造化された Runbook に変換し、ナレッジ設定に保存できます。
• Builder → Knowledge 設定のポータル UI を使用して、ファイルを手動でアップロードできます。 PDF、Office ドキュメント、画像など、多くの形式がサポートされています。
• システムは、セマンティック検索用にアップロードされたドキュメントにインデックスを付け、今後のすべての会話で使用できます。
• ドキュメントを更新するには、同じファイル名を使用してドキュメントをアップロードします。

Troubleshooting

Related