Amazon OpenSearch Service での自然言語クエリの生成

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

この機能は、OpenSearch Assistant Toolkit を使用して構築されました。大規模な言語モデルに接続する同様の機能を作成する場合は、ツールキットを使用して独自のエージェントとツールを設定できます。

前提条件

自然言語クエリ生成機能を使用する前に、ドメインには次が必要です。

• バージョン 2.13 以降。

• サービスソフトウェア R20240520-P4 以降。

• きめ細かなアクセスコントロールが有効。詳細については、「きめ細かなアクセスコントロールの有効化」を参照してください。

入門

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

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

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

アクセス許可の設定

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

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

2. [ロールの作成] を選択し、次のクラスターアクセス許可を設定します。

   • cluster:admin/opensearch/ml/config/get

   • cluster:admin/opensearch/ml/execute

   • cluster:admin/opensearch/ml/predict

   • cluster:admin/opensearch/ppl

3. ロールに [query_assistant_access] という名前を付けます。

4. [ロールの作成] を選択してください。[query_assistant_access] ロールが利用可能になりました。

   注記

   また、自然言語の質問を使用するインデックスの indices:admin/mappings/get および read インデックスアクセス許可も必要です。

設定の自動化

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

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