--- title: Set up an answer configuration slug: p5db9314 canonical_url: https://docs.coveo.com/en/p5db9314/ collection: knowledge-hub source_format: adoc --- # Set up an answer configuration > **Important** > > The Coveo Knowledge Hub is currently available as a beta to early-access customers only. > Contact your Customer Success Manager for early access to this feature. An answer configuration is the link between your [RGA](https://docs.coveo.com/en/nbtb6010/)-enabled search interface and the [Knowledge Hub](https://docs.coveo.com/en/p59f0295/)’s Answer Manager. It allows you to [view feedback on your RGA-generated answers](https://docs.coveo.com/en/p5db0180/) and [create rules to manage the generated answers](https://docs.coveo.com/en/p5db0039/). Answer configurations are created and managed in the Answer Manager, and each answer configuration is associated with a specific [RGA](https://docs.coveo.com/en/nbtb6010/)-enabled search interface. Feedback that's collected for generated answers in a search interface appears in the associated answer configuration in the Answer Manager. Rules that you create in an answer configuration apply only to the generated answers in the associated search interface. > **Why you need an answer configuration** > > In the [improving your RGA implementation through answer evaluation](https://docs.coveo.com/en/p58d0270#improve-your-rga-implementation-through-answer-evaluation) workflow, an answer configuration is required to [view answer feedback](https://docs.coveo.com/en/p5db0180/) and [create rules](https://docs.coveo.com/en/p5db0039/) to manage your generated answers. > > ![Coveo Knowledge Hub answer configuration](:https://docs.coveo.com/en/assets/images/leverage-machine-learning/knowledge-hub-flow-answer-configuration.png) > **Note** > > Coveo recommends creating a separate answer configuration for each [RGA](https://docs.coveo.com/en/nbtb6010/)-enabled search interface, even if you use the same [RGA](https://docs.coveo.com/en/nbtb6010/) [model](https://docs.coveo.com/en/1012/) for multiple search interfaces. > This makes reviewing feedback and managing the RGA-generated answers easier and more focused. To set up an answer configuration for your [RGA](https://docs.coveo.com/en/nbtb6010/)-enabled search interface . [Create an answer configuration](#create-an-answer-configuration). . [Associate the answer configuration with your RGA-enabled search interface](#associate-an-answer-configuration-with-a-search-interface). . [Add an `answerAPI` condition to the query pipeline](#add-an-answerapi-condition-to-the-query-pipeline). . [Override the `q` and `lq` query parameters](#override-the-q-and-lq-query-parameters) (if you're using an RGA-enabled Hosted Insight Panel). ## Create an answer configuration Create an answer configuration to [view answer feedback](https://docs.coveo.com/en/p5db0180/) and [create rules to manage your RGA-generated answers](https://docs.coveo.com/en/p5db0039/). > **Note** > > Coveo recommends creating a separate answer configuration for each [RGA](https://docs.coveo.com/en/nbtb6010/)-enabled search interface, even if you use the same [RGA](https://docs.coveo.com/en/nbtb6010/) [model](https://docs.coveo.com/en/1012/) for multiple search interfaces. > This makes reviewing feedback and managing the RGA-generated answers easier and more focused. . Access the [Knowledge Hub](https://docs.coveo.com/en/p59f0295/) by selecting **Knowledge Hub** in the application picker in the Coveo Administration Console header. . In the [Knowledge Hub](https://docs.coveo.com/en/p59f0295/) navigation menu, select **Answer Manager**. . Click **Add configuration**. . Enter a descriptive **Name** for your configuration. . Click **Add**. The new answer configuration appears in the list of configurations. ![Answer configuration list in the Answer Manager | Coveo](https://docs.coveo.com/en/assets/images/leverage-machine-learning/answer-manager-configuration-list.png) . [[configurationID]]If your RGA-enabled search interface is a custom search interface that was created using the [Coveo Atomic library](https://docs.coveo.com/en/lcdf0264/), [Coveo Headless library](https://docs.coveo.com/en/lcdf0493/), or [Quantic library](https://docs.coveo.com/en/n9790069/), copy the **Configuration ID** of the newly created answer configuration. You'll need the configuration ID to associate the answer configuration with your search interface. The configuration ID isn't required if you created a Coveo hosted search interface using the [Search Page builder](https://docs.coveo.com/en/na2g0545/), [In-Product Experience (IPX) builder](https://docs.coveo.com/en/3160/), or [Insight Panel builder](https://docs.coveo.com/en/m68b0168/). . [Associate your answer configuration with your RGA-enabled search interface](#associate-an-answer-configuration-with-a-search-interface). ### Rename an answer configuration You can change the name of an existing answer configuration. . Access the [Knowledge Hub](https://docs.coveo.com/en/p59f0295/) by selecting **Knowledge Hub** in the application picker in the Coveo Administration Console header. . In the [Knowledge Hub](https://docs.coveo.com/en/p59f0295/) navigation menu, select **Answer Manager**. . Click the answer configuration you want to rename from the list. . In the Action bar, click **Rename**. . Modify the **Name** as needed. . Click **Save** to apply your changes. ### Delete an answer configuration You can delete an answer configuration when it's no longer needed. > **Important** > > * All the corresponding feedback and rules will be lost. > > * If the configuration is [associated with a custom search interface](#custom-search-interface), remove the association or replace it with another configuration to prevent errors in your search interface. > > * If an [RGA](https://docs.coveo.com/en/nbtb6010/)-enabled search interface is no longer associated with an answer configuration, [remove the `answerAPI` condition](https://docs.coveo.com/en/nb6a0104#remove-the-answerapi-condition) for your [RGA](https://docs.coveo.com/en/nbtb6010/) [model](https://docs.coveo.com/en/1012/) in your query pipeline. > Otherwise, your search interface won't use the [RGA](https://docs.coveo.com/en/nbtb6010/) model and answers won't be generated. . Access the [Knowledge Hub](https://docs.coveo.com/en/p59f0295/) by selecting **Knowledge Hub** in the application picker in the Coveo Administration Console header. . In the [Knowledge Hub](https://docs.coveo.com/en/p59f0295/) navigation menu, select **Answer Manager**. . Click the answer configuration you want to delete from the list. . In the Action bar, click **Delete**. . In the confirmation prompt that appears, click **Delete** again to confirm. ## Associate an answer configuration with a search interface Associating an answer configuration with an RGA-enabled search interface allows you to do the following: * [View the feedback](https://docs.coveo.com/en/p5db0180/) for the answers that are generated in that search interface. The feedback is collected and available to view in the associated answer configuration in the Answer Manager. > **Note** > > An answer configuration shows only the feedback that's collected after you associate it with the search interface. * [Create rules](https://docs.coveo.com/en/p5db0039/) to manage the search interface's generated answers. For example, you can create a rule that prevents an answer from being generated based on the presence of specific words in a query. Rules that you create impact the generated answers only in the associated search interface. How to associate an answer configuration with a search interface depends on how you created your RGA-enabled search interface: * If you created a Coveo hosted search interface using one of the search interface builders (Search Page builder, In-Product Experience (IPX) builder, or Hosted Insight Panel builder), see [Coveo hosted search interface](#coveo-hosted-search-interface). * If you created a custom search page using the [Coveo Atomic library](https://docs.coveo.com/en/lcdf0264/), [Coveo Headless library](https://docs.coveo.com/en/lcdf0493/), or [Quantic library](https://docs.coveo.com/en/n9790069/), see [Custom search interface](#custom-search-interface). ### Coveo hosted search interface If you created a Coveo hosted search interface using one of the Coveo builders, the association is made directly in the builder settings. . Select the answer configuration that you want to associate with the search interface in the appropriate builder settings: * [Hosted search page builder](https://docs.coveo.com/en/na2g0545#associate-an-answer-configuration) * [In-Product Experience (IPX) builder](https://docs.coveo.com/en/3160#associate-an-answer-configuration) * [Hosted Insight Panel builder](https://docs.coveo.com/en/n8sa0455#associate-an-answer-configuration) > **Notes** > > * If the Hosted Insight Panel is [integrated in Salesforce](https://docs.coveo.com/en/m7ed8015/), the answer configuration association requires [Coveo for Salesforce v6.3](https://docs.coveo.com/en/ob460496#february-2025-release-v6-3-minor-release) or later. > * In [Coveo for Salesforce v6.6](https://docs.coveo.com/en/ob460496#october-2025-release-v6-6-minor-release) and later, a [**Generate Answer** button](https://docs.coveo.com/en/m7ed8015#contextual-rga) is displayed by default in the Hosted Insight Panel when an answer configuration is associated with your RGA-enabled Hosted Insight Panel configuration. > When a query is empty, this button allows service agents to generate answers based on the context of the case they're viewing or editing. . [Add an `answerAPI` condition to the search interface's query pipeline](#add-an-answerapi-condition-to-the-query-pipeline). . [Override the `q` and `lq` query parameters](#override-the-q-and-lq-query-parameters) (if you're using an RGA-enabled Hosted Insight Panel). ### Custom search interface If you created a custom search page using the [Coveo Atomic library](https://docs.coveo.com/en/lcdf0264/), [Coveo Headless library](https://docs.coveo.com/en/lcdf0493/), or [Quantic library](https://docs.coveo.com/en/n9790069/), associate the answer configuration with the search interface using the configuration ID. . Add the [**Configuration ID**](#configurationID) of the answer configuration to your search interface as follows: ** For Atomic search pages, enter the configuration ID in the `answerConfigurationId` property of the [`atomic-generated-answer`](https://static.cloud.coveo.com/atomic/v3/storybook/index.html?path=/docs/atomic-generated-answer\--docs) component. > **Note** > > Association with an answer configuration requires Atomic v2.79.1+. ** For Quantic search pages, enter the configuration ID in the `answerConfigurationId` property of the [`QuanticGeneratedAnswer`](https://docs.coveo.com/en/quantic/latest/reference/search-components/search-generated-answer/) component. > **Note** > > Association with an answer configuration requires Quantic v3.10.0+. ** For Headless search pages, enter the configuration ID in the `answerConfigurationId` property of the [`GeneratedAnswer`](https://docs.coveo.com/en/headless/latest/reference/interfaces/Search.GeneratedAnswerState.html) controller. > **Note** > > Association with an answer configuration requires Headless v2.80.6+. . [Add an `answerAPI` condition to the search interface's query pipeline](#add-an-answerapi-condition-to-the-query-pipeline). . [Override the `q` and `lq` query parameters](#override-the-q-and-lq-query-parameters) (if you're using an RGA-enabled Hosted Insight Panel). ## Add an `answerAPI` condition to the query pipeline When an [RGA](https://docs.coveo.com/en/nbtb6010/)-enabled search interface is associated with an answer configuration, you must add an `answerAPI` condition for the [RGA](https://docs.coveo.com/en/nbtb6010/) model in the associated query pipeline. This condition ensures that the [generative queries per month (GQPM)](https://docs.coveo.com/en/nc5e0379/) aren't duplicated for queries that use your [RGA](https://docs.coveo.com/en/nbtb6010/) [model](https://docs.coveo.com/en/1012/). For information on how to add the condition, see [Prevent duplicate GQPM when using the Answer Manager](https://docs.coveo.com/en/nb6a0104#prevent-duplicate-gqpm-when-using-the-answer-manager). > **Important** > > If an [RGA](https://docs.coveo.com/en/nbtb6010/)-enabled search interface is no longer associated with an answer configuration, [remove the `answerAPI` condition](https://docs.coveo.com/en/nb6a0104#remove-the-answerapi-condition) for your [RGA](https://docs.coveo.com/en/nbtb6010/) [model](https://docs.coveo.com/en/1012/) in your query pipeline. > Otherwise, your search interface won't use the [RGA](https://docs.coveo.com/en/nbtb6010/) model and answers won't be generated. ## Override the `q` and `lq` query parameters When an [RGA](https://docs.coveo.com/en/nbtb6010/)-enabled Hosted Insight Panel is associated with an answer configuration, you must override the `q` and `lq` parameters of the query pipeline that's associated with your [Hosted Insight Panel configuration](https://docs.coveo.com/en/m5k70425#edit-an-insight-panel-configuration). Overriding these parameters ensures that when a query is empty, the [**Generate Answer** button](https://docs.coveo.com/en/m7ed8015#contextual-rga) that's part of the Hosted Insight Panel can display answers based on the context of the case being worked on. **To override the `q` and `lq` parameters**
Details . On the [**Query Pipelines**](https://platform.cloud.coveo.com/admin/#/orgid/search/pipelines/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/search/pipelines/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/search/pipelines/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/search/pipelines/)) page, click the query pipeline to which the [Hosted Insight Panel](https://docs.coveo.com/en/m5k70425#edit-an-insight-panel-configuration) is associated, and then click **Edit components** in the Action bar. . On the subpage that appears, select the **Advanced** tab, and then click **Query parameters** on the left side of the page. . On the **Query Parameters** tab, add a rule overriding the [basic query expression (`q`)](https://docs.coveo.com/en/178/) parameter value as follows: .. Click **Add a query parameter rule**. .. On the **Add a query parameter rule** subpage, select **q (basic query expression)**, and then click **Next**. .. Under **q (basic query expression)**, enter `<@+ $context.Case_Subject +@>`. .. Under **Condition**, [create a condition](https://docs.coveo.com/en/1959#create-a-condition) that includes the following sub-conditions: ... `QUERY Is Empty` ... `context[answerAPI] Is True` This condition ensures the query override only applies to Answer API requests made when the **Generate Answer** button is clicked in the Hosted Insight Panel. It doesn't affect or alter the behavior of regular search requests made using the search box. .. Click **Add rule** . On the **Query Parameters** tab, add a rule overriding the [large query expression (`lq`)](https://docs.coveo.com/en/214/) parameter value as follows: .. Click **Add a query parameter rule**. .. On the **Add a query parameter rule** subpage, select **lq (large query expression)**, and then click **Next**. .. Under **lq (large query expression)**, enter `<@+ $context.Case_Description +@>`. .. Under **Condition**, [create a condition](https://docs.coveo.com/en/1959#create-a-condition) that includes the following sub-conditions: ... `QUERY Is Empty` ... `context[answerAPI] Is True` This condition ensures the query override only applies to Answer API requests made when the **Generate Answer** button is clicked in the Hosted Insight Panel. It doesn't affect or alter the behavior of regular search requests made using the search box. .. Click **Add rule**. Your **Query Parameter** rules should look like this: ![Query parameter rules for contextual RGA | Coveo](https://docs.coveo.com/en/assets/images/coveo-customer-service/qp-rules-for-contextual-rga.png)
## Required privileges The following table indicates the privileges required to access the Coveo Knowledge Hub, and view or edit elements of the Answer Manager and associated panels (see [Manage privileges](https://docs.coveo.com/en/3151/) and [Privilege reference](https://docs.coveo.com/en/1707/)). > **Important** > > Both the **Edit** and **View** access level on the **Answer manager** domain allows the member to view all generated answers for which feedback exists in an answer configuration in the Answer Manager. > This may include content to which the member may not have access to otherwise through the repository's permission system. > > Exercise caution when granting this privilege to members. [cols="3",options="header"] |=== |Action |Service - Domain |Required access level .2+|Access the Coveo Knowledge Hub |Knowledge - Knowledge hub |Allowed |Organization - Organization |View a|* View the answer feedback for an answer configuration in the Answer Manager * View the rules for an answer configuration in the Answer Manager |Knowledge - Answer manager |View a|* Add, edit, or delete answer configurations and rules in the Answer Manager * View the answer feedback for an answer configuration in the Answer Manager |Knowledge - Answer manager |Edit |===