Query Pipeline Management
- What's a Query Pipeline
- Routing Mechanisms and Rules
- Deployment Overview
- Order of Execution of Query Pipeline Features
- Troubleshooting Query Pipeline Rules
- Coveo ML Model Association Management
- Associate a Model via a JSON Configuration
- Thesaurus Rule Management
- Featured Results Rule Management
- Stop Words Rule Management
- Ranking Expressions Rule Management
- Ranking Weights Rule Management
- Triggers Rule Management
- Filters Rule Management
- Query Parameters Rule Management
- Query Pipeline Rule Management
- Coding Query Pipeline Rules
- Testing Changes
- Exporting and Importing Query Pipeline Elements
Testing Query Pipeline Changes
Query pipelines and their rules are very powerful tools allowing you to manage many query situations with great flexibility, but this flexibility may become overwhelming complexity.
Take advantage of the query pipeline A/B Testing feature to partially put the modification in production, allowing you to evaluate the effect on real queries made by real users.
To test query pipeline changes
Create a test pipeline to be used only for test purposes, if not already done.
You can duplicate your production pipeline, the one used by the search interface to which you want to make a change (see Adding and Managing Query Pipelines). This way, the only difference between the production and the test pipeline will be the change you’ll make. Rename the duplicated pipeline to something meaningful.
You duplicate your Community pipeline and rename the duplicate as Community_TEST_duplicate_yyyy-mm-dd so you’ll know when it was duplicated and maybe delete it when outdated, rather creating a new duplicate.
Make the desired specific change to your test pipeline rules, if not already done (see Adding and Managing Query Pipelines).
Quickly test your pipeline change in the Content Browser:
Perform a query that would meet the condition to make your change visible. Because the search page is still using the production pipeline, the change shouldn’t be visible.
In the browser address box, add the
pipeline=query string parameter followed by the name of your test pipeline, and then run the query again. This time, the query will go through your test pipeline. This method only affects your queries, not anyone else. Depending on the query parameter position, prefix
pipeline=is the first query parameter, prefix it with
pipeline=is NOT the first query parameter, prefix it with
pipeline=query string parameter must be before the
#in the URL:
Perform the same query that meets the condition to make your change visible and ensure that it behaves as expected.
When you’re satisfied with your change, consider first testing your change on a fraction of the production traffic using A/B Testing (see Adding and Managing A/B Tests).
Consider creating and using a usage analytics report to compare key metrics for the A and B query pipeline and confirm the improvement over a given period (see Analyzing the Performance of Pipeline A Vs Pipeline B).
When you’re entirely sure you want to bring your change to the production pipeline, copy the changed rule from the test pipeline (B) to the production pipeline (A) (see Copy a Rule to Another Pipeline).
pipeline=query string parameter from the search page URL, and then perform the same query that meets the condition. This makes your change visible, allowing you to ensure that the search page behaves as expected.