翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon OpenSearch Service のエージェントチャット
<a name="application-agentic-chat"></a>

エージェントチャットは、OpenSearch UI のすべてのページに埋め込まれた AI アシスタントです。**Ask AI** ボタンを選択してチャットパネルを開き、データに関する質問、クエリの生成、調査の開始を行うことができます。エージェントチャットは、検出と調査で表示しているページのコンテキストを理解し、エージェントツールを使用して基盤となるデータを分析します。

![\[OpenSearch UI の検出ページでは、右上隅に Ask AI ボタンが強調表示されています。\]](http://docs.aws.amazon.com/ja_jp/opensearch-service/latest/developerguide/images/agentic-chat-ask-ai-button.png)


チャットパネルを開くと、エージェントチャットには、データに関する質問、問題の調査、概念の説明など、開始に役立つオプションが表示されます。以前に会話を開始した場合は、ページ間を移動するときにチャットパネルに表示されたままになるため、中断した場所を続行できます。または、右上隅の新しい**チャット**ボタンを選択して、新しい会話を開始します。

![\[エージェントチャットパネルには、AI Assistant のウェルカムメッセージと、データに関する質問、問題の調査、概念の説明のオプションが表示されます。\]](http://docs.aws.amazon.com/ja_jp/opensearch-service/latest/developerguide/images/agentic-chat-ask-ai-panel.png)


## Discover でのエージェントチャットの使用
<a name="application-agentic-chat-discover"></a>

オブザーバビリティワークスペースの検出ページで、チャットインターフェイスに自然言語を入力して PPL クエリを生成できます。エージェントチャットは質問を PPL に変換し、クエリを実行し、結果を検出ビューに直接表示します。データから実用的なインサイトを得るために、PPL の専門家である必要はありません。

生成されたクエリを絞り込むには、「ステータスコード 500 のフィルターを追加する」など、自然言語でフォローアップの質問をします。エージェントチャットは、現在のクエリのコンテキストを理解し、それに応じて変更します。集計の調整、時間範囲の変更、結果へのフィールドの追加を に依頼することもできます。反復するたびに、Discover ビューが新しいクエリ結果で更新されます。

## エージェントチャットとビジュアライゼーションの使用
<a name="application-agentic-chat-visualizations"></a>

エージェントチャットとの会話は、視覚化から直接開始できます。視覚化パネルのコンテキストメニューを開き、AI を**尋ねる**を選択します。エージェントチャットは、視覚化を分析し、グラフ内の異常を識別し、基盤となるデータと関連付けて、分析を生成します。

![\[OpenSearch UI の視覚化。コンテキストメニューの Ask AI オプションと、視覚化を分析するエージェントチャットパネルが表示されます。\]](http://docs.aws.amazon.com/ja_jp/opensearch-service/latest/developerguide/images/agentic-chat-visualization.png)


## チャットから調査を開始する
<a name="application-agentic-chat-investigation"></a>

複雑な根本原因分析が必要な場合は、エージェントチャットから直接調査エージェントを起動できます。チャット入力で`/investigate`スラッシュコマンドを使用するか、機能ページで**調査の開始**ボタンを選択します。

調査エージェントの詳細については、「」を参照してください[Amazon OpenSearch Service の調査エージェント](application-investigation-agent.md)。

## サポートされているツール
<a name="application-agentic-chat-tools"></a>

エージェントチャットは、以下のツールを使用してデータを分析し、質問に回答します。利用可能なツールの最新up-to-dateリストを表示するには、チャットインターフェイスで「使用できるツール」と入力します。

**フロントエンドツール**  
これらのツールは OpenSearch UI を更新します。
+ `create_investigation` – 目標、症状、インデックス、時間範囲などの詳細を含む新しいエージェント調査ノートブックを作成します。
+ `execute_ppl_query` – 現在のデータセットに対して PPL クエリを実行し、検出ページに結果を表示します。
+ `update_time_range` – 現在の検出ページのグローバル時間範囲フィルターを更新します (例：「過去 24 時間」または「先週」）。

**バックエンドツール**  
これらのツールは OpenSearch データおよび APIs。
+ `SearchIndexTool` – DSL クエリを使用してインデックスを検索します。
+ `MsearchTool` – 1 つのリクエストで複数の検索オペレーションを実行します。
+ `CountTool` – クエリに一致するドキュメントの数を返します。
+ `ExplainTool` – ドキュメントがクエリと一致するか一致しない理由について説明します。
+ `ListIndexTool` – クラスター内のインデックスをオプションの詳細とともに一覧表示します。
+ `IndexMappingTool` – インデックスマッピングと設定を取得します。
+ `GetShardsTool` – インデックスのシャード情報を取得します。
+ `ClusterHealthTool` – クラスターのヘルス情報を返します。
+ `LogPatternAnalysisTool` – ログパターンを分析し、時間範囲を比較し、トレースシーケンス分析を実行します。
+ `MetricChangeAnalysisTool` – 2 つの時間範囲間の数値フィールドのパーセンタイル分布を比較します。
+ `DataDistributionTool` – オプションでベースラインと比較して、ターゲット時間範囲内のフィールド値の分布を分析します。
+ `GenericOpenSearchApiTool` – OpenSearch API エンドポイントを直接呼び出すための柔軟なツールです。