Previewing AI Search results
To evaluate search engine results or review specific outcomes for a customer, utilize the Preview feature within the AI Search Engine. Additionally, you have the option to compare results from two different indices.

Requirements
Select the attributes for preview in the AI engine configuration for the catalog you use for AI Search.
Previewing search results
-
Go to
AI Search > Indexes.
-
Select an index from the list.
-
Go to the Preview section.
-
In the search box, type any phrase to see the results you get from particular words.
-
To see the an item for a specific customer, in the upper-right corner, click Additional setup.
Result: A pop-up appears.Pop-up that lets you select a customer for whom the search results will be generated and select a suggestion index -
In the Customer context section, from the Add customer dropdown list, select the customer for whom the preview of search results will be generated.
-
Optionally, from the Suggestion index section, you can select index of suggestions which will be applied in the preview.
Tip: Suggestions are created to enhance the user search experience by providing real-time, relevant queries or query completions that guide users toward successful search results more efficiently. -
Confirm by clicking Apply.
Previewing item details

-
You can set the preview attributes by clicking Edit preview attributes. By changing the preview attributes, you can control the attribute values that will appear in the preview. More information about attributes for preview is available here.
Note: This setting is mutual for the Recommendation preview as well as the AI Search Engine preview. -
Item ranking statistics:
- Item ranking position - The place where an item appears in the list of search results, with 1 being the top position.
- Item score - A numerical value that shows how well an item matches the search query, determining its relevance.
- Ranking sorting type - The method used to order search results, such as by relevance, date, or popularity.
Item score details tab
This section provides an overview of how search relevance has been determined for an item.

-
Textual relevance - indicates how closely a user’s search term matches the text in item attributes such as the title, description, and other related fields. Higher scores are assigned to words that appear often, naturally, and meaningfully within these attributes.
-
Main score factors - you can see how each factor individually affects the score of the item shown in the search results. You can adjust the overall influence of these factors in the Ranking section of the index settings.
-
Boosted attributes - you can view the rules that caused the attribute’s score to increase, along with how much each rule boosted it.
-
Dynamic re-ranker - you can see a preview of how the dynamic re-ranker changed the score of the item shown in the search results.
Searchable attributes match tab
This section of the item preview displays the specific attributes that matched the user’s search query. It highlights the data segments recognized as matches, with underlined phrases indicating synonyms. This feature helps you understand why a particular item appeared in the search results and enhances transparency by revealing which attributes influenced the outcome.

Comparing indices
Comparing indices allows you to assess results they return. Before entering any search query, you can apply filters within each index.
-
Click Compare results.
Result: A pop-up appears. -
From the Select index dropdown list, select the index with which you want to compare the index you’re previewing.
-
Confirm your choice by clicking Apply.
Result:Comparing index 1 and index 2 -
In the search box, enter a query so you can compare the results produced by each index.
Query and ranking details
Query and ranking details extend the search preview with transparent insights into the generation of search results, including query transformations, applied rules, filters, sorting details. Its purpose is to improve satisfaction by making search results more explainable and transparent, helping you understand the mechanics of generating results. It aims to improve transparency and simplify debugging for you.
Query and ranking details are available for all search methods (hybrid, keywords, semantic).
Query details
In the Query details section, which is available after performing a search request, you can review the modifications made to the original search phrase in a search query. Several factors contribute to these modifications:

-
General overview - This section provides an overview how the original search phrase has been changed due to rules, synonyms, and suggestions from the search engine, focusing specifically on numbers.
- Phrase typed by a user - This is original search phrase entered by the user.
- Final searched phrase - This is the final phrase for which the search request was made; it’s changed as a result of applying rules, synonyms, and suggestions from the search engine.
- Query rules that have changed phrase - This section shows how many rules have been applied to the original phrase.
- Used synonyms - This section shows how many synonyms were searched and their results added to the search results.
-
Query transformation - This section shows a list of applied rules to the original searched phrase. The rules provide IF - THEN logic that lets you influence the search results. This way you can manage the behavior of the search engine by telling it to promote specific products, replace the query or a word in the query or remove a word from it in specific circumstances.
- The condition that has been met - This column shows the rule condition met by the original query.
- Consequence - This column shows what changes have been made to the original searched phrase.
-
Used synonyms - This section shows a list of applied two-way synonyms to the original searched phrase. Two-way synonyms work in two directions. For example, if “telephone”, “smartphone”, and “phablet” are two-way synonyms, searching for “smartphone” or “phablet” also shows the results for “telephone”.
Ranking details
In the ranking details section, you can check how the rules, sorting and ranking settings have impacted the listing of search results.

-
General overview:
- Items found - This section shows the total number of items that matched the query (including hidden items; an item can be hidden as a consequence of the applied rules).
- Hidden items - This section shows the number of all items that are hidden as a result of the rules applied to the searched phrase.
- Promoted items - This section shows the number of items promoted as a result of the rules applied to the searched phrase.
- Ranking sorting type - This section shows the method of sorting search results. This value is definable in Sortable attributes of the index settings.
The preview of Overall details -
Hidden items - This section shows a list of items (name and item ID) hidden from the results. Items can be hidden due to query rules.
-
Search results filters - This section shows a list of rules whose consequence is Filter query results. The Conditions column shows the conditions of the rule and the Consequences column shows the changes that are made to the results.
-
Boosted attributes - This section shows a list of rules whose consequence is Boost by attribute. The Conditions column shows the conditions of the rule and the Consequences column shows the changes that are made to the results.