Knowledge Base
Build and manage the source of truth your AI uses to answer customer questions.
Your Knowledge Base is everything your AI knows about your business. The more you teach it, the better it can help your customers.
Think of it as a reference library your AI agent searches whenever someone asks a question. "What's your return policy?" "How do I track my order?" "Are you open on weekends?" If the answer is in your Knowledge Base, your AI can find it.
What can you add?
- Text — Policies, procedures, product info, anything written
- PDFs — Documents, manuals, guides
- Web links — Pull content from your website or docs
Why it matters
When your Knowledge Base is solid, your AI can:
- Answer questions about your products and services accurately
- Explain your policies correctly
- Help customers without needing a human
- Give relevant, contextual responses instead of generic ones
Opening the Knowledge Base
Go to Intelligence → Knowledge Base from your dashboard. You'll see everything you've added, plus options to create more.
Adding content
Text
Good for: Policies, procedures, product descriptions, general info
- Click Add Knowledge
- Choose Text
- Give it a title and paste or type your content
- Save it
Don't hold back on details. The more information you add, the better your AI can answer questions.
PDF documents
Good for: Manuals, guides, detailed documentation
- Click Add Knowledge
- Choose PDF
- Upload your file and give it a title
- Save it
The PDF is processed and indexed — give it a moment to finish.
Web links
Good for: Pulling in content from your existing website or docs
- Click Add Knowledge
- Choose Web Link
- Paste the URL
- Give it a title and save
Cloodot extracts the content from the page and adds it to your Knowledge Base.
If you already have good information on your website, web links are the fastest way to get it into your Knowledge Base.
Auto-crawl for changes
Web link entries can re-crawl their source URL on a schedule so your knowledge stays in sync with the page. Turn it on for content that changes regularly — pricing, hours, product details, docs, policies.
Turn it on
You can enable auto-crawl in two places:
- While adding a Web Link — On the Web Link step of the Add Knowledge dialog, flip the Auto-crawl for changes switch and pick how often to re-crawl.
- From any existing Web Link entry — Open the entry, then toggle the switch in the auto-crawl panel at the top.
Pick an interval
Choose how often Cloodot re-crawls the URL. The minimum is 1 hour and you can pick hours or days, up to a year.
Some starting points:
- 1 day for pricing pages, hours, and policies
- 6–12 hours for fast-moving content like product availability or stock
- 1 week for stable documentation that rarely changes
Changing the interval after the fact takes one click — adjust the value, then hit Save.
What each crawl does
On each scheduled run, Cloodot fetches the URL and compares it to what's stored. You'll see one of these statuses in the panel:
- Content updated — The page changed and the entry was refreshed
- No changes — Nothing changed; the entry is already current
- Crawl failed — The page couldn't be reached or read
- Waiting for first crawl — Auto-crawl is on but the first scheduled run hasn't happened yet
The panel also shows the last crawl time and when the next one is due.
Run a crawl right now
Don't want to wait for the next scheduled crawl? Click Crawl now in the panel header. The entry will refresh in a moment, and the schedule continues from there.
When crawls keep failing
After several failed attempts in a row, Cloodot pauses auto-crawl so it stops hitting an unreachable page. The panel shows the last error and gives you two options:
- Try now — Trigger a one-off crawl to see if the issue is fixed
- Resume auto-crawl — Restart the schedule
Common reasons a crawl fails:
- The URL is behind a login or paywall
- The page has been moved or removed
- The site is temporarily down or rate-limiting requests
- The URL returns a non-HTML response
Auto-crawl runs in the background. You don't need to keep Cloodot open for it to work.
Spotting auto-crawl in the list
In the Knowledge Base list, web link entries with auto-crawl turned on show a small eye icon next to the WEBLINK type badge. Hover the icon to see the current interval.
Managing entries
Finding entries
Use the search bar to find specific entries, or browse the list. Each entry shows its type and processing status.
Editing
Click on any entry to view it, then hit the edit (pencil) icon to make changes. Save when you're done.
Deleting
Open an entry and click the delete icon. You'll be asked to confirm — once it's gone, your AI no longer has access to that information.
Processing status
After you add something, it needs to be processed before your AI can use it:
- Queued — Waiting in line
- Training — Being processed now
- Trained — Ready to use
- Failed — Something went wrong (check the entry for details)
How your AI uses the Knowledge Base
When a customer asks a question, your AI:
- Figures out what they're asking
- Searches your Knowledge Base for relevant info
- Pulls out the useful bits
- Crafts a response
Search is semantic, not keyword-based — it understands meaning. So "refund policy" and "how do I get my money back" find the same content.
Tips for better results
Make content easy to find
- Use clear, descriptive titles
- Write in natural language (the way customers would ask)
- Be specific and detailed
Keep it fresh
- Update entries when things change
- Delete outdated info
- Review periodically
- For web links, turn on auto-crawl so pages stay in sync automatically
Choose the right format
- Text — Quickest for policies and procedures
- PDFs — Good for existing documentation
- Web links — Great for pulling in website content
Troubleshooting
AI isn't finding the info
Check that the entry status is "Trained". Then:
- Make sure the content is relevant to the questions being asked
- Add more detail if the info is too sparse
Processing failed
For PDFs: verify the file is a valid PDF and not corrupted.
For web links: check that the URL is accessible and not behind a login.
If things still aren't working, re-upload or reach out to support.
Outdated answers
Find the relevant Knowledge Base entry and update it. You can also delete outdated entries entirely. For web links, auto-crawl can keep them current without manual updates.
Auto-crawl is paused
Cloodot pauses auto-crawl after several failed attempts in a row. Open the entry to see the last error. Check that the URL still works in a browser, then click Try now to retest. If it succeeds, click Resume auto-crawl to restart the schedule.
Going deeper
- AI Agent Configuration — Control how your agent uses knowledge
- Skill Sets — Skills can reference your Knowledge Base
- Documents — Additional file storage
- MCP Servers — Connect external knowledge sources
What's next?
- Create FAQs — Quick answers for common questions
- Configure your AI Agent — Put the knowledge to use
- Test in the playground to see how your AI responds
- Watch real conversations to spot knowledge gaps
Ready to add FAQs? Create your first FAQ.