Utvecklardokumentation (/docs)

AxG AI Developer Documentation

Teknisk specifikation för Embed-skript, MCP-server (Model Context Protocol) och maskinläsbara katalog-API:er.

KLIENSIDA

1. Embed-skript & JavaScript API

Integrera AI-chatten på valfri webbplats (Shopify, WooCommerce, Wix, Squarespace eller egen kod) med 1 rad HTML.

KODEXEMPEL:

<script 
  src="https://ai.axelsson.graphics/embed/axg-chat.js" 
  data-agent-id="axg_ag_10482" 
  data-client-slug="demo-store"
  data-theme="auto"
  data-color="#10b981"
  data-position="bottom-right"
  async>
</script>

SPECIFIKATION & PARAMETRAR:

data-agent-id: Ditt unika Agent ID erhållet vid registrering.
data-client-slug: Unikt butikshandtag för GCP billing och isolerad Firestore-kontext.
data-theme: auto | light | dark för automatisk anpassning till besökarens enhet.
JS Events: Lyssna på window.addEventListener('axg:chat_opened') och window.addEventListener('axg:product_added_to_cart').

AI INTEGRATION

2. Model Context Protocol (MCP) Server

Standardiserad MCP-server (Model Context Protocol) som gör att AI-agenter (Claude Desktop, Cursor, Antigravity, Custom LLMs) kan interagera direkt med butikens katalog och orderhantering.

KODEXEMPEL:

{
  "mcpServers": {
    "axg-ai-sales": {
      "command": "npx",
      "args": [
        "-y",
        "@axelsson-ai/mcp-server",
        "--agent-id=axg_ag_10482",
        "--api-key=YOUR_API_KEY"
      ]
    }
  }
}

SPECIFIKATION & PARAMETRAR:

Verktyg search_catalog: Sök i butikens produktkatalog baserat på nyckelord, kategori eller bildvektorer.
Verktyg get_order_status: Hämta sanerad order- och paketspårningsstatus via Order ID + e-post.
Verktyg get_stock_levels: Hämta exakt lagersaldo och tillgänglighet för specifik SKU/variant.
Verktyg escalate_ticket: Skapa ett eskalationsärende direkt i Support Studio (#support).

DATAGRÄNSSNITT

3. Maskinläsbar Katalog & OpenAPI Schema

Restful JSON-LD & OpenAPI endpoints för kontinuerlig indexering, vektorsökning och tredjepartsintegrationer.

KODEXEMPEL:

GET https://ai.axelsson.graphics/api/public/store/catalog.json?agent_id=axg_ag_10482

Headers:
  Accept: application/json
  Authorization: Bearer YOUR_API_TOKEN

SPECIFIKATION & PARAMETRAR:

JSON-LD Schema: Varje produkt returneras i strukturerat Schema.org/Product-format med featuredImage.url, priceCurrency, offer, och availability.
Realtidslager Webhook: POST /api/public/store/webhooks för omedelbar synkning vid lagerändring.
Sökfilter: Stödjer filtrering på price_min, price_max, category, in_stock_only, och visual_vector_search.