Core concepts
Knowledge
Project-scoped knowledge used by widgets, workflows, and agents (Files, Websites, Q&A).
What “Knowledge” means
Knowledge is where you store reusable, project-scoped information that Calypso can reference across:
- Workflows (for example, the Knowledge bot node)
- Web widgets (Q&A experiences)
- Agents (drafting responses grounded in your project context)
Think of it as your project’s single source of truth for answers, policies, and product details.
Knowledge item types
A knowledge item is one of:
- Files: documents you upload for your project
- Websites: URLs Calypso can reference as knowledge sources
- Q&A: curated question/answer pairs for high-precision responses
How knowledge is used
Knowledge is most effective when you combine:
- curated Q&A for exact answers (“refund policy”, “pricing”, “hours”)
- websites for broader coverage and “latest source of truth” pages
- files for internal docs, PDFs, and operational playbooks
Operational best practices
- Keep it project-scoped: avoid mixing unrelated brands/products in one project’s knowledge.
- Prefer Q&A for critical answers: it’s the most deterministic format.
- Name items clearly: humans reviewing workflows/agents should recognize sources quickly.
- Review periodically: outdated knowledge causes low-trust automation.