Adding Knowledge to Your Agent

Adding Knowledge to Your Agent

Your agent has two knowledge layers:

• Soul knowledge — who you are, your background, domain expertise. Set during the interview and edited via the soul editor. This is identity-level knowledge.
• Knowledge base — external reference material: pricing pages, FAQs, product docs, articles. Managed via admin chat with the add_knowledge tool. Never touches your soul.

This article covers the knowledge base layer.

How It Works

When a visitor asks your agent something, the agent checks your knowledge base and pulls in the most relevant compiled summaries before responding. You never need to update your soul when facts change — just refresh a knowledge source.

Under the hood: raw content (URL, file, pasted text) is sent through an LLM compilation step that extracts key facts, structures them as clean markdown, and tags them by topic. The compiled output (~2K chars target, 5K max) is what actually goes into your agent's context.

Supported Sources

Source	How to add
Any URL (webpage, docs, pricing)	Paste the URL in admin chat: "Add this to my knowledge: https://..."
YouTube video	Paste the YouTube URL — agent watches and extracts key facts
X/Twitter post	Paste the X URL — agent reads the post and any attached video
PDF	Upload the file in admin chat
DOCX / Word doc	Upload the file
TXT / Markdown	Upload or paste directly
CSV / spreadsheet data	Upload a .csv file
Image / diagram / screenshot	Upload the image — agent describes what it sees
Pasted text / Q&A	Type or paste directly

XLSX and JSON are not directly supported — export Excel as CSV, or paste JSON as text.

Adding an Entry

In admin chat, say something like:

"Add my pricing page to my knowledge base: https://mysite.com/pricing"

"Add this PDF to my knowledge base." (attach the file)

"My agent should know that the free tier includes 3 projects. Add that as a Q&A."

The agent will compile the content and show you a proposal card with:

• The compiled title and summary
• Topic tags (used for relevance ordering)
• Char count
• Any warnings if a similar entry already exists

Click Accept to save, Decline to discard, or Refine to give feedback.

Tier Limits

Plan	Knowledge base limit
Free	10,000 chars
PRO	50,000 chars
MAX	200,000 chars

If you hit the limit, remove an old entry to make room, or upgrade.

Managing Your Knowledge Base

• "What's in my knowledge base?" — lists all entries with title, source, and size
• "Remove the pricing entry" — disables an entry immediately
• "Update the API docs entry — the endpoint changed to /v2/users" — apply a targeted text patch without re-fetching
• "Refresh my pricing page" — re-fetches the URL and recompiles if content changed

What Goes in the Knowledge Base vs the Soul?

Knowledge base: facts that change, external reference material, structured data. Pricing, feature lists, FAQ, product specs, competitor info, articles you want cited.

Soul: who you are, your voice, what you do and don't discuss. Personal background, domain expertise, communication style, behavioral rules.

When in doubt: if it's a fact the agent might need to cite, put it in the knowledge base. If it shapes how the agent behaves and sounds, put it in the soul.