personalized_search_ranking レスポンスプロセッサのフィールド - Amazon Personalize

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

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 でパイプラインを作成する」を参照してください。