• 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 SSome readers

• Getting Started

  Getting started This guide takes you from installation to your first useful AgentWatch baseline. 1. Install and open AgentWatch Install AgentWatch for the Shopify store you want to monitor, then open it from Shopify Admin. AgentWatch authenticates through Shopify and runs as an embedded app. The app is read-only. It requests report access for aggregate analytics and product access for minimal product title and status snapshots. 2. Choose a plan On the Welcome page, select **ChooseSome readers

• Understanding the Dashboard

  Understanding the Dashboard The Dashboard is the quickest way to understand current AgentWatch status, recent aggregate performance, and active incidents. Overall status The status at the top combines active incidents with the latest health run: Healthy: the latest checks are healthy and there are no active warning or critical incidents. Warning: at least one warning condition, acknowledged incident, or active incident needs attention. Critical: at least one activeSome readers

• Commerce Surface Health

  Commerce surface health The Health page checks whether AgentWatch can read required Shopify data and whether selected machine-facing commerce capabilities are discoverable. Health checks are read-only. The cart check verifies whether a capability is advertised; it does not add products to a cart or perform checkout actions. The seven health checks Shopify analytics access Confirms that AgentWatch can submit an authenticated, read-only ShopifyQL query. An access warning commonly meaSome readers

• Global Catalog Product Exposure

  Global Catalog product exposure The Products page shows which products received the most Shopify Global Catalog search requests during a selected completed-day period. This page reports search exposure, not product ranking, impressions, clicks, or guaranteed availability in any specific AI assistant. Choose a date range Open the Range filter and select 7, 30, or 90 days. On the Free plan, only 7 days is available. AgentWatch uses only completed days and compares the selected periodFew readers

• Incidents and Diagnostics

  AgentWatch attaches evidence so you can understand what changed and distinguish automatic detection from manual actions. Incidents and diagnostics An incident is a persisted record of a qualified traffic, Global Catalog, or health anomaly. AgentWatch attaches evidence so you can understand what changed and distinguish automatic detection from manual actions. Incident types Channel traffic drop: AI-referred sessions for one Shopify-reported channel dropped significantly. **GlobSome readers

• Alerts and Settings

  Alerts and settings The Settings page controls email notifications, manual monitoring operations, recent job visibility, and deletion of AgentWatch monitoring data. Configure email alerts Incident emails are included on the Monitor and Optimize plans. On the Free plan, Settings shows a notice: incidents still appear in the app, but no incident, escalation, or recovery email is sent. You can still save an alert email on Free to receive the weekly digest. ![Settings notice on the Free plaFew readers

• Data and Privacy

  Data and privacy AgentWatch is designed as a read-only aggregate monitoring app. It does not modify Shopify products, themes, storefront content, or customer records. Data AgentWatch processes AgentWatch processes the minimum information required to provide monitoring: Store identity and configuration, including domain, store name, timezone, and currency. Alert preferences and an optional merchant-provided alert email. Shopify authentication sessions stored with Shopify's officiSome readers

• Troubleshooting and FAQs

  Troubleshooting and FAQ Why does the Dashboard show No data? AgentWatch uses completed-day aggregate reporting. No data can be valid when the store has no AI-referred activity, Shopify has not made the report available, or the first analytics sync has not run. Try these steps: Open Settings and run Sync 30 completed days. Open Health and run Run health checks. Review Shopify analytics access and Global Catalog analytics. Check the latest sync timestamp onFew readers

• Glossary

  Glossary Acknowledged incident An active incident that a merchant has reviewed. Acknowledging does not stop monitoring or mark the signal as recovered. Active incident An incident with Open or Acknowledged status. Agentic referring channel The Shopify reporting dimension used to group sessions and attributed sales from AI-assisted commerce channels. AI-referred orders Aggregate Shopify orders attributed to an agentic referring channel using last-click attribution. AI-reSome readers