Merchandising Agent security and governance
Merchandising Agent security and governance
- What "secure and governed" means for the Merchandising Agent
- Human control and confirmation
- Action risk model
- Where the Merchandising Agent can act
- The agent doesn’t delete
- Identifying agent-assisted changes
- Grounded, contextual responses
- Your responsibilities when reviewing agent output
- What’s next
The Merchandising Agent helps you move from business intent to insight or action faster, while keeping the controls you already rely on in the Coveo Merchandising Hub (CMH). This article explains the security and governance model behind the agent, so that merchandisers, implementers, and the teams that support them understand how it assists your work without taking control away from you.
At its core, the Merchandising Agent is a human-in-the-loop assistant, not an autonomous operator. It can interpret your intent, retrieve context, surface insights, and prepare supported actions, but you remain responsible for reviewing and confirming anything that affects your storefront.
|
|
The Merchandising Agent can make mistakes. Always review a proposed change before you apply it, and verify the agent’s answers before you use them to make decisions. |
What "secure and governed" means for the Merchandising Agent
The Merchandising Agent operates inside the Coveo Merchandising Hub (CMH) rather than as a separate, general-purpose AI tool. Because it works within CMH, it stays inside the same boundaries and governance patterns as the rest of your merchandising workspace.
A few principles shape the experience:
-
It assists with interpreting intent, retrieving context, and preparing actions, but it doesn’t act on its own.
-
Storefront-impacting changes are prepared as proposals and applied only after you confirm them.
-
Supported actions are scoped, and requests that fall outside that scope aren’t executed.
-
The agent creates and edits, but never deletes.
-
Responses draw on trusted context from the CMH rather than free-form guesses.
-
Agent-assisted changes are attributed to the person who confirmed them.
Each of these principles is covered in more detail in the sections that follow.
Human control and confirmation
The Merchandising Agent is designed to help you prepare and understand work, not to act on its own. When you describe a goal in natural language, the agent interprets your intent and, where applicable, prepares a proposed change for you to review.
Nothing that affects your storefront is applied until you review the proposal and confirm it. You remain the gatekeeper: if a proposed result doesn’t match your intent, you can refine it before anything changes, or decline it.
Action risk model
Not all requests carry the same level of risk, so the Merchandising Agent treats them differently. Actions fall into three categories.
| Category | What it covers | How it’s governed |
|---|---|---|
Read |
Retrieving information, such as configurations, catalog fields, and metrics shown in the CMH. |
Runs without modifying any configuration. |
Write |
Creating or editing ranking rules, filter rules, and facet collections; editing facet fields; and changing recommendation strategies. |
Prepared as a proposal and applied only after you review and confirm it. |
Unavailable |
Deleting configurations, and anything outside the CMH, such as query pipelines in the Coveo Administration Console. |
Declined rather than attempted. |
This model lets the agent move faster on low-risk requests while keeping a clear, deliberate step between a proposed change and a confirmed one. When a request falls outside the supported action set, the agent explains that the action isn’t available, so you know to handle it manually in the CMH or the Coveo Administration Console.
Among the supported write actions, filter rules deserve the closest review. A filter rule that’s broader than you intended can leave a search or product listing page returning no products at all, so confirm the scope of a proposed filter rule before you apply it.
Where the Merchandising Agent can act
The agent acts only through the merchandising capabilities that the CMH itself exposes. It works with search, product listing pages, product recommendations, and facets for the properties and locales you manage.
It doesn’t reach into the Coveo Administration Console. Configuration such as query pipelines, sources, and fields stays outside the agent’s scope, and the agent declines any request to change it. This boundary matters in practice: during the early access program, some users asked the agent to adjust query pipelines, which it can’t do.
The agent is also bound by your own privileges. It can’t read or change anything in the CMH that you couldn’t read or change yourself.
The agent doesn’t delete
The Merchandising Agent can create and edit supported configurations, but it has no delete access. There’s no request that causes the agent to remove a rule, a facet collection, or any other configuration.
Anything the agent creates is an ordinary CMH configuration. It appears in the manager that owns it, and you edit or delete it there exactly as you would a configuration you created yourself, through Search manager, Product listings manager, Recommendations manager, or Facet manager.
Identifying agent-assisted changes
Each manager’s list includes a Last edited column. For a configuration the agent created or changed, that column shows Agent together with the name of the person who confirmed the change.
Every agent-assisted change therefore carries a named owner. You can see which configurations came through the agent, and which merchandiser approved each one, without leaving the manager you’re already working in. From there you manage them like any other configuration: open one to review it, edit it, or delete it.
Grounded, contextual responses
The Merchandising Agent grounds its responses in relevant, trusted context from the CMH and supported Coveo systems, rather than treating its output as free-form guesses. When it surfaces an insight or prepares an action, it draws on the configurations, catalog information, and metrics available in your merchandising workspace.
You should still review what the agent returns. grounding improves the relevance and reliability of responses, but it doesn’t remove the need for you to validate important recommendations before you rely on them.
Your responsibilities when reviewing agent output
The Merchandising Agent can accelerate your workflows, but you stay in control of the results. To get the most value while keeping your storefront safe:
-
Review outputs before you rely on them, and validate important recommendations against what you know about your business.
-
Confirm an action only when the proposed result matches your intent.
-
Check the scope of a proposed filter rule with particular care, since an overly broad filter can empty a results page.
-
Treat the agent as an assistant for supported, well-scoped workflows, and expand your use as your confidence grows.
What’s next
-
The privileges the CMH requires control who can reach the agent, since it can’t exceed the privileges of whoever uses it.
-
Manage privileges to grant or restrict that access for a group.