

# Creating a pipeline in open source OpenSearch
<a name="opensearch-plugin-pipeline-example"></a>

After you install the plugin on your cluster, you're ready to configure it by creating an OpenSearch search pipeline. 

A *search pipeline* is a set of request and response processors that run sequentially in the order that you create them. When you create a search pipeline for the plugin, you specify a `personalized_search_ranking` response processor. For information about search pipelines, see [Search pipelines](https://opensearch.org/docs/latest/search-plugins/search-pipelines/index/). 

After you create a pipeline with a `personalized_search_ranking` response processor, you are ready to start applying the plugin to queries. For more information, see [Applying the plugin](opensource-apply-plugin.md). 

You can use the following curl command to create a search pipeline with a `personalized_search_ranking` response processor on an open source OpenSearch cluster. For a complete explanation of each `personalized_search_ranking` parameter, see [Fields for the `personalized_search_ranking` response processor](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": "{{Amazon region}}",
        "ignore_failure": {{true}}
      }
    }
  ]
}'
```

After you create a search pipeline with a `personalized_search_ranking` response processor, you're ready to start applying the plugin to OpenSearch queries. You can apply it to an OpenSearch index or an individual OpenSearch query. For more information, see [Applying the Amazon Personalize Search Ranking plugin to queries in open source OpenSearch](opensource-apply-plugin.md). 