When the Store API Goes Dark: Designing a Trustworthy Continuity Layer for Agentic Commerce

说明与用途

当商店的 REST API 暂时不可用时，AI 代理必须通过提供最后验证的目录快照来继续发现商家，确保商家控制权和数据新鲜度。

问题

An AI shopping agent must reliably discover merchants even when a store’s REST API is temporarily unavailable, without penalizing merchants for unrelated outages or serving stale data as authoritative.

结果

The continuity layer achieved a 7.6‑second source switch, zero snapshot requests to the merchant during outage, and zero AI calls during recovery in a controlled test, while maintaining merchant control and data freshness.

工作流

• 1. Merchant publishes signed snapshot via Bridge plugin. 2. Network receives heartbeat and stores hot candidate. 3. On live API failure, network switches to hot snapshot locally. 4. Snapshot is served until freshness expires or revocation occurs. 5. When API recovers, network performs full authoritative re‑read before returning to live.
• 6. Fail‑closed logic distinguishes outages, revocations, and missing plugins.
• 7. Operational checks prevent flapping and ensure concurrency safety.

证据

The KaliCart Bridge plugin (WordPress/WooCommerce) periodically publishes a static snapshot of the store's public catalog: a manifest plus content shards.

来源

When the live API fails, switching source is a local operation. In our canary on a test store with 110 products: the source switch completed in 7.6 seconds from decision to serving; the merchant's server received zero snapshot requests during the switch; zero AI calls were made.

来源

We made a hard rule: switching between live and snapshot is deterministic and AI‑free.

来源