エージェントは、会話プロセス中に、Runbook、トラブルシューティングガイド、ドキュメントをナレッジベースに直接アップロードすることによって、組織の知識をキャプチャします。 エージェントが修正プログラムを検出したり、インシデントを解決したりすると、構造化されたドキュメントが生成され、セマンティック検索用にインデックスが作成されるため、今後の調査のたびに過去の解決策からメリットが得られます。
ヒント
エージェントは、手動でファイルを管理することなく、会話中に Runbook を作成してアップロードします。 システムはセマンティック検索用にドキュメントのインデックスを作成し、将来のすべての調査で使用できるようにします。 インシデントの解決は、自動的に制度的な知識になります。
エージェントが知識を取得する方法
エージェントは、ナレッジ ドキュメントのアップロード ツールを使用して、会話中に ナレッジ ベースにドキュメントをアップロードできます。 エージェントは、修正プログラムを検出したり、トラブルシューティング ガイドを作成したり、調査結果を合成したりすると、その知識を直接格納し、今後のすべての会話を検索できるようにします。
Create a runbook from the steps we just followed to fix this database
connection pool exhaustion issue and save it to the knowledge base.
エージェントによって構造化された Runbook が生成され、数秒でアップロードされます。 ドキュメントは自動的にインデックスが作成され、今後の調査のために検索できるようになります。
前後
次の表は、ナレッジ ドキュメントのアップロード ツールを使用する前後のナレッジ キャプチャ ワークフローを比較しています。
| 面積 | の前に |
後の |
|---|---|---|
| ナレッジ キャプチャ | インシデント後: エンジニアが Runbook を作成する (可能性あり) | エージェントは、修正が発生した時点で修正作業を記録します。 |
| ドキュメントする時間 | ランブックを作成するのに30〜60分かかります。 | 秒: エージェントがインラインで生成してアップロードします |
| 知識の鮮度 | Runbookが数週間で陳腐化する | ナレッジ ベースは、すべての解像度で拡張されます |
| アクセシビリティ | エンジニアの頭やチャット スレッドに残っている知識 | あらゆる今後の会話を通じてエージェントにより検索可能です |
| 形式の一貫性 | 作成者によって異なります | 毎回構造化された一貫性のあるドキュメント |
これは何が違うのか
手動アップロードとは異なり、エージェントは事前にナレッジを作成します。 学習したことを忘れずに文書化する必要はありません。 エージェントが会話の一部として実行します。
チャット履歴とは異なり、アップロードされたドキュメントにはセマンティック検索用のインデックスが作成されます。 数か月後に同様の問題が発生した場合、エージェントは、古いスレッドをスクロールすることではなく、インテリジェントな取得によって関連する Runbook を自動的に検出します。
Wiki コネクタとは異なり、アップロードされたドキュメントには外部サービスは必要ありません。 ナレッジはエージェントのナレッジ ベースに直接存在し、遅延を同期することなくすぐに利用できます。
どのように機能するのか
ナレッジ ドキュメントのアップロード ツールは、3 つのパラメーターを受け入れます。
| パラメーター | 必須 | 説明 |
|---|---|---|
| ファイル名 | はい |
.mdまたは.txt拡張子を持つ名前 (例: database-pool-runbook.md) |
| Content | はい | Markdown 形式またはプレーン テキスト形式の完全なドキュメント テキスト |
| インデックス作成をトリガーする | 省略可能 (既定値: true) |
ドキュメントをすぐに検索可能にするかどうか |
エージェントがドキュメントをアップロードする場合:
- エージェントはファイル名とコンテンツを検証します (ファイルあたり最大 16 MB)。
- エージェントは、エージェントのナレッジ ベースにドキュメントを格納します。
- エージェントは、セマンティック検索のコンテンツのインデックスを作成します。
- エージェントはアップロードを成功メッセージで確認します。
注
同じファイル名のドキュメントが既に存在する場合は、新しいコンテンツによって置き換えられます。 コンテンツを更新するには、同じ名前でアップロードします。
サポートされるファイル形式
ナレッジ ドキュメントのアップロード ツールは、エージェントがインラインで生成するテキストベースの形式をサポートします。
| フォーマット | 拡張 | 最適な用途 |
|---|---|---|
| Markdown | .md |
Runbook、トラブルシューティングガイド（書式設定およびヘッダー付き） |
| プレーンテキスト | .txt |
簡単なメモ、ログ、未加工のドキュメント |
注
API または CLI を使用してファイルをアップロードする場合は、CSV、JSON、YAML、ログ ファイルなど、より多くのテキスト形式を使用できます。 アップロード API では、バイナリ形式 (PDF、Word、Excel、PowerPoint) と画像がサポートされます。 エージェント ツールは、会話中にテキスト コンテンツを生成するため、 .md 形式と .txt 形式に重点を置いています。
![サポートされている形式とドラッグ アンド ドロップアップロードを示すナレッジ ベースの [ファイルの追加] ダイアログ](media/upload-knowledge-document/add-file-dialog.png#lightbox)
例: インシデントの知識をキャプチャする
インシデント調査中に、エージェントに問い合わせてください。
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 the knowledge base.
エージェントによって、次の構造化されたトラブルシューティング ガイドが生成されます。
- スコープ設定のステップ: 問題を特定する方法
- クイック軽減策: 影響を軽減するための即時アクション
- 根本原因分析: 調査対象
- 解決策の手順: 動作した修正プログラム
- 防止: 繰り返しを回避する方法
次に同様の CPU 問題が発生すると、エージェントは調査中にこのドキュメントを自動的に参照し、1 人のエンジニアの経験を共有チームの知識に変換します。
前提条件
ナレッジ ドキュメントのアップロード ツールを使用する前に、次の要件を満たしていることを確認してください。
| Requirement | 詳細情報 |
|---|---|
| エージェントのバージョン | 26.1.57.0 以降 |
| ナレッジベース | エージェント上で有効化されています |
| Write 権限 | エージェントがナレッジ ベースへの書き込みアクセスを必要とする |
| 実行モード | レビューまたは自律的 (書き込みアクションにはレビュー モードでの承認が必要) |
制限
アップロードされたナレッジ ドキュメントには、次の制限が適用されます。
| 制限 | 価値 |
|---|---|
| ファイルの最大サイズ | ドキュメントあたり 16 MB |
| サポートされている拡張機能 |
.md および .txt |
| ファイル名の文字 | 文字、数字、ハイフン、アンダースコア、ドット ( /なし、 \、 ?、 #) |
| ファイル名の最大長 | 1,024 文字 |
他のものを使用する場合
次の表では、別のアプローチがより適切なシナリオについて説明します。
| シナリオ | より優れたアプローチ |
|---|---|
| 同期が維持されているライブ Wiki コンテンツの接続 | Azure DevOps Wiki の知識 |
| バイナリ ファイルのアップロード (PDF、Word、画像) | >使用して手動でアップロードファイルを追加する |
| 多数のドキュメントを一度に一括インポートする |
srectl doc upload --file <path> CLI コマンドを使用する |