Review Coveo Machine Learning Model Information

The Information tab of a model allows members with the required privileges to understand the learning process of a specific Coveo Machine Learning (Coveo ML) model. You can use this tab to review model information, such as the number of items known per search hub and samples of the top user queries.

To access the Information tab, access the Models (platform-eu | platform-au) page of the Coveo Administration Console, click the desired model, and then click Open in the Action bar.

"Error" Section

If the status of your model is Degraded or Failed, an Error section is displayed under the Information tab. This section contains additional information to help you troubleshoot your Coveo ML model.

error section

Filter Information by Language

You can review language specific information and statistics such as the number of candidates and candidate examples to ensure that the model is behaving as expected (see Reference).

On the subpage of your model, under Language, click the drop-down menu, and then select the desired language.

Reference

On the subpage of your model, you can review model candidates, fields, associated pipelines, and statistics, depending on the model type.

Automatic Relevance Tuning (ART)

ART "General" Section

Information Definition

Model type

The type of model the user is inspecting.

Model ID

The unique identifier of the model.

Content ID keys

The field used by the model to identify index items (e.g., urihash, permanentid, etc.)

Note

If some of the information listed in the table doesn’t appear in the General section, it’s because this information isn’t available for your model.

ART "Associated Pipelines" Section

Next to each pipeline card, you can click Menu, and then select one of the following options:

  • Edit association

  • Dissociate

Depending on your selection:

  • If you selected Edit association, on the Edit a Model Association subpage, make the desired changes, and then click Save (see ART Advanced Configuration Options).

  • If you selected Dissociate, in the Dissociate From Pipeline dialog, click Dissociate model.

ART "Model Building Statistics" Section

Statistic Definition

Search events

The total number of search events used in the model creation.

Click events

The total number of click events used in the model creation.

Visits

The total number of visits used in the model creation.

Learned queries

The number of unique queries for which the model can recommend items.

ART "Language" Section

When reviewing this section, use the drop-down menu to filter information by the languages for which the model can make recommendations.

Statistic Definition

Learned queries

The number of unique queries for which the model can recommend items per language.

Top queries

The sample of the top queries (maximum 10) for which the model could recommend items.

Known words

The nomber of words known by the model.

Items per filter value

The number of items that can be recommended, for each filter (e.g., country, region, hub, interface, tab) known by the model, for a query.

Stop words

The number of words removed from user queries before recommending items.

Content Recommendations (CR)

CR "General" Section

Information Definition

Model type

The type of model the user is inspecting.

Model ID

The unique identifier of the model.

Content ID keys

The field used by the model to identify index items (e.g., urihash, permanentid, etc.)

Learned recommendations

The number of unique events that the model can recommend.

Learned recommendations per language

The number of items that can be recommended per language.

Possible recommendations per context key

The sample of the top queries for which the model could recommend items for each listed context key.

Note

If some of the information listed in the table doesn’t appear in the General section, it’s because this information isn’t available for your model.

CR "Associated Pipelines" Section

Next to each pipeline card, you can click Menu, and then select one of the following options:

  • Edit association

  • Dissociate

Depending on your selection:

  • If you selected Edit association, on the Edit a Model Association subpage, make changes to the applied Condition, and then click Save.

  • If you selected Dissociate, in the Dissociate From Pipeline dialog, click Dissociate model.

CR "Model Building Statistics" Section

Statistic Definition

Search events

The total number of search events used in the model creation.

Click events

The total number of click events used in the model creation.

View event count

The total number of view events used in the model creation.

Query Suggestions (QS)

QS "General" Section

Information Definition

Model type

The type of model the user is inspecting.

Model ID

The unique identifier of the model.

Suggestions per filter

The number of queries that can be suggested for each filter (e.g., country, region, hub, interface, tab) known by the model.

Context keys

The context keys that the model can use to provide personalized query suggestions.

Note

If some of the information listed in the table doesn’t appear in the General section, it’s because this information isn’t available for your model.

QS "Associated Pipelines" Section

Next to each pipeline card, you can click Menu, and then select one of the following options:

  • Edit association

  • Dissociate

Depending on your selection:

  • If you selected Edit association, on the Edit a Model Association subpage, make changes to the applied Condition, and then click Save.

  • If you selected Dissociate, in the Dissociate From Pipeline dialog, click Dissociate model.

QS "Model Building Statistics" Section

Statistic Definition

Search events

The total number of search events used in the model creation.

Click events

The total number of click events used in the model creation.

Learned suggestions

The number of unique queries that the model can suggest.

QS "Language" Section

When reviewing this section, use the drop-down menu to filter information by the languages for which the model can make recommendations.

Statistic Definition

Minimum click count

The minimal number of clicks on a query suggestion that’s required for a candidate to remain in the model. The minimum is determined automatically depending on the language and the query count (see the reference table in Reviewing Coveo Machine Learning Query Suggestion Datasets).

Learned suggestions

The number of unique queries that the model can suggest.

Top suggestions

The sample of the top queries (maximum 10) that the model could suggest.

Dynamic Navigation Experience (DNE)

DNE "General" Section

Information Definition

Model type

The type of model the user is inspecting.

Model ID

The unique identifier of the model.

Note

If some of the information listed in the table doesn’t appear in the General section, it’s because this information isn’t available for your model.

DNE "Associated Pipelines" Section

Next to each pipeline card, you can click Menu, and then select one of the following options:

  • Edit association

  • Dissociate

Depending on your selection:

  • If you selected Edit association, on the Edit a Model Association subpage, make the desired changes, and then click Save (see DNE Advanced Configuration Options).

  • If you selected Dissociate, in the Dissociate From Pipeline dialog, click Dissociate model.

DNE "Model Building Statistics" Section

Statistic Definition

Search events

The total number of search events used in the model creation.

Click events

The total number of click events used in the model creation.

Visits

The total number of visits used in the model creation.

Facet selection events

The total number of facet selection events used in the model creation.

Learned queries

The number of unique queries for which the model can recommend items.

DNE "Language" Section

When reviewing this section, use the drop-down menu to filter information by the languages for which the model can make recommendations.

Information Definition

Learned queries

The number of unique queries per language for which the model can recommend items per language.

Top facets

The sample of the top facets per language for which the model can automatically select and reorder values.

Facets per filter value

The number of items that can be recommended, for each filters (e.g., country, region, hub, interface, tab) known by the model per language.

DNE "Facet Autoselect" Section

You can review information about the behavior of the Facet Autoselect feature for a specific DNE model.

  1. On the Models (platform-eu | platform-au) page, click the DNE model for which you want to review information about the Facet Autoselect feature, and then click Open in the Action bar.

  2. On the page that opens, select the Configuration tab.

  3. In the Facet Autoselect section, you can review the following information:

    • Whether the Facet Autoselect feature is enabled for the model that you are inspecting.

    • The Facet (fields) to which the automatic selection of facet values apply.

    • The Sources in which the items matching the selected Facets are taken into account by the Facet Autoselect feature.

Product Recommendations (PR)

PR "General" Section

Information Definition

Model type

The type of model the user is inspecting.

Model ID

The model unique identifier used to troubleshoot issues (if any).

Content ID keys

The field used by the model to identify index items (e.g., urihash, permanentid, etc.)

Note

If some of the information listed in the table doesn’t appear in the General section, it’s because this information isn’t available for your model.

PR "Associated Pipelines" Section

Next to each pipeline card, you can click Menu, and then select one of the following options:

  • Edit association

  • Dissociate

Depending on your selection:

  • If you selected Edit association, on the Edit a Model Association subpage, make changes to the applied Condition, and then click Save (see PR Strategies Options).

  • If you selected Dissociate, in the Dissociate From Pipeline dialog, click Dissociate model.

PR "Model Building Statistics" Section

This section shows the total number of event types used to build the model. The higher the numbers are for each event type, the better.

"General events" Section
Statistic Definition

Search events

The total number of search events used in the model creation.

Click events

The total number of click events used in the model creation.

View events

The total number of view events used in the model creation.

Custom events

The total number of custom events used in the model creation.

"Commerce events" Section
Statistic Definition

Product details views

The total number of detailView events used in the model creation

Purchased products

The total number of addPurchase events used in the model creation.

Product quick views

The total number of productQuickView events used in the model creation.

PR "Strategy statistics" Section

This section shows key statistics for all strategies used by the model.

To see key statistics for a specific strategy, under Strategy statistics, in the drop-down menu, select the desired strategy.

Cart Recommender

If you selected the Cart recommender strategy, the following information is available:

Statistic Definition

Most recommended SKUs

Sample lists of product SKUs contained in the top shopping carts that the model can recommend.

Recommended products

The number of items that the model can recommend.

Other PR Strategies

If you selected the User recommender, Frequently viewed together, Frequently bought together, Popular items (viewed), or Popular items (bought) strategy, the following information is available:

Statistic Definition

Most recommended SKUs

A sample of the top product SKUs known by the model.

Recommended products

The number of items that the model can recommend.

Smart Snippets

Smart Snippets "General" Section

Information Definition

Model type

The type of model the user is inspecting.

Model ID

The unique identifier of the model.

Model version

The version of the model followed by the date of the model’s last update in UNIX timestamp format.

Engine version

The version number of the learning algorithm that was used to build the model.

Note

If some of the information listed in the table doesn’t appear in the General section, it’s because this information isn’t available for your model.

Smart Snippets “Associated Pipelines” Section

Next to each pipeline card, you can click Menu, and then select one of the following options:

  • Edit association

  • Dissociate

Depending on your selection:

  • If you selected Edit association, on the Edit a Model Association subpage, make changes to the applied Condition, and then click Save.

  • If you selected Dissociate, in the Dissociate From Pipeline dialog, click Dissociate model.

Smart Snippets “Model Building Statistics” Section

Statistic Definition

Item count

The total number of items used by the model to extract snippets.

Snippet count

The total number of snippets extracted by the model.

Header count

The total number of HTML headers used by the model to extract questions.

Average number of words per snippet

The average snippet length.

Case Classification (CC)

CC "General" Section

Information Definition

Model type

The type of model the user is inspecting.

Model ID

The unique identifier of the model.

Model version

The version of the model followed by the date of the model’s last update in UNIX timestamp format.

Engine version

The version number of the learning algorithm that was used to build the model.

Content ID keys

The field used by the model to identify index items (e.g., urihash, permanentid, etc.)

Note

If some of the information listed in the table doesn’t appear in the General section, it’s because this information isn’t available for your model.

CC "Model Performance" Section

The Model performance section indicates the model’s capacity to predict values for specific index fields.

To achieve this, the model applies classifications on the Test data set, and then compare the results with the classifications that were manually assigned by previous users and learned by the model when building on the Training data set.

Since the model learned from manual classifications during its training phase, it learned which classifications were right for a given case.

By attempting to provide classifications on the Test data set, which was ignored by the model during its training phase, the model can compare the attempted classifications to those that were manually classified by previous users on the Training data set.

In the Model performance section, this information is displayed in the Top prediction is correct and Correct prediction in top 3 columns.

screen capture of the statistics table

The Top prediction is correct column indicates the percentage of time the model’s top value prediction was the same as what the model learned from the Training data set.

The Correct prediction in top 3 column indicates the percentage of time one of the model’s top 3 value predictions matches the value learned from the Training data set.

CC "Data Sets Distribution" Section

During its training phase, the model splits all available cases into two data sets: the training data set and the test data set.

The model’s training data set represents 90% of all the cases that were selected when configuring the model. The model builds on this segment to learn from the classifications that were manually applied by previous users.

The model’s test data set represents the other 10% of the cases that were selected when configuring the model. Unlike the training data set, the model doesn’t use the information contained in these cases to train itself. This data set is rather used to evaluate the model performance.

The Data sets distribution section lists the index fields for which the model learned classifications for.

This information is displayed in the Training data set and Test data set columns.

screen capture of the statistics table

The Training data set column indicates the number of cases containing a specific field that was used to train the model.

The Test data set column indicates the number of cases that contain this specific field in the model’s test data set.

Each row of this table can be expanded to obtain further information about the values that the model can predict for a specific index field.

When expanding a specific row, the Sample value distribution column lists the values that can be predicted for a specific field (e.g., product_type), along with the number of times a specific value was used to classify available cases in both the Training data set and the Test data set.

screen capture of the statistic table

Required Privileges

By default, members of the Administrators and Relevance Managers built-in groups can view and edit elements of the Models (platform-eu | platform-au) page.

The following table indicates the privileges required to use elements of the Models page and associated panels (see Manage Privileges and Privilege Reference).

Action Service - Domain Required access level

View models

Machine Learning - Models
Organization - Organization
Search - Query pipelines

View

Edit models

Organization - Organization
Search - Query pipelines

View

Machine Learning - Models

Edit