エージェントにはAzure監視機能が組み込まれていますが、すべてのチームに固有のコンテキスト (Runbook、アーキテクチャ ドキュメント、内部 Wiki、コード リポジトリ) があります。 ナレッジ ベースを使用すると、これらのナレッジ ソースをすべて 1 か所で管理して、エージェントが調査中にそれらを参照できるようにします。
ヒント
重要なポイント
- Builder > ナレッジ ベース は、ファイル、Web ページ、リポジトリなど、すべてのナレッジ ソースを管理するための中心的な場所です。
- Runbook とドキュメントのアップロード、URL による Web ページの追加、またはソース コード リポジトリの接続。
- エージェントは、調査中にインデックス付きナレッジを自動的に参照します。
- エージェントの関連性の高い知識が増えるほど、応答が迅速かつ正確になります。
知識が重要な理由
エージェントは、Azureの可観測性と連携されたツールによって、すぐに高い性能を発揮します。 しかし、すべてのチームには、Runbook、アーキテクチャ ドキュメント、内部 Wiki、およびインシデントを迅速に解決するために必要な制度上の知識を含むコード リポジトリという固有のコンテキストがあります。
エージェントがこのナレッジにアクセスできる場合、次のことができます。
- 最初から始めるのではなく、インシデント時にチームの Runbook を参照します。
- 運用環境の問題をリポジトリ内の特定のコード変更に関連付ける。
- チームが既に文書化したトラブルシューティング手順を適用します。
ナレッジベース
ポータル (Builder>) のナレッジ ベース ページを使用して、エージェントのナレッジを管理します。 ファイルのアップロード、Web ページの追加、接続されたリポジトリの表示を行うことができます。
次の表では、3 種類のナレッジ ソースについて説明します。
| ソースの種類 | 提供される内容 | 追加する方法 |
|---|---|---|
| ファイル | ランブック、トラブル解決ガイド、アーキテクチャ文書、構成参照 | ポータル経由でアップロード、ドラッグ アンド ドロップ、または会話中にエージェントに作成させる |
| Web ページ | 外部ドキュメント、ステータス ページ、内部 Wiki URL | URL で追加します。 エージェントは、指定された URL のコンテンツのインデックスを作成します。 |
| リポジトリ | 根本原因分析、デプロイ構成、コードとしてのインフラストラクチャのソース コード | GitHubまたはAzure DevOps リポジトリを接続する |
各エントリには、その名前、インデックス作成の状態 (インデックス付き、保留中、またはインデックス付けされていない)、種類、最終更新日が表示されます。
ドキュメントのアップロード
エージェントは、会話中にナレッジを作成してアップロードできます。 解決した内容から Runbook を保存するように依頼すると、ドキュメントが自動的に保存されます。 ポータルから直接ファイルをアップロードすることもできます。
サポートされているファイル形式とサイズ制限については、「 ナレッジ ドキュメントのアップロード: サポートされているファイル形式」を参照してください。 ファイルの種類、制限、エージェントによって生成されたドキュメントの詳細については、「 ナレッジ ドキュメントのアップロード」を参照してください。
チャットでファイルを共有する
ドラッグ アンド ドロップ、クリップボードからの貼り付け、または [ + ] ボタンを使用して、チャット スレッドにファイルを直接添付できます。 スレッドはチャットの添付ファイルを格納し、エージェントに分析のための即時コンテキストを提供します。
ヒント
ファイルを永続的に保持しますか?
チャットでファイルを添付した後、エージェントに 「これをナレッジ設定に保存する」と 依頼します。エージェントはスレッドからファイルを読み取り、コピーをナレッジ ベースにアップロードし、今後のすべての会話でインデックスを作成して検索できるようにします。 元のファイルもスレッド内に残ります。
次の表では、ナレッジ ドキュメントのアップロードとチャットでのファイルの共有を比較します。
| ナレッジのアップロード | チャットでファイルを共有する | |
|---|---|---|
| Where | Builder > ナレッジベース、またはチャットで質問できます | チャット メッセージ入力 (+、ドラッグ/ドロップ、貼り付け) |
| ストレージ | エージェント レベル: インデックス付き、すべてのスレッドで検索可能 | スレッド レベル: その会話で使用可能 |
| 最適な用途 | 今後のすべての会話でエージェントが参照するランブック、アーキテクチャドキュメント、及び手順書 | 今すぐ分析する必要があるスクリーンショット、ログ、構成ファイル |
| 知識への昇格 | 既に存在する | エージェントに指示する: "これをナレッジ設定に保存する"とし、コンテンツをエージェントレベルのストレージにコピーする |
| 形式 | ドキュメント、データ、画像を含む 28 種類 | コード、スクリプト、インフラストラクチャ、Web などの 31 種類 |
| サイズの制限 | ファイルあたり 16 MB、アップロードあたり 100 MB | ファイルあたり 10 MB、合計 50 MB、5 つのファイル |
ソース コードの接続
エージェントがコードを検索し、最近の変更とエラーを関連付け、調査中にデプロイ構成を参照できるように、GitHubまたはAzure DevOpsリポジトリに接続します。
リポジトリを追加する
Builder>Knowledge ベースから、[リポジトリの追加] を選択して、次の 3 つの手順を説明するガイド付きウィザードを開きます。
| Step | あなたの活動内容 |
|---|---|
| 1. プラットフォームを選択する | GitHub または Azure DevOps を選択します。 Azure DevOpsには、組織名を入力します。 |
| 2. 認証 | OAuth でサインインするか、個人用アクセス トークン (PAT) を入力します。 Azure DevOpsでは、マネージド ID もサポートされます。 |
| 3. リポジトリを追加する | ドロップダウンから使用可能なリポジトリを参照するか、URL を手動で入力します。 各エントリの表示名と説明 (省略可能) を追加します。 Azure DevOpsの場合は、最初にプロジェクトを選択してリポジトリの一覧をフィルター処理します。 |
1 つのセッションに複数のリポジトリを追加できます。 +選択して行を追加し、完了したら [保存] を選択します。
保存後、リポジトリはナレッジ ベースの一覧にインデックス作成の状態で表示されます。 インデックスが作成されると、エージェントは会話内のコードを参照できます。
サポートされているプラットフォームと認証
| プラットフォーム | 認証方法 | 必要なもの |
|---|---|---|
| GitHub | OAuth、個人用アクセス トークン | GitHub のリポジトリにアクセスできるアカウント。 PAT の場合は、スコープを持つトークン repo 作成します。 |
| Azure DevOps | OAuth、個人用アクセス トークン、マネージド ID | Azure DevOps 組織へのアクセス。 マネージド ID の場合は、ユーザー割り当てマネージド ID をエージェント リソースに割り当てます。 |
- GitHub リポジトリの接続の詳細については、「Connect ソース コードを参照してください。
- Azure DevOps リポジトリを接続するには、「 Azure DevOps コネクタのセットアップを参照してください。