Manage the Coveo Machine Learning Model Associations With Query Pipelines

When a Coveo Machine Learning (Coveo ML) model has been created, it must be associated with a query pipeline to be effective in a search interface.

Organization members with the required privileges can access the Machine Learning tab of a query pipeline configuration page to manage Coveo ML model associations for that query pipeline.

Leading Practices

Duplicate the Production Query Pipeline

  1. Once you have created a Coveo ML model, the leading practice is to duplicate the query pipeline with which you plan to associate the model, and then associate the model with the pipeline copy.

  2. Once satisfied with the model efficiency on the pipeline copy, dissociate the model from the test pipeline and associate it with the production pipeline. You can test your Coveo ML models efficiency by performing A/B tests or model testings.

  3. Delete the test pipeline.

Validate That the Model Is Effective

To validate that your Coveo ML models work as expected, you can inspect your models.

Plan the Usage of Custom Contexts to Improve the Model Relevance

While the various Coveo ML features can perform well without custom context information, using custom contexts can take Coveo ML relevance one step further.

You can define custom contexts and then pass appropriate ones along with usage analytics events and queries to allow Coveo ML to take them into account.

If you’re just starting using Coveo ML in your solution, you can skip this step to take advantage of Coveo ML features more quickly and easily, and consider using custom contexts in a second phase.

Associate a Model With a Query Pipeline

The process of associating a Coveo ML model with a query pipeline differs depending on which Coveo ML feature you want to associate. Click one of the following model links to access the corresponding procedure:

Associate a Model With a Pipeline Using JSON

Advanced users may want to associate a Coveo ML model with a pipeline using JSON. Click one of the following model links to access the corresponding procedure:

Dissociate a Model

  1. In the Machine Learning tab of the desired query pipeline, click the model that you want to dissociate from this pipeline.

  2. In the Action bar, click Dissociate.

Reorder Model Associations

The Coveo ML models of a given type are executed in the order in which they appear in the page until a condition is satisfied.

The first model on the list will be used if no conditions are met.

To reorder model associations in a query pipeline

  1. In the Machine Learning tab of the desired query pipeline, click the model whose position you want to change.

  2. In the Action bar, use the Move up or Move down arrows to change the position of the model.

Reference

"Advanced Configuration" Section

When association ART, DNE, and PR models with a query pipeline, the Administration Console lets you configure settings in the Advanced Configuration section. Click one of the following model links to access the corresponding procedure:

Required Privileges

By default, members of the Administrators and Relevance Managers built-in groups can view and edit elements of the Models 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 model associations

Machine Learning - Models

Search - Query pipelines

View

Edit model associations

Machine Learning - Models

Search - Query pipelines

Edit

Recommended Articles