Set Default Pipeline

You can update your pipeline in production without any downtime. Use the set default pipeline endpoint to seamlessly direct all traffic to a new pipeline.

About This Task

You can set a pipeline as the default for your search by using the Set Default Pipeline endpoint. Once you do this, you can simply use default as the pipeline name in the Search endpoint. No additional work or app changes are required on your part.

This option gives you the flexibility to change the pipeline you use for search in production at any time without disrupting your service. For example, if you need to tweak the pipeline used in production, you can create and test a new one in the background. When it's ready, simply set it as the default pipeline to smoothly redirect traffic to it.

Change the Default Pipeline

  1. Create a pipeline that will replace the pipeline currently running in production.
  2. Deploy the new pipeline.
    We recommend verifying this pipeline's performance by sharing it with other users and collecting feedback.
  3. Use the set default pipeline API endpoint to indicate that you want to use the newly created pipeline in production. This simply routes all queries to the new pipeline without any interruptions.
  4. When using the endpoints for search, such as Search, Search Stream, Chat, or Chat Stream, set the pipeline name to default in the URL, for example: https://api.cloud.deepset.ai/api/v1/workspaces/my_workspace/pipelines/default/search.