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
Managing Query Pipeline Featured Results
The top results associated with your Coveo™ Cloud organization is a list of rules to ensure the results you want to promote appear at the top of the search results list when the query matches or contains a specific expression. You can use the Featured Results tab to improve search result relevance, leading users towards the item(s) most likely to satisfy the users needs (see Who Can Perform the Page Actions). You can also decide to always place a certain item on top of the results list regardless of the user query.
When managing featured result(s) rules, consider the following recommendations and tips:
Unless you want to promote specific items regardless of the user query, always add a condition to a promoted result rule.
Featured result rules are effective the moment they are saved. Adding rules without at least a condition can have a negative impact on the search results relevance.
You decide to promote results containing
Bravia user guidewithout any condition. A user wants to know where to buy a Sony tablet. By performing the query
Sony tablet points of sale, the user would first see results regarding Bravia TV user guides before any other results.
You can decide which results appear first when your users access your search interface or performed an empty query.
You want your most popular products to appear on top of the search results list, so you promote the URI of related items.
When a query pipeline contains Coveo Machine Learning (Coveo ML) models, avoid or minimize the use of featured result(s) rules. Featured result(s) rules are static and can thus negatively impact Coveo ML models which follow trends. Therefore, create featured result(s) rules with caution.
Access the “Featured Results” Tab of a Pipeline
If not already done, log in to your Coveo Cloud Organization with an Admin or Relevance Analyst user role account.
In the navigation menu on the left, under Search Optimization, select Query Pipelines.
In the Query Pipelines page, access the query pipeline in which you find the featured result(s) rules you want to manage by clicking a pipeline under the Name column.
In the selected pipeline page, select the Featured Results tab.
Manage Query Pipeline Featured Results
In the Featured Results tab, you can add a new featured result(s) rule (see Access the Featured Results Tab of a Pipeline):
Access the Add a Featured Result Rule dialog, click Add Rule.
In the Add a Feature Result Rule dialog:
Since you can decide the content your users first see when they access your search interface or do an empty query, you promote your most popular and general topic. Using the item URI, you make the topic appears on top of the search results list.
when $query is `@uri` then top `@urihash="dmov5JaJrXDEW90Z"`
By default, when a search is launched and the search box is empty, the
@uriquery is performed, returning all items. The same query is performed when a user accesses a Coveo search interface.
Click Select an item.
The Content Browser appears on the screen.
In the Content Browser, search and then select the item you want to promote.
The URI of the item appears in the Item URI box.
Select an operator (Contains, Matches, or Is), and then enter an expression in the second box that will trigger the featured result(s) rule previously entered if the condition you will establish next in step 4 is respected.
Before the featured result(s) rule is applied:
When you select the Is operator, the user query must be the exact expression you enter in the box.
(For advanced users) When you select the Matches operator, the user query must match the regular expression (regex) you enter in the box.
You want to always have a specific article at the top of the search results when a user opens your Knowledge Base search page, so you provide the following regex:
When you select the Contains operator, the expression you enter in the box must be a part of the user query.
The promoted result(s) rule is effective the moment it is saved.
For developers, you can also directly enter a rule that respects the Query Pipeline Language (QPL) syntax for featured results referred to as top results in the Developers documentation (see Top Results):
In the Featured Results tab, click Add Rule with Code.
In the Add a Rule in QPL dialog, in the form editor box, enter a top results rule.
The item you promote must be in your Coveo Cloud organization index.
When you want the featured result to only be displayed when matching the search interface scope, facet selection, and other hidden or user selected filters, set the
By default, featured results are typically not distinguishable from other results in search interfaces. If a featured result is an item outside of the expected scope, users may be confused or even think that there are bugs in the search interface.
A user is looking for a Coveo for Salesforce component, and a Coveo for Sitecore item (that is used in a featured result rule) is the first result returned. Since the related featured result rule is set to match the advanced query, if the user selects Coveo for Salesforce in the Product facet, he will no longer see the Coveo for Sitecore item in the search results.
In the Featured Results tab, click the Actions icon () next to the rule you want to modify, and then select Edit QPL.
In the Edit a Rule in QPL dialog, add the following string next to your
topquery pipeline statement:
with matchAdvancedQuery: true
top \`@urihash="3eXEhu37oF4NiyM4"\` with matchAdvancedQuery:true
You can perform other actions on rules (see Managing Query Pipeline Rules and Conditions From Tabs).
You can link a condition to a rule (see Managing Query Pipeline Conditions).
Adding featured result(s) rules without at least a condition can have a negative impact on the search results relevance.
In the search interface(s) for your Coveo Cloud organization, test your featured result(s) rule to ensure that it improves search result relevance. Make adjustments when needed.
You can use the Content Browser search interface to test your top result(s) rules.
Navigate Through Featured Result Rule Pages
In the Featured Results tab, at the bottom-right of the table, click the left and right arrow icons, or a page number to navigate through pages (see Access the Featured Results Tab of a Pipeline).
Set the Number of Featured Result Rules per Page
In the Featured Results tab, at the bottom-left of the page, select 10 or 100 (see Access the Featured Results Tab of a Pipeline).
By default, the table shows 10 rules per page.
Who Can Perform the Page Actions
The required roles are: