翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
personalized_search_ranking
レスポンスプロセッサのフィールド
Amazon Personalize Search Ranking プラグインの検索パイプラインを作成するときは、以下のフィールドを使用して personalized_search_ranking
レスポンスプロセッサを指定します。
-
campaign_arn (必須) — 結果のパーソナライズに使用する Amazon Personalize キャンペーンのAmazon リソースネーム (ARN) を指定します。
-
item_id_field (オプション) — OpenSearch のインデックス付きドキュメントの
_id
フィールドが Amazon Personalize の itemId と一致しない場合は、一致するフィールドの名前を指定します。デフォルトでは、プラグインは_id
データが Amazon Personalize データの itemId と一致すると仮定します。 -
レシピ (必須) — 使用する Amazon Personalize レシピの名前を指定します。プラグインを使用するには、
aws-personalized-ranking-v2
または を指定できますaws-personalized-ranking
。 -
重み (必須) — レスポンスプロセッサが結果を再ランク付けする際にパーソナライゼーションを重視することを指定します。0.0 ~ 1.0 の範囲内の値を指定します。
1.0
に近いほど、Amazon Personalize の結果が上位にランクされる可能性が高くなります。0.0
を指定した場合、パーソナライズは行われず、OpenSearch が優先されます。 -
タグ (オプション) — プロセッサの識別子を指定します。
-
iam_role_arn (OpenSearch Service の場合は必須、オープンソース OpenSearch の場合はオプション) — OpenSearch Service の場合は、Amazon Personalize リソースにアクセスするための OpenSearch Service のアクセス許可を設定するときに作成したロールの Amazon リソースネーム (ARN) を指定します。OpenSearch Service リソースと Amazon Personalize リソースが異なるアカウントに存在する場合は、OpenSearch Service の
AssumeRole
アクセス許可を付与するロールを指定します。詳細については、「リソースが異なるアカウントにある場合のアクセス許可の設定」を参照してください。オープンソース OpenSearch の場合、複数のロールを使用して組織内のさまざまなユーザーグループのアクセス許可を制限する場合は、Amazon Personalize へのアクセス許可を持つロールの ARN を指定します。OpenSearch AWS キーストア内の 認証情報のみを使用する場合は、このフィールドを省略できます。
-
aws_region (必須) – Amazon Personalize キャンペーンを作成した AWS リージョン。
-
ignore_failure (オプション) — プラグインがプロセッサ障害を無視するかどうかを指定します。値には、
true
またはfalse
を指定します。本番環境では、クエリ応答が中断されないようにtrue
を指定することをお勧めします。テスト環境では、プラグインが生成するエラーをすべて表示するようにfalse
を指定できます。 -
external_account_iam_role_arn — OpenSearch Service を使用し、Amazon Personalize リソースと OpenSearch Service リソースが異なるアカウントに存在する場合は、Amazon Personalize リソースにアクセスするアクセス許可を持つロールの ARN を指定します。このロールは、Amazon Personalize リソースと同じアカウントに存在する必要があります。詳細については、「リソースが異なるアカウントにある場合のアクセス許可の設定」を参照してください。
OpenSearch Service のコードサンプルについては、「Amazon OpenSearch Service のパイプラインを作成する」を参照してください。オープンソースの OpenSearch の例については、「オープンソース OpenSearch でパイプラインを作成する」を参照してください。