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

# Amazon OpenSearch Service における自然言語クエリ生成
<a name="natural-language-query"></a>

Amazon OpenSearch Service の自然言語クエリ生成機能を使用すると、自然言語を使用してオペレーションログとセキュリティログのデータをクエリできます。OpenSearch は、非常にスケーラブルでパフォーマンスの高いログ分析と検索エンジンであり、自然言語を使用してこれらのログを調べることができるため、ログデータを探索する理想的なオプションです。この機能を使用すると、OpenSearch Piped Processing Language (PPL) に依存したり、クエリを構築するときにデータ定義を検索したりすることなく、問題を特定できます。バージョン 2.13 以降の OpenSearch Service ドメインでは、自然言語クエリ生成機能を使用できます。きめ細かなアクセスコントロールを有効にする必要があります。

この機能は、[OpenSearch Assistant Toolkit](https://opensearch.org/docs/latest/ml-commons-plugin/opensearch-assistant/) を使用して構築されました。大規模な言語モデルに接続する同様の機能を作成する場合は、ツールキットを使用して独自のエージェントとツールを設定できます。

## 前提条件
<a name="Prerequisites"></a>

自然言語クエリ生成機能を使用する前に、ドメインには次が必要です。
+ バージョン 2.13 以降。
+ サービスソフトウェア R20240520-P4 以降。
+ きめ細かなアクセスコントロールが有効。詳細については、「[きめ細かなアクセスコントロールの有効化](fgac.md#fgac-enabling)」を参照してください。

## 開始方法
<a name="natural-language-query-getting-started"></a>

自然言語クエリは、詳細なアクセスコントロールが有効になっているバージョン 2.13 以降で作成されたすべてのドメインでデフォルトで有効になっています。

他のドメインの場合は、**[自然言語クエリ生成を有効化 と Amazon Q Developer 機能]** を選択して有効にします。

有効にしたら、OpenSearch Dashboards の **[ログ]** ページに移動します。**[Event Explorer]** を選択し、クエリアシスタントを使用して質問をします。

## アクセス許可の設定
<a name="natural-language-query-permissions"></a>

既存の OpenSearch Service ドメインで自然言語クエリの生成を有効にすると、ドメインで **[query\_assistant\_access]** ロールが定義されない場合があります。きめ細かなアクセスコントロールを使用してドメインのウォームインデックスを管理するには、管理者以外のユーザーがこのロールにマッピングされている必要があります。**[query\_assistant\_access]** ロールを手動で作成するには、以下の手順を実行します。

1. OpenSearch Dashboards で、**[セキュリティ]** に進み、**[ロール]** を選択します。

1. **[ロールの作成]** を選択し、次のクラスターアクセス許可を設定します。
   + `cluster:admin/opensearch/ml/config/get`
   + `cluster:admin/opensearch/ml/execute`
   + `cluster:admin/opensearch/ml/predict`
   + `cluster:admin/opensearch/ppl`

1. ロールに **[query\_assistant\_access]** という名前を付けます。

1. [**ロールの作成**] を選択してください。**[query\_assistant\_access]** ロールが利用可能になりました。
**注記**  
また、自然言語の質問を使用するインデックスの `indices:admin/mappings/get` および `read` インデックスアクセス許可も必要です。

## 設定の自動化
<a name="natural-language-query-automation"></a>

Flow Framework は、クエリ生成や会話チャットなどのユースケースの [OpenSearch 設定を自動化](https://opensearch.org/docs/latest/automating-configurations/index/)できる OpenSearch プラグインです。プラグインは自然言語クエリ生成機能を有効にするリソースを追跡するため、フローフレームワークインデックスはクエリアシストを使用する各ドメインのテンプレートを保存します。

Flow Framework では、[事前定義されたテンプレート](https://opensearch.org/docs/latest/automating-configurations/workflow-templates/)のセットから選択するか、生成モデルのバックエンドとして OpenSearch を準備する機械学習コネクタ、ツール、エージェント、およびその他のコンポーネント用の独自のオートメーションを作成できます。