> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.ecomx.co/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Introduction to AgentWatch

# Introduction to AgentWatch

AgentWatch is a read-only monitoring app for Shopify merchants who want to
understand whether AI-commerce activity and agent-facing store capabilities are
working as expected.

It brings three types of information into one embedded Shopify app:

- **Performance:** aggregate AI-referred sessions, orders, revenue, and channel
  trends reported by Shopify.
- **Exposure:** Shopify Global Catalog search requests for the store and its
  products.
- **Health:** checks of Shopify analytics access and machine-facing catalog,
  product, cart, policy, and FAQ capabilities.

When a qualified signal changes significantly, AgentWatch creates an incident
with an evidence timeline and a sanitized diagnostic report. Email
notifications are optional.

## Who AgentWatch is for

AgentWatch is useful for store owners and ecommerce teams who:

- Receive traffic or sales from AI-assisted shopping experiences.
- Want visibility into Shopify Global Catalog search activity.
- Need a record of unusual drops or commerce-surface failures.
- Prefer monitoring that does not modify their theme or catalog.

## What the data means

AgentWatch uses Shopify-reported aggregate data. AI-referred sessions are
grouped by Shopify's agentic referring channel. AI-referred orders and revenue
use Shopify's last-click attribution in the aggregate report.

These signals are observational. A change can help you decide what to
investigate, but it does not prove why the change occurred or guarantee how an
external AI service ranks or displays products.

## Reporting timing

Analytics pages use completed days and are not real time. The Dashboard shows
the latest analytics sync and health-check timestamps so you can verify how
current the displayed information is.

Health checks can run more frequently than completed-day analytics. Their
actual cadence depends on the app's production monitoring schedule, and you can
also run them manually.

## Main navigation

- **Dashboard:** overall status, KPIs, channel performance, trends, and
  active incidents.
- **Health:** the latest commerce-surface checks and recent health history.
- **Products:** products ranked by Global Catalog search requests.
- **Opportunities:** products to look at first, product data readiness, and the
  results of product edits (Optimize plan).
- **Incidents:** anomaly history, filters, evidence, actions, and diagnostics.
- **Settings:** alert preferences, manual monitoring operations, recent runs,
  and data deletion.
- **Plan:** Shopify-hosted subscription and billing management.

Next: [Getting started](02-getting-started.md)