Managing Query Pipelines
- What Is a Query Pipeline
- Routing Mechanisms and Rules
- Deployment Overview
- Adding Coveo ML Automatic Relevance Tuning Models
- Adding Coveo ML Query Suggestions Models
- Adding Coveo ML Recommendations Models
- Editing a Coveo ML Model Without Service Interruption
- Managing Thesaurus
- Managing Featured Results
- Managing Stop Words
- Managing Ranking Expressions
- Managing Ranking Weights
- Managing Triggers
- Managing Filters
- Managing Query Parameters
- Managing Rules and Rule Conditions
- Coding Query Pipeline Rules
- Leveraging Custom Context Information in Salesforce
- Testing Changes
- Exporting/Importing Between Organizations
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
If not already done, create a test pipeline to be used only for test purposes.
You can simply duplicate your production pipeline, the one used by the search interface to which you want to make a change (see Managing Query Pipelines). This way, the only difference between the production and the test pipeline will be the change you will 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 will know when it was duplicated and maybe delete it when outdated, rather creating a new duplicate.
If not already done, make the desired specific change to your test pipeline rule(s) (see Managing Query Pipelines).
Quickly test your pipeline change in the Content Browser:
In the Query Pipelines page, at the end of the row for the pipeline that you want to test, click the Actions icon (), and then select Open in Content Browser.
In the Content Browser page, perform queries to validate the change you made to this specific pipeline.
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 should not 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.
When it is the first query parameter after the page host name and path:
When it is not the first query parameter after the page host name and path:
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 are satisfied with your change, consider first testing your change on a fraction of the production traffic using A/B Testing (see 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 are entirely sure you want to bring your change to the production pipeline, swap your production (A) pipeline with your test (B) pipeline (see Managing Query Pipelines).
You can also copy the changed rule from the B to the A pipeline (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.