Bot Data Strategy: Real-time Skills vs Ingested Knowledge

Your bot can answer questions in two completely different ways. Picking the right one for each kind of question is the single biggest decision you'll make when setting up your bot. This guide will help you choose.

Real-time API Skills vs Ingested Knowledge — when to use each

Real-time API skills (sometimes just called "skills") let the bot reach into a connected system — Shopify, HubSpot, your CRM — and pull a specific record on demand. The bot calls an API, gets back a single answer, and reads it to the customer.

Ingested knowledge is different. You upload a catalog, a price book, a product manual, or a CSV, and Velaro processes the whole document into a searchable index that the bot can read all at once. The bot can then compare, rank, and summarize across every item — not just look up one.

The simple rule: look up one thing → use a skill. Compare or rank many things → ingest the catalog.

If you have 10,000+ products and need comparison or ranking — ingest your catalog

Real-time skills are great at fetching a single record, but they cannot compare or rank items. The bot would have to call the skill thousands of times to look at every product, which is slow, expensive, and unreliable.

If your customers ask things like:

• "What are your top 5 most durable kitchen knives?"
• "Which laptops under $1,500 have the best battery life?"
• "Compare your three best-selling running shoes."
• "Which of your products work for sensitive skin?"

...you need ingested knowledge. Upload your full catalog (CSV, JSON, or PDF) on the bot's Knowledge tab. The bot can then read across every product at once and produce a ranked, comparative answer.

If you just need lookups (price check, order status, stock) — real-time skills are better

Skills shine when the answer is exactly one record and that record changes minute-to-minute. Stock counts, order status, balance due, recent orders — these change constantly, so reading from your live system is the right call.

Common skill-shaped questions:

• "Do you have the iPhone 15 in stock?"
• "What's the status of my order #12345?"
• "How much do I owe on invoice 7821?"
• "What's the price of SKU ABC-100?"

For these, leave the catalog alone — connect the integration (Shopify, NetSuite, etc.) and let the bot use the skill.

Concrete examples — which to use

You can do both — and most successful bots do

Most production bots use a mix: ingested knowledge for catalog comparisons, policies, and FAQs; real-time skills for stock, orders, prices, and account data. You don't have to pick one.

If you're unsure which to use for a particular question, check your bot's Unanswered Questions dashboard. If you see a lot of "needs ingestion" entries, that's a signal the bot is being asked comparison-style questions and needs catalog knowledge added.

How big does my catalog need to be to ingest it?

There's no hard minimum, but the rule of thumb is: if you have more than 100 items and customers ever ask aggregate questions ("top," "best," "compare," "which"), ingest it. Below 100 items, skills usually cover everything. Above 100, comparison questions become very hard for skills to answer well.

Where to upload

Go to your bot's Knowledge tab. You can upload CSV, JSON, PDF, or paste text directly. Velaro processes the file in the background and the bot will start using it within a few minutes. There's no extra coding required.