本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# `personalized_search_ranking` 回應處理器的欄位
<a name="opensearch-plugin-pipeline-fields"></a>

當您為 Amazon Personalize Search Ranking 外掛程式建立搜尋管道時，您可以使用下列欄位指定`personalized_search_ranking`回應處理器。
+  **campaign\$1arn （必要）** – 指定 Amazon Personalize 行銷活動的 Amazon Resource Name (ARN)，以用於個人化結果。
+  **item\$1id\$1field （選用）** – 如果 OpenSearch 中索引文件`_id`的欄位未與您的 Amazon Personalize itemIds 對應，請指定該欄位的名稱。根據預設，外掛程式會假設`_id`資料符合 Amazon Personalize 資料中的 itemId。
+  **配方 （必要）** – 指定要使用的 Amazon Personalize 配方名稱。若要使用 外掛程式，您可以指定 `aws-personalized-ranking-v2`或 `aws-personalized-ranking`。
+ **weight （必要）** – 指定回應處理器在重新排序結果時對個人化所強調的重點。指定 0.0–1.0 範圍內的值。越接近`1.0`它，Amazon Personalize 排名越高的可能性就越高。如果您指定 `0.0`，則不會發生個人化，且 OpenSearch 優先。
+ **tag （選用）** – 指定處理器的識別符。
+ **iam\$1role\$1arn (OpenSearch Service 需要，開放原始碼 OpenSearch 為選用）** – 針對 OpenSearch Service，提供您在[設定 OpenSearch Service 存取 Amazon Personalize 資源的許可](opensearch-granting-access-managed.md)時所建立之角色的 Amazon Resource Name (ARN)。 OpenSearch 如果您的 OpenSearch Service 和 Amazon Personalize 資源存在於不同的帳戶中，請指定授予 OpenSearch Service `AssumeRole`許可的角色。如需詳細資訊，請參閱[當資源位於不同帳戶時設定許可](configuring-multiple-accounts.md)。

  對於開放原始碼 OpenSearch，如果您使用多個角色來限制組織中不同使用者群組的許可，請指定具有存取 Amazon Personalize 許可的角色 ARN。如果您僅使用 AWS OpenSearch 金鑰存放區中的登入資料，您可以省略此欄位。
+ **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)。