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

# 在開放原始碼 OpenSearch 中建立管道
<a name="opensearch-plugin-pipeline-example"></a>

在叢集上安裝外掛程式之後，您就可以透過建立 OpenSearch 搜尋管道來設定外掛程式。

*搜尋管道*是一組請求和回應處理器，會依照您建立它們的順序依序執行。當您為外掛程式建立搜尋管道時，您可以指定`personalized_search_ranking`回應處理器。如需搜尋管道的相關資訊，請參閱[搜尋管道](https://opensearch.org/docs/latest/search-plugins/search-pipelines/index/)。

使用`personalized_search_ranking`回應處理器建立管道之後，您就可以開始將外掛程式套用至查詢。如需詳細資訊，請參閱[套用外掛程式](opensource-apply-plugin.md)。

您可以使用下列 curl 命令，在開放原始碼 OpenSearch 叢集上使用`personalized_search_ranking`回應處理器建立搜尋管道。如需每個`personalized_search_ranking`參數的完整說明，請參閱 [`personalized_search_ranking` 回應處理器的欄位](opensearch-plugin-pipeline-fields.md)。

```
curl -X PUT "http://localhost:9200/_search/pipeline/{{pipeline-name}}" -ku 'admin:admin' --insecure -H 'Content-Type: application/json' -d'
{
  "description": "A pipeline to apply custom re-ranking from Amazon Personalize",
  "response_processors" : [
    {
      "personalized_search_ranking" : {
        "campaign_arn" : "{{Amazon Personalize Campaign ARN}}",
        "item_id_field" : "{{productId}}",
        "recipe" : "aws-personalized-ranking-v2",
        "weight" : "{{0.3}}",
        "tag" : "{{personalize-processor}}",
        "iam_role_arn": "{{Role ARN}}",
        "aws_region": "{{AWS region}}",
        "ignore_failure": {{true}}
      }
    }
  ]
}'
```

使用`personalized_search_ranking`回應處理器建立搜尋管道之後，您就可以開始將外掛程式套用至 OpenSearch 查詢。您可以將其套用至 OpenSearch 索引或個別 OpenSearch 查詢。如需詳細資訊，請參閱[將 Amazon Personalize Search Ranking 外掛程式套用至開放原始碼 OpenSearch 中的查詢](opensource-apply-plugin.md)。