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

Amazon Personalize Search Ranking プラグインの検索パイプラインを作成するときは、次のフィールドでpersonalized_search_rankingレスポンスプロセッサを指定します。

• campaign_arn (必須） — 結果をパーソナライズするために使用する Amazon Personalize キャンペーンの Amazon リソースネーム (ARN) を指定します。

• item_id_field (オプション） – のインデックス付きドキュメントの _idフィールド OpenSearch が Amazon Personalize に対応していない場合はitemIds、 が対応するフィールドの名前を指定します。デフォルトでは、プラグインは、_idデータが Amazon Personalize データ itemId 内の と一致することを前提としています。

• レシピ (必須) — 使用する Amazon Personalize レシピの名前を指定します。aws-personalized-ranking のみを指定できます。

• 重み (必須) — レスポンスプロセッサが結果を再ランク付けする際にパーソナライゼーションを重視することを指定します。0.0 ～ 1.0 の範囲内の値を指定します。1.0 に近いほど、Amazon Personalize の結果が上位にランクされる可能性が高くなります。を指定した場合0.0、パーソナライゼーションは発生せず、 OpenSearch が優先されます。

• タグ (オプション) — プロセッサの識別子を指定します。

• iam_role_arn ( OpenSearch サービスの場合は必須、オープンソースの場合はオプション OpenSearch） – OpenSearch サービスの場合は、Amazon Personalize リソースにアクセスするための OpenSearch アクセス許可を設定するときに作成したロールの Amazon リソースネーム (ARN) を指定します。 OpenSearch サービスと Amazon Personalize リソースが異なるアカウントに存在する場合は、 OpenSearch サービスにアクセスAssumeRole許可を付与するロールを指定します。詳細については、「リソースが異なるアカウントにある場合のアクセス許可の設定」を参照してください。

  オープンソース の場合 OpenSearch、複数のロールを使用して組織内の異なるユーザーのグループのアクセス許可を制限する場合は、Amazon Personalize へのアクセス許可を持つロールARNの を指定します。のみを使用する場合 AWS OpenSearch キーストアの 認証情報では、このフィールドを省略できます。

• aws_region (必須） – 。 AWS Amazon Personalize キャンペーンを作成したリージョン。

• ignore_failure (オプション) — プラグインがプロセッサ障害を無視するかどうかを指定します。値には、true または false を指定します。本番環境では、クエリ応答が中断されないように true を指定することをお勧めします。テスト環境では、プラグインが生成するエラーをすべて表示するように false を指定できます。

• external_account_iam_role_arn – OpenSearch サービスを使用していて、Amazon Personalize と OpenSearch サービスリソースが異なるアカウントに存在する場合は、Amazon Personalize リソースへのアクセス許可を持つロールARNの を指定します。このロールは、Amazon Personalize リソースと同じアカウントに存在する必要があります。詳細については、「リソースが異なるアカウントにある場合のアクセス許可の設定」を参照してください。

OpenSearch サービスコードのサンプルについては、「」を参照してくださいAmazon OpenSearch Service でのパイプラインの作成。オープンソース OpenSearch の例については、「」を参照してくださいオープンソースでのパイプラインの作成 OpenSearch。