---
title: Product Catalog Auditor agent
slug: agent-platform/docs/product-catalog-auditor-agent
docTags: 
createdAt: 2026-09-28T21:08:57.000Z
---

**Product Catalog Auditor** is an Optimizely Opal agent that scans products and variants to detect data inconsistencies, missing attributes, and publishing gaps in Optimizely Commerce Connect.

- **Challenge** – Catalog merchandisers struggle to catch unpriced items, missing media, broken variants, and placeholder copy before products publish to live storefronts.
- **Agent outcome** – The agent generates a catalog health score, severity breakdown, and prioritized defect report, and delivers it in an interactive canvas.
- **Value** – Merchandisers resolve catalog defects early to maintain data quality and protect storefront revenue.

## Prerequisites

**Product Catalog Auditor** requires the following:

- Optimizely Commerce Connect.
- The [Optimizely.Commerce.Opal.Tools 2.0.0](https://nuget.optimizely.com/packages/optimizely.commerce.opal.tools/2.0.0) NuGet package.

## Install agent

:::hint{type="info"}
**Note**

**Opal Administrators**, **Agent Builders**, and users with the **Add, edit, and install specialized agents** attribute for a custom role can add agents to their organization's Optimizely Opal instance. See [Add users and set permissions.](docId\:pe0pbUJveWrG8ewvZWDRE)
:::

Install the agent from the Opal Agent Directory.

1. Go to **Agents > Agent Directory**.
2. Select **Product Catalog Auditor**.
3. Click **Install Agent** to add the agent to your Opal instance.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/2FlqqnOqieV-gp014aDPy_product-catalog-auditor-agent.png" size="100" isUploading="false" width="1666" height="912" showCaption="false" indent="1" darkWidth="1666" darkHeight="912"}

## Use the agent

Go to [Opal Chat](docId\:dtNBEttEGVvkhNkwNypLM), enter `@product_catalog_auditor`, and provide the following details:

- (Optional) `category_or_parent_code` – Code or name of the category or catalog node to audit. When omitted, the agent audits from the catalog root.
- (Optional) `minimum_attribute_frequency_threshold` – Frequency threshold between 0.0 and 1.0. When missing on outlier items, attributes present in at least this proportion of peer items trigger a flag. Defaults to 0.8.
- (Optional) `market_id` – Market identifier, such as US or UK, to verify pricing and market availability against. Omit to check the default market.
- (Optional) `custom_required_attributes` – Comma-separated list of attribute names that are strictly required for all products and variants.
- (Optional) `commerce_site_url` – Base URL of the Commerce Connect site that hosts the Catalog user interface. The agent uses it to build absolute links to items in the Commerce Catalog products view.

:::hint{type="info"}
**Note**

All parameters are optional. You can run the agent without parameters to audit the entire catalog from the root node with default thresholds.
:::

The agent delivers a Markdown canvas audit report detailing data inconsistencies, missing attributes, and prioritized defect tables with direct links to items in Commerce Connect.

To use the **Product Catalog Auditor** agent in a [workflow agent](docId:2HD0fUsIsfdek516VtN9l), drag the agent into your workflow. See [Create a workflow agent](docId\:KWaI2TBwD38sN7p74exoy).

## Details

The **Product Catalog Auditor** agent has the following default details. After you [install the agent in your Opal instance](docId\:M0l9luKQ74ZcdqX3NOmGD), customize these details for your organization's needs.

See [Manage agents](docId\:SSeNiblVMXwVvDR_lhtvI) for instructions.

### Input variables

The **Product Catalog Auditor** agent accepts the following input:

- (Optional) `category_or_parent_code`
- (Optional) `minimum_attribute_frequency_threshold`
- (Optional) `market_id`
- (Optional) `custom_required_attributes`
- (Optional) `commerce_site_url`

### Tools

The **Product Catalog Auditor** agent uses the following tools to process your request:

- `catalog_content_search`
- `catalog_content_detail`
- `catalog_content_link`
- `commerce_list_market`
- `create_canvas`
- `edit_canvas`

### Additional details

The agent uses the following default configuration:

- **Inference level** – Complex. Provides advanced reasoning and detail.
- **Files** – None.
- **Output** – Text.

:::hint{type="info"}
**Note**

If you use Opti ID, administrators can turn off generative AI in the Opti ID Admin Center. See [Turn generative AI off across Optimizely applications](docId\:X5U0kKD2azV5cIdNqwGNj).
:::