SIX|V5 DocumentationLive CommerceCurrent
Current VersionV5 Live

V5: Live Commerce Integration

The culmination of all previous versions: real BigCommerce products combined with GenAI-powered personalization. No more mock data - this is production-ready live commerce.

Vision

V5 transforms SIX from a demonstration into a production-ready commerce experience by integrating real BigCommerce Storefront API with all the GenAI personalization capabilities developed in V1-V4.

Version Evolution

VersionFocusProductsIntelligence
V1Manual APIStatic mock dataDirect API calls
V2Agent-NativeMock inventoryLangGraph + CopilotKit
V3Edge StreamingMock inventoryReal-time progressive UI
V4Real-World IntelligenceMock inventoryTavily trends + live web data
V5Live CommerceReal BigCommerce catalogAll V1-V4 + live inventory

Key Features

Real BigCommerce Products

Products, prices, inventory, and images come directly from your BigCommerce store via the Storefront GraphQL API. No more mock data - what you see is what you sell.

// Backend fetches from real BC store
const bcEndpoint = `https://store-${storeHash}.mybigcommerce.com/graphql`;
const response = await fetch(bcEndpoint, {
  headers: { Authorization: `Bearer ${storefrontToken}` },
  body: JSON.stringify({ query: PRODUCTS_QUERY })
});

Persona-Specific Layouts

Each shopping persona gets a completely different layout optimized for their intent:

🎯

Goal-Oriented

Dense 5-column grid, quick stats bar, compact cards

👀

Browsing

Hero + magazine layout, editorial sections

⚖️

Comparing

Side-by-side specs, comparison cards

🎁

Gift Shopping

Price-tiered sections, gift badges

Pre-configured Backend Connection

No more connection modals for demos. The backend connects automatically using environment variables:

# Vercel Environment Variables
BC_STORE_HASH=your-store-hash
BC_STOREFRONT_TOKEN=eyJ...  # JWT from BC Admin

Live Trend Integration (from V4)

Tavily-powered real-world trend data enriches the shopping experience. Trend badges and suggestions appear in hero sections and product cards.

Semantic Search (Cross-Version)

Vector-based product discovery using pgvector and OpenAI embeddings. Real BigCommerce products are semantically searchable by meaning, not just keywords.

Architecture

V5 Data Flow:
1. User selects persona (goal-oriented, browsing, etc.)
2. Frontend calls /api/v5/products
3. Backend fetches from BC GraphQL + Tavily trends
4. BCPersonaLayout renders persona-specific layout
5. Real products displayed with live inventory/pricing

AG-UI & A2UI Protocol

V5 continues to use the AG-UI (Agent-to-UI) and A2UI (Agent-to-UI Interface) protocols for real-time state synchronization between the backend agent and frontend UI.

AG-UI Protocol

  • STATE_SNAPSHOT - Full state sync
  • STATE_DELTA - Incremental JSON Patch
  • TOOL_CALL_START/END - Tool execution tracking
  • RUN_STARTED/FINISHED - Agent lifecycle

A2UI Widget System

  • • Declarative widget specifications
  • • Dynamic component registry
  • • Type-safe widget rendering
  • • Agent-driven UI updates

Get Started