Knowledge Base
Learn how to configure a knowledge base for your Notion Custom Agent, and how knowledge base quality affects Agent output.
Knowledge Base
The knowledge base is your Custom Agent's "reference material," determining what information the Agent can draw on when answering questions and executing tasks.
What Is a Knowledge Base
- A knowledge base consists of the Notion pages and databases you designate for the Agent to reference
- The Agent retrieves relevant content from the knowledge base when executing tasks
- The quality of your knowledge base directly determines the quality of the Agent's output
How Knowledge Base Quality Matters
Take a customer support scenario as an example:
- If the knowledge base is well-organized and covers common questions, the Agent's replies will be accurate and helpful
- If the knowledge base is sparse or messy, the Agent will give vague or even incorrect answers

Knowledge Base Configuration Tips
- Organize with structure — Categorize content by topic and scenario so the Agent can find relevant information more easily
- Cover common questions — Make sure high-frequency scenarios all have corresponding reference content
- Keep it updated — Regularly maintain knowledge base content by removing outdated information and adding new material
- Keep it concise and accurate — A bigger knowledge base isn't necessarily better. Redundant information can actually interfere with the Agent's judgment
- Verify in practice — After adding new content, test with real scenarios to confirm the Agent can reference it correctly
Typical Use Cases
- Customer support — Product FAQs, pricing information, refund policies, etc.
- Topic research assistant — Past notes, web clippings, reading notes, and other reference materials
- Content generation — Brand voice guidelines, writing style guides, historical articles, etc.
Working with Other Capabilities
- Knowledge base + email trigger = automatically reply to customer inquiries
- Knowledge base + page edit trigger = auto-generate outlines based on source materials
- Knowledge base + manual chat = query internal knowledge on demand
Building a solid knowledge base is one of the most important prerequisites for using Custom Agent effectively. In many scenarios, maintaining a high-quality knowledge base matters more than building the Agent itself.
Last updated on
Debugging & Optimization
Learn how to debug and continuously optimize your Notion Custom Agent, including iterative development workflows, memory page patterns, and common troubleshooting.
Triggers
Learn about the five trigger types for Notion Custom Agent — scheduled, page edited, email received, property changed, and manual chat.
Notion AI Hub Docs