Skip to content
SarvexDocs
Esc
↑↓navigate↵open⌘Jpreview

An agent's catalog search/lookup request was recorded

RECEIVEserving.catalog.query_recorded
Message
event_idstringrequired
store_idstringrequired
merchant_idstringrequired
kindstringrequired
Allowed:searchlookup
surfacestringrequired

serving.Surface's full domain (internal/planes/serving/lifecycle_contract.go) — openai_chatgpt is defined on that type but never actually produced by deriveSurface today (no signal distinguishes ChatGPT/ACP traffic yet).

Allowed:google_ai_modegoogle_geminiopenai_chatgptother_agentunknown
agent_platformstring | null

Best-effort agent platform identification from the UCP-Agent header; null when the header wasn't present.

requested_product_idsstring[]required

The returned page's SKUs for a search, or the looked-up item id for a lookup — recorded even when the lookup misses. Never raw free-text query content.

occurred_atstring<date-time>required
Try it
Server
Payload

Live sending isn't possible for pubsub from a browser tab — copy the sample above and run it against your broker.

Message
{
  "event_id": "string",
  "store_id": "string",
  "merchant_id": "string",
  "kind": "search",
  "surface": "google_ai_mode",
  "agent_platform": "string",
  "requested_product_ids": [
    "string"
  ],
  "occurred_at": "2019-08-24T14:15:22Z"
}