Knowledge Quick Start
Give your agent access to documents and get answers with citations.Installation
1. Simplest Usage (Default)
Verify it grounded
Search returning results does not prove your agent used them. Run a unique-marker check — both flags must beTrue:
SEARCH_OK=True but CHAT_OK=False, see Knowledge Troubleshooting.
Where is my data stored? By default, the Chroma store persists at
<project>/.praisonai/knowledge/chroma (absolute, per project). Override it with knowledge={"vector_store": {"config": {"path": "..."}}}. See Knowledge Storage.2. Multiple Sources (Array)
Knowledge.add(url) — supported. As of PraisonAI PR #4334 (2026-08-25) the standalone Knowledge.add() fetches and ingests remote URLs via MarkItDown — the same pipeline used for local files.Agent(knowledge=[url]) — still skipped. URL sources passed directly to Agent(knowledge=[...]) are not yet supported in the core SDK. Since PraisonAI PR #4004 any http:// or https:// entry is logged with a warning (scheme://hostname only, so tokens never leak) and skipped. This Agent-side code path lives in agent.py and is not touched by #4334. To ingest a URL through an agent, build a shared Knowledge instance, call kb.add(url), then pass knowledge=kb:3. Custom Configuration (Dict)
4. With Retrieval Options
5. Shared Knowledge (Instance)
Supported File Types
Agent(knowledge=[...]) accepts local files, directories, and raw text. Knowledge.add(...) additionally accepts remote URLs.
Next Steps
Storage Options
Configure vector stores
Chat with PDFs
Build a PDF chat agent
Chunking Strategies
Optimize document splitting
RAG
Advanced retrieval

