> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vizochok.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> VIZOCHOK is an AI-powered shopping assistant for grocery retail. Embed a smart chat widget into your store and let customers find products, get recommendations, and manage their cart, all through natural conversation.

# What is VIZOCHOK?

VIZOCHOK is an AI shopping assistant SaaS built specifically for grocery retail. It provides an embeddable chat widget that connects to your existing e-commerce backend, enabling customers to search for products, get personalized recommendations, and manage their cart through natural language.

Your customers simply type what they need ("I need ingredients for borscht" or "find me gluten-free bread") and VIZOCHOK's AI agent handles the rest: searching your catalog, checking prices and availability via your backend, and adding items to the cart.

## Key Features

<CardGroup cols={2}>
  <Card title="Smart Hybrid Search" icon="magnifying-glass">
    Combines vector similarity, full-text search, and trigram matching with Reciprocal Rank Fusion for highly relevant results, even with typos or colloquial language.
  </Card>

  <Card title="Cart Management" icon="cart-shopping">
    AI manages the shopping cart through server-to-server webhooks. Prices and stock always come from your backend. VIZOCHOK never stores them.
  </Card>

  <Card title="Multi-Tenant" icon="building">
    Each tenant gets isolated data, API keys, usage limits, and configuration. Deploy once, serve many retailers.
  </Card>

  <Card title="Per-Tenant Customization" icon="palette">
    Custom LLM routing, system prompts, embedding models, rate limits, webhook endpoints, and widget theming, all configurable per tenant.
  </Card>
</CardGroup>

## How It Works

<Steps>
  <Step title="Customer opens the widget" icon="browser">
    A lightweight JS SDK embeds the chat widget into your storefront. The customer types a query in natural language.
  </Step>

  <Step title="Message sent over WebSocket" icon="bolt">
    Real-time streaming connection, authenticated on first message with your API key.
  </Step>

  <Step title="AI Agent processes the request" icon="brain">
    Smart model routing selects the optimal LLM per query complexity (configurable per tenant).
  </Step>

  <Step title="Tools execute" icon="gears">
    The agent uses tools: product search (hybrid vector + FTS + trigram), cart operations, recipe planning, all based on your catalog.
  </Step>

  <Step title="Your backend stays in control" icon="server">
    Prices, stock, and cart state always live on your side. VIZOCHOK calls your webhooks server-to-server to get live data.
  </Step>
</Steps>

## Quick Links

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get your first AI shopping assistant running in 5 minutes.
  </Card>

  <Card title="Widget SDK" icon="code" href="/widget/installation">
    Install and configure the embeddable chat widget.
  </Card>

  <Card title="API Reference" icon="square-terminal" href="/api-reference">
    Explore the full REST and WebSocket API.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/webhooks/overview">
    Connect VIZOCHOK to your product catalog and cart system.
  </Card>
</CardGroup>