--- title: Manage model associations with query pipelines slug: '2816' canonical_url: https://docs.coveo.com/en/2816/ collection: leverage-machine-learning source_format: adoc --- # Manage model associations with query pipelines When a [Coveo Machine Learning (Coveo ML)](https://docs.coveo.com/en/188/) [model](https://docs.coveo.com/en/1012/) has been created, it must be associated with a [query pipeline](https://docs.coveo.com/en/180/) to be effective in a [search interface](https://docs.coveo.com/en/2741/). [organization](https://docs.coveo.com/en/185/) [members](https://docs.coveo.com/en/2869/) with the [required privileges](#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 Once you've created a Coveo ML {model-acronym} model, the leading practice is to test the model performance by doing an [A/B test](https://docs.coveo.com/en/3255/). This allows you to test the model on a chosen proportion of the traffic passing through a given query pipeline. You can then assess the impact of the model by comparing the query pipeline [search performance metrics](https://docs.coveo.com/en/3255#key-performance-indicators-section) with and without the model. Once satisfied with the model efficiency, you can [stop the A/B test](https://docs.coveo.com/en/3255#stop-an-ab-test) to make the model effective for all the traffic passing through the query pipeline. ## Validate that the model is effective To validate that your Coveo ML models work as expected, you can [inspect your models](https://docs.coveo.com/en/mc2g0297/). ## Plan the usage of custom contexts While Coveo ML models can perform well without custom [context](https://docs.coveo.com/en/1345/) information, using custom contexts can take Coveo ML relevance one step further. You can [define custom contexts](https://docs.coveo.com/en/3389/) and then pass appropriate ones along with [Coveo Analytics events](https://docs.coveo.com/en/260/) and [queries](https://docs.coveo.com/en/231/) to allow Coveo ML to take them into account. > **Notes** > > * Custom context support is limited under the new [Event Protocol](https://docs.coveo.com/en/o88d0509#custom-context). > * If you're just getting started with Coveo ML, you can skip this step to take advantage of Coveo ML model types more quickly and easily, and consider using custom contexts in a second phase. :leveloffset!: ## Associate a model with a query pipeline How to associate a Coveo ML [model](https://docs.coveo.com/en/1012/) with a query pipeline depends on the model type: * [Automatic Relevance Tuning (ART)](https://docs.coveo.com/en/l1ca1038/) * [Content Recommendations (CR)](https://docs.coveo.com/en/l25f0432/) * [Dynamic Navigation Experience (DNE)](https://docs.coveo.com/en/l1qf4156/) * [Intent-Aware Product Ranking (IAPR)](https://docs.coveo.com/en/na4f0342/) * [Passage Retrieval (CPR)](https://docs.coveo.com/en/oaie6403/) * [Predictive Query Suggestion (PQS)](https://docs.coveo.com/en/lcfm0406/) * [Product Recommendations (PR)](https://docs.coveo.com/en/p1vg0524/) * [Query Suggestions (QS)](https://docs.coveo.com/en/l1mf0321/) * [Relevance Generative Answering (RGA)](https://docs.coveo.com/en/nb6a0104/) * [Semantic Encoder (SE)](https://docs.coveo.com/en/nb8b0088/) * [Smart Snippets](https://docs.coveo.com/en/l6he0309/) ## Dissociate a model On the **Machine learning** tab of the desired query pipeline, click the model that you want to dissociate from this pipeline, and then click **Dissociate** in the Action bar. ## Reorder model associations The order in which [models](https://docs.coveo.com/en/1012/) appear in the query pipeline **Machine learning** tab is only relevant when multiple models of the same type are present. If there are no duplicate model types in the list, the model order has no effect and each model will either execute or not based on its individual condition. However, when multiple models of the same type are present, the models are evaluated sequentially from top to bottom. Depending on the model type, either only the first model with a satisfied condition is executed (and all subsequent models of the same type are ignored), or multiple models of the same type can be executed for the same query. See the [documentation](#associate-a-model-with-a-query-pipeline) for your model type for details. ## "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: * [Automatic Relevance Tuning (ART)](https://docs.coveo.com/en/l1ca1038#art-advanced-configuration-options) * [Dynamic Navigation Experience (DNE)](https://docs.coveo.com/en/l1qf4156#dne-advanced-configuration-options) * [Product Recommendations (PR)](https://docs.coveo.com/en/p85e0425/) ## Required privileges By default, members with the [required privileges](https://docs.coveo.com/en/1832#required-privileges) can view and edit elements of the [**Models**](https://platform.cloud.coveo.com/admin/#/orgid/ai-and-ml/models/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/ai-and-ml/models/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/ai-and-ml/models/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/ai-and-ml/models/)) page. The following table indicates the privileges required to use elements of the **Models** page and associated panels (see [Manage privileges](https://docs.coveo.com/en/3151/) and [Privilege reference](https://docs.coveo.com/en/1707/)). [cols="3",options="header"] |=== |Action |Service - Domain |Required access level |View model associations |Machine Learning - Models Organization - Organization Search - Query pipelines |View .2+|Edit model associations |Organization - Organization Machine Learning - Models |View |Search - Query pipelines |Edit |===