Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.keloa.ai/llms.txt

Use this file to discover all available pages before exploring further.

Adding a Shopify knowledge source ingests your storefront content into the AI’s training data, so the agent can answer pre-sales questions like “Do you ship to Belgium?”, “What’s the price range for X?”, or “What does the About page say about your sustainability story?” — without you copy-pasting any of it. This is separate from the Shopify channel integration, which gives your AI live tools (order lookup, product search). You can use either one or both — they read from the same connection.

Before you start

  • Connect your Shopify store first under Settings → Integrations → Shopify. The same Admin API access token powers both knowledge sync and the live tools.
  • The token must include these scopes for sync to work:
    • read_online_store_pages — required for the Pages stream (default).
    • read_content — required for the Articles stream (opt-in).
    • read_products — required for the Products stream (opt-in).

Add a Shopify source

1

Open Knowledge

Sidebar → KnowledgeAdd sourceShopify catalog.
2

Pick which streams to sync

StreamDefaultWhat it ingests
PagesOnYour storefront’s static pages (About, FAQ, Shipping, etc.)
ArticlesOffBlog articles from any blog on your store
ProductsOffProduct titles, descriptions, variants, vendor, type
3

Wait for the first sync

Keloa kicks off an immediate ingest. Each piece of content lands as its own page in your knowledge base, complete with citations back to your storefront.
4

Verify in your AI agent

Open any agent → Knowledge tab. You should see your Shopify content alongside any other sources you’ve added. Search for a phrase from your About page — the AI now grounds its replies in your live storefront content.

Visibility rules

Keloa respects your storefront’s published state when deciding what the AI can quote in customer-facing replies:
ContentStorefront stateVisibility
Page or articlepublished_at is setPublic — AI can cite in replies
Page or articleDraft / unpublishedInternal — agent-facing only
Productstatus: activePublic — AI can cite in replies
Productdraft or archivedInternal — not used for replies
This means your unpublished blog drafts won’t accidentally end up in a customer reply.

Re-sync cadence

  • Automatic re-sync runs every 6 hours in the background.
  • You can also trigger a manual re-sync any time: Knowledge → expand the Shopify row → Sync now.
  • Each re-sync upserts new and changed pieces of content, and removes anything you’ve deleted from your storefront. Citations stay stable on URLs that didn’t change.

Limits

Value
Streamspages (default), articles (opt-in), products (opt-in)
Sync modeIncremental — re-runs only refresh what changed
Sync cadenceEvery 6 hours, plus on-demand
Multi-storeOne Shopify store per workspace
Product URLsBuilt from handle + your *.myshopify.com domain
Article URLsBuilt when the blog handle is available

Disconnect

To stop syncing, go to Settings → Integrations → Shopify → Disconnect. The Shopify knowledge source is removed and its vectors are wiped from the AI’s index. Historical conversations stay intact — only the AI’s training data changes.

Shopify channel

Live tools: order lookup, product search, customer enrichment.

Managing sources

Re-sync cadence, deletion, vector cleanup.