---
title: About Smart Snippets
slug: l6eb0531
canonical_url: https://docs.coveo.com/en/l6eb0531/
collection: leverage-machine-learning
source_format: adoc
---
# About Smart Snippets
![Smart snippets example](https://docs.coveo.com/en/assets/images/leverage-machine-learning/smart-snippets.png)

[Coveo Machine Learning (Coveo ML)](https://docs.coveo.com/en/188/) [Smart Snippet](https://docs.coveo.com/en/laea5490/) [models](https://docs.coveo.com/en/1012/) provide users with answers to their [queries](https://docs.coveo.com/en/231/) directly on the results page by displaying a [snippet](https://docs.coveo.com/en/laeb0292/) of the most relevant result [item](https://docs.coveo.com/en/210/).
This allows users to quickly find answers without having to open links from the results page.

Specifically, Coveo ML Smart Snippet models scan the [items](https://docs.coveo.com/en/210/) returned by the [index](https://docs.coveo.com/en/204/) to find which one is the most relevant according to the query. This item is then pushed to the top of the results list in the main snippet section, and its result template displays the content that is the most likely to answer the query.

Coveo ML Smart Snippets also provides additional questions and topics in a "Related Content" (People also ask) section that users can click to find further information related to their query without leaving the results page.

Members with the [required privileges](https://docs.coveo.com/en/l6he0424#required-privileges) can [configure and manage](https://docs.coveo.com/en/l6he0424#create-a-smart-snippet-model) Coveo ML Smart Snippets.

## How Coveo ML Smart Snippets work

To provide users with the most relevant snippet of content, Coveo ML Smart Snippets leverage a machine learning algorithm that's backed by a large language model (LLM) to compute a similarity score between a user query and the headings of the items in a results list.
If the similarity score meets a predefined minimum [threshold](https://docs.coveo.com/en/l6eb0531#similarity-score-thresholds), Coveo ML Smart Snippets will use the content attached to the header that matches the user query, and renders the information in the related search result.

> **Tip**
>
> By default, content retrieval is supported only for English content.
> However, Coveo offers beta support for content retrieval in languages other than English.
> Learn more about [multilingual content retrieval and answer generation](https://docs.coveo.com/en/p5ne0024/).

> **Important**
>
> A Coveo ML Smart Snippet model returns snippets of content for HTML [items](https://docs.coveo.com/en/1965/) only.

> **Note**
>
> To avoid unrelated snippets, a Smart Snippet model will never return a main snippet result for a single-word query.
> However, the model will still return a related content (People also ask) section for a single-word query.

**Example**

In your support website, you have an FAQ page that is [configured to leverage Coveo ML Smart Snippets](https://docs.coveo.com/en/l6he0424/). The FAQs appear on the page as headers (within `<h2>` tags) whereas the answers appear in paragraphs (within `<p>` tags).

One of the FAQs that appears on the page is: `How to synchronize my Speedbit with my computer?`

A user accesses your support website's main page and enters the following query in the search bar: `Synchronizing Speedbit with computer`.

Since the Smart Snippet model calculated a high similarity score between the user query and the `How to synchronize my Speedbit with my computer?` header, the user obtains the FAQ page as the top result.
The result template also displays the content that appears in the paragraph attached to the `How to synchronize my Speedbit with my computer?` header on the FAQ page.

### Similarity score thresholds

Depending on the similarity score the model established between a query and the header of the items that appear in the results list, the model either displays the best snippet at the top of the results page, shows the snippet as a related question, or doesn't display the snippet at all.

The following table indicates the thresholds used by the model to determine whether to display a snippet:

[cols="2",options="header"]
|===
|Similarity score
|Result

|0.7 and above
|The answer is displayed as a snippet at the top of the results page.

|Between 0.5 and 0.7 (0.7 excluded)
|The answer is displayed as a related question.

|Below 0.5 (0.5 excluded)
|The answer is not displayed by the model.
|===

> **Notes**
>
> * These thresholds cannot be changed.
> 
> * You can [inspect the similarity score](https://docs.coveo.com/en/l6eb0531#inspect-similarity-scores) that was computed by the model for a given snippet.

#### Inspect similarity scores

You can inspect the score computed for a given snippet by inspecting the call to the Search API:

. Access a [search interface which contains the required components](https://docs.coveo.com/en/l8ve0354/), and in which the traffic is directed to the query pipeline that you [associated with your Coveo ML Smart Snippet model](https://docs.coveo.com/en/l6he0309/).

. [Access your browser's network monitoring tool](https://docs.coveo.com/en/mc2g0297#access-your-browsers-network-monitoring-tool).

. In the search box, perform a query that would likely trigger a snippet to appear in the search results.

. In the network monitoring tool, under the **Name** column, select the latest request to the Search API.
The request path should contain `/rest/search/v2`.

. Select the **Preview** tab.

. Find and expand the [`questionAnswer`](https://docs.coveo.com/en/l9le0392#search-api-response-reference) property.
It provides detailed information about the model's output for this specific query.
This property won't appear if the model can't provide snippets for the current query.

. You can now inspect the similarity score that the model gave to the displayed snippets:

** To inspect the score of the top snippet, look at the `score` value.

![Search API response for a smart snippet model](https://docs.coveo.com/en/assets/images/leverage-machine-learning/ss-main-score.png)

** To inspect the score of the related questions for the same query:

... Expand the `relatedQuestions` property.

... You should now see the list of headers for which the model can provide snippets.
Expand the desired `question` property, and then inspect the associated `score` value.

![Search API response for a smart snippet model](https://docs.coveo.com/en/assets/images/leverage-machine-learning/ss-related-question-score.png)