すべてのプロダクト
Search
ドキュメントセンター

OpenSearch:カスタム パラメーター

最終更新日:Dec 28, 2024

このトピックでは、OpenSearch LLMベースの対話型検索エディションのカスタム パラメーターと構文について説明します。

Q&A パラメーター

パラメーター

パラメーター

タイプ

必須

有効な値

デフォルト値

説明

モデルの選択

文字列

はい

該当なし

opensearch-qwen

この対話型検索で使用される大規模言語モデル (LLM)。サポートされているLLMの詳細については、LLMの管理 を参照してください。

プロンプト

文字列

いいえ

該当なし

デフォルトのプロンプト テンプレート

この対話型検索で使用されるプロンプト テンプレート。サポートされているプロンプト テンプレートの詳細については、プロンプトの管理 を参照してください。

複数ラウンドの会話

ブール値

いいえ

該当なし

true

  • false: 複数ラウンドの会話機能を無効にします。

  • true: 複数ラウンドの会話機能を有効にします。システムは、前のNラウンドの会話の内容に基づいて結果を返します。

  • session: 会話のソースを指定します。システムは、同じソースとの会話のコンテキストに基づいて結果を返します。

ストリーミング出力

ブール値

いいえ

該当なし

true

  • false: ストリーミング出力機能を無効にします。

  • true: ストリーミング出力機能を有効にします。システムはリアルタイムで結果を返します。

プロンプト パラメーター

パラメーター

パラメーター

タイプ

必須

有効な値

デフォルト値

説明

attitude

文字列

いいえ

該当なし

normal

  • 会話のトーン。デフォルト値: normal。有効な値:

  • normal

  • polite

  • patience

rule

文字列

いいえ

該当なし

simple

会話の詳細レベル。デフォルト値: detailed。有効な値:

  • detailed

  • stepbystep

noanswer

文字列

いいえ

該当なし

sorry

システムが質問への回答を提供できない場合に返される情報。デフォルト値: sorry。有効な値:

  • sorry

  • uncertain

language

文字列

いいえ

該当なし

Chinese

回答の言語。デフォルト値: Chinese。有効な値:

  • Chinese

  • English

  • Thai

  • Korean

role

ブール値

いいえ

該当なし

true

質問に回答するためにカスタム ロールを有効にするかどうかを指定します。

role_name

文字列

いいえ

該当なし

AI アシスタント

カスタム ロール。例: AI アシスタント。

out_format

文字列

いいえ

該当なし

text

回答の形式。デフォルト値: text。有効な値:

  • text

  • table

  • list

  • markdown

ドキュメント取得パラメーター

パラメーター

パラメーター

タイプ

必須

有効な値

デフォルト値

説明

filter

文字列

いいえ

該当なし

なし

ドキュメントをフィルタリングするために使用されるフィールド。例: filter = field = value。

top_n

整数

いいえ

(0,50]

5

取得するドキュメントの数。

sf

浮動小数点数

いいえ

[0,+∞)

1.3

取得するドキュメントのベクトル類似度を判断するために使用されるしきい値。

  • スパースベクトルが有効になっていない場合、有効な値の範囲は[0,2.0]で、デフォルト値は1.3です。値が小さいほど関連性の高い結果が得られますが、結果の数が少なくなる可能性があります。

  • スパースベクトルが有効になっている場合、デフォルト値は0.35です。値が大きいほど関連性の高い結果が得られますが、結果の数が少なくなる可能性があります。

dense_weight

浮動小数点数

(0,1)

0.7

密ベクトルの重み。このパラメーターは、スパースベクトルモデルを選択した場合に利用可能です。有効な値: (0,1)。スパースベクトルの重みは、1 - dense_weightパラメーターの値という方法で計算されます。

formula

文字列

いいえ

該当なし

ベクトル類似度

取得したドキュメントのソート基準となる式。

operator

文字列

いいえ

該当なし

AND

テキスト検索中のテキストトークン間の演算子。

構文

パラメーター

説明

filter

フィルター条件の形式: field=value。

  1. categoryフィールドの値がvalue1であるドキュメントからデータをクエリします。

    "filter" : "category=\"value1\""

  2. categoryフィールドの値がvalue1またはvalue2であるドキュメントからデータをクエリします。

    "filter" : "category=\"value1\" OR category=\"value2\""

  3. categoryフィールドの値が指定された値のいずれかであるドキュメントからデータをクエリします。

    // 複数の値はカンマ(,)で区切ります。
    // 例: category=value1,value2,value3,value4
    "filter" : "category=\"value1,value2,value3,value4\"" // categoryフィールドの値が指定された値のいずれかであるドキュメントを取得します。

top_n

top_n:value。例: top_n:3。ビジネス要件に基づいてtop_nパラメーターの値を変更できます。

sf

sf=value。例: sf=1.3。スパースベクトルが有効になっていない場合、有効な値の範囲は[0,2.0]で、デフォルト値は1.3です。値が小さいほど関連性の高い結果が得られますが、結果の数が少なくなる可能性があります。スパースベクトルが有効になっている場合、デフォルト値は0.35です。値が大きいほど関連性の高い結果が得られますが、結果の数が少なくなる可能性があります。

formula

  • テキスト関連度

  1. text_relevance: 検索クエリとドキュメント内のフィールド値の間のテキスト関連度を計算します。

  2. field_match_ratio: 検索クエリに一致するフィールド内の語句数の割合を、フィールド内の語句の総数で割った値を返します。

  3. query_match_ratio: フィールド内でヒットした語句数の割合を、検索クエリ内の語句の総数で割った値を返します。

  4. fieldterm_proximity: フィールド内の語句の近接度を返します。

  5. field_length: フィールド内の語句の数を返します。

  6. query_term_count: 分析後の検索クエリ内の語句の数を返します。

  7. query_term_match_count: ドキュメント内のフィールドでヒットした検索クエリ内の語句の数を返します。

  8. field_term_match_count: 検索クエリに一致するフィールド内の語句の数を返します。

  9. query_min_slide_window: 検索クエリに一致するフィールド内の語句数の割合を、フィールド内のこれらの語句の最小ウィンドウで割った値を返します。

  • 適時性

  1. timeliness: ドキュメントがどれだけ新しいかを示す適時性スコアを秒単位で返します。

  2. timeliness_ms: ドキュメントがどれだけ新しいかを示す適時性スコアをミリ秒単位で返します。

  • 機能

  1. tag_match: タグに基づいてクエリ句とドキュメントを照合し、一致したタグの重みを計算してドキュメントをスコアリングします。

  2. first_phase_score: 粗ソート式を使用して計算されたスコアを返します。

  3. kvpairs_value: クエリ文字列内のkvpairs句で指定されたフィールドの値を返します。

  4. normalize: 異なる値範囲のスコアを[0,1]の範囲の数値に正規化します。

  5. inまたはnotin: フィールド値が指定されたリストに含まれているかどうか、または含まれていないかどうかを確認します。

参照画像パラメーター

パラメーター

パラメーター

タイプ

必須

有効な値

デフォルト値

説明

sf

浮動小数点数

いいえ

[0,+∞)

1

参照画像のベクトル類似度を判断するためのしきい値。スパースベクトルモデルの場合、値が大きいほどベクトル類似度が高くなります。密ベクトルモデルの場合、値が大きいほどベクトル類似度が低くなります。

dense_weight

浮動小数点数

いいえ

(0,1)

0.7

密ベクトルの重み。このパラメーターは、スパースベクトルモデルを選択した場合に利用可能です。有効な値: (0,1)。スパースベクトルの重みは、1 - dense_weightパラメーターの値という方法で計算されます。

構文

パラメーター

説明

sf

sf=value。例: sf=1。ビジネス要件に基づいてsfパラメーターの値を変更できます。スパースベクトルモデルを使用するかどうかを指定します。

クエリ理解パラメーター

パラメーター

パラメーター

タイプ

必須

有効な値

デフォルト値

説明

query_extend

ブール値

いいえ

該当なし

false

クエリを拡張するかどうかを指定します。この機能を有効にすると、クエリが拡張され、検索パフォーマンスが向上します。

query_exten_num

整数

いいえ

(0, +∞)

5

拡張するクエリの数。

手動介入パラメーター

パラメーター

パラメーター

タイプ

必須

有効な値

デフォルト値

説明

sf

浮動小数点数

いいえ

[0,2]

0.3

手動介入のしきい値。デフォルト値: 0.3。値が大きいほど、介入エントリが一致しやすくなります。

構文

パラメーター

説明

sf

sf=value。例: sf=0.3。ビジネス要件に基づいてsfパラメーターの値を変更できます。値が大きいほど、手動介入エントリが一致しやすくなります。

その他のパラメーター

パラメーター

パラメーター

タイプ

必須

有効な値

デフォルト値

説明

return_hits

ブール値

いいえ

該当なし

false

検索結果を返すかどうかを指定します。このパラメーターをfalseに設定すると、参照リンクのみが返されます。

csi_level

文字列

いいえ

該当なし

strict

コンテンツモデレーションの構成。有効な値:

  • none: コンテンツをモデレートしません。

  • loose: 結果をモデレートし、制限されたコンテンツが検出された場合は結果をブロックします。この場合、結果は返されません。

  • strict: 結果をモデレートし、制限されたコンテンツまたは疑わしいコンテンツが検出された場合は結果をブロックします。この場合、結果は返されません。

history_max

整数

いいえ

(0,20]

20

システムが結果を返す際に基づく会話の最大ラウンド数。最大20ラウンドまで指定できます。

link

ブール値

いいえ

該当なし

false

取得したドキュメントのソースを返すかどうかを指定します。

構文

パラメーター

説明

return_hits

return_hits:value。有効な値: trueとfalse。例: return_hits:true。return_hitsパラメーターをtrueに設定すると、対応する検索結果が返されます。

link

このパラメーターをtrueに設定した場合のサンプルレスポンス:

Elastic Compute Service (ECS) インスタンスのディスクは、オンラインまたはオフラインでサイズ変更できます[^1^]。オンラインサイズ変更方式を使用する場合、インスタンスを再起動せずにディスクのサイズを変更できます。オフラインサイズ変更方式を使用する場合、インスタンスを再起動する必要があります[^1^]。ディスクのサイズを変更するには、次の操作を実行します。ECSコンソールにログオンし、サイズ変更するディスクを見つけ、[アクション] 列の [サイズ変更] をクリックし、ビジネス要件に基づいてサイズ変更方式を選択します[^1^]。パーティションとファイルシステムのサイズを変更する必要がある場合は、CLIまたはコンソールを使用して関連情報を取得できます[^2^]。ECSディスクのサイズ変更後、容量を減らすことはできません。適切な容量計画を実施することをお勧めします[^3^]。

説明

[^番号^] は、返された結果の参照に含まれる取得済みドキュメントの序数を示します。たとえば、[^1^] は参照内の最初のドキュメントを示します。