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

# 將 Amazon Personalize Search Ranking 外掛程式套用至開放原始碼 OpenSearch 中的查詢
<a name="opensource-apply-plugin"></a>

您可以將 Amazon Personalize Search Ranking 外掛程式套用至 OpenSearch 索引的所有查詢和回應。您也可以將外掛程式套用至個別 OpenSearch 查詢和回應。
+  下列 curl 命令會將搜尋管道套用至本機執行的開放原始碼 OpenSearch 叢集中的 OpenSearch 索引。使用此方法，此索引的所有搜尋都會使用 外掛程式將個人化套用至搜尋結果。

  ```
  curl -XGET "https://localhost:9200/index/_settings" -ku 'admin:admin' --insecure -H 'Content-Type: application/json' -d'
  {
    "index.search.default_pipeline": "pipeline-name"
  }
  '
  ```
+ 下列 curl 命令會將搜尋管道套用至本機執行之開放原始碼 OpenSearch 叢集中索引上 Toyota 品牌車的個別查詢。

   針對 `user_id`，指定您要取得搜尋結果的使用者 ID。此使用者必須位於您用來建立 Amazon Personalize 解決方案版本的資料中。如果使用者不存在，Amazon Personalize 會根據其熱門程度對項目進行排名。對於 `context`，如果您使用內容中繼資料，請提供使用者的內容中繼資料，例如其裝置類型。此 `context` 欄位為選用。如需詳細資訊，請參閱[提高與內容中繼資料的建議相關性](contextual-metadata.md)。

  ```
  curl -XGET "http://localhost:9200/index/_search?search_pipeline=pipeline-name" -ku 'admin:admin' --insecure -H 'Content-Type: application/json' -d'
  {
    "query": {
      "multi_match": {
        "query": "Toyota",
        "fields": ["BRAND"]
      }
    },
    "ext": {
      "personalize_request_parameters": {
        "user_id": "USER ID",
        "context": { "DEVICE": "mobile phone" }
      }
    }
  }
  '
  ```

 若要了解結果如何重新排名，您可以使用 OpenSearch Dashboards 將 OpenSearch 結果與外掛程式的重新排名結果進行比較。如需詳細資訊，請參閱[將個人化 OpenSearch 結果與結果進行比較，無需個人化](opensource-comparing-results.md)。

 當您將外掛程式套用至 OpenSearch 查詢時，您可以透過取得 OpenSearch 管道的指標來監控外掛程式。如需詳細資訊，請參閱[使用開放原始碼 OpenSearch 監控外掛程式](opensource-monitor.md)。