本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# `personalized_search_ranking` 响应处理器的字段
<a name="opensearch-plugin-pipeline-fields"></a>

为 Amazon Personalize 搜索排名插件创建搜索管道时，指定具有以下字段的 `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，提供您在为 OpenSearch Service [设置权限](opensearch-granting-access-managed.md)以访问 Amazon Personalize 资源时创建的角色的 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)。