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

# `personalized_search_ranking` レスポンスプロセッサのフィールド
<a name="opensearch-plugin-pipeline-fields"></a>

Amazon Personalize Search Ranking プラグインの検索パイプラインを作成するときは、以下のフィールドを使用して `personalized_search_ranking` レスポンスプロセッサを指定します。
+  **campaign\$1arn (必須)** — 結果のパーソナライズに使用する Amazon Personalize キャンペーンのAmazon リソースネーム (ARN) を指定します。
+  **item\$1id\$1field (オプション)** — 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\$1role\$1arn (OpenSearch Service の場合は必須、オープンソース OpenSearch の場合はオプション)** — OpenSearch Service の場合は、Amazon Personalize リソースにアクセスするための OpenSearch Service の[アクセス許可を設定する](opensearch-granting-access-managed.md)ときに作成したロールの Amazon リソースネーム (ARN) を指定します。OpenSearch Service リソースと Amazon Personalize リソースが異なるアカウントに存在する場合は、OpenSearch Service の `AssumeRole` アクセス許可を付与するロールを指定します。詳細については、「[リソースが異なるアカウントにある場合のアクセス許可の設定](configuring-multiple-accounts.md)」を参照してください。

  オープンソース OpenSearch の場合、複数のロールを使用して組織内のさまざまなユーザーグループのアクセス許可を制限する場合は、Amazon Personalize へのアクセス許可を持つロールの ARN を指定します。OpenSearch AWS キーストア内の 認証情報のみを使用する場合は、このフィールドを省略できます。
+ **aws\$1region (必須)** — Amazon Personalize キャンペーンを作成した AWS リージョン。
+ **ignore\$1failure (オプション)** — プラグインがプロセッサ障害を無視するかどうかを指定します。値には、`true` または `false` を指定します。本番環境では、クエリ応答が中断されないように `true` を指定することをお勧めします。テスト環境では、プラグインが生成するエラーをすべて表示するように `false` を指定できます。
+ **external\$1account\$1iam\$1role\$1arn** — OpenSearch Service を使用し、Amazon Personalize リソースと OpenSearch Service リソースが異なるアカウントに存在する場合は、Amazon Personalize リソースにアクセスするアクセス許可を持つロールの ARN を指定します。このロールは、Amazon Personalize リソースと同じアカウントに存在する必要があります。詳細については、「[リソースが異なるアカウントにある場合のアクセス許可の設定](configuring-multiple-accounts.md)」を参照してください。

 OpenSearch Service のコードサンプルについては、「[Amazon OpenSearch Service のパイプラインを作成する](managed-opensearch-plugin-pipeline-example.md)」を参照してください。オープンソースの OpenSearch の例については、「[オープンソース OpenSearch でパイプラインを作成する](opensearch-plugin-pipeline-example.md)」を参照してください。