Knowledge is for facts. Put tone in Persona, reusable process instructions in Skills, escalation boundaries in Behavior or Guardrails, and action instructions in Tools or Skills.
Knowledge Structure
V3 Knowledge is organized as a folder tree. You can create pages and folders, search, sort, move items, rename items, and delete items from the Knowledge sidebar.Composable Knowledge
Knowledge pages work best as focused, reusable building blocks. Instead of copying the same policy or detail into several places, create one source page and reference it from related pages or Skills. Use references when:- A page depends on another page for definitions, eligibility rules, pricing, or exceptions.
- A Skill needs factual context but should not duplicate the underlying policy.
- A scoped page extends a global page for one listing, customer group, product, or operational category.
Structured Reference Data
Knowledge is not limited to policies and help articles. Any structured reference data an agent or Skill needs to look up can live in the Knowledge Base as a general-purpose data repository. Common examples:
These pages work the same way as any other Knowledge page. Skills reference them, they can link to and from other Knowledge pages, and they stay current either through direct edits or through sync from an external source.
How Knowledge Reaches An Answer
When a contact sends a message, the AI engine:- Analyzes the question and identifies what information is needed.
- Searches across connected context sources such as Knowledge, PMS data, CRM records, and imported documents.
- Retrieves the most relevant information.
- Uses that context to generate an accurate response.
Where To Go Next
Adding Knowledge
Create pages and folders, upload documents, and import links.
Connected Sources
Sync from Notion, Google Drive, Airtable, and business systems.
PMS Knowledge
Add and override listing content without losing edits.
Managing Knowledge
Scope, permissions, versions, and deletion behavior.
Frequently Asked Questions
How do I decide between a Knowledge page and a Skill?
How do I decide between a Knowledge page and a Skill?
Knowledge holds facts the agent can look up. A Skill holds a reusable process the agent should follow. If the content answers “what is true”, it belongs in Knowledge. If it answers “what should happen next”, it belongs in a Skill.
How long should a Knowledge page be?
How long should a Knowledge page be?
Short enough to cover one topic. A focused page retrieves more accurately than a long page mixing several policies, so split content that covers unrelated subjects.
Can Knowledge hold reference tables, not just policies?
Can Knowledge hold reference tables, not just policies?
Yes. Cleaning schedules, cleaner and vendor assignments, and vendor directories all work as Knowledge, and Skills reference them the same way they reference any other page.
The agent is not using a page I added. What should I check?
The agent is not using a page I added. What should I check?
Confirm the source finished syncing, check the page is scoped to the right listing or entity, and make sure a competing page does not cover the same topic with different wording.
Common Mistakes
- Do not put tone instructions in Knowledge. Put tone in the agent Persona or a Skill.
- Do not put tool invocation rules only in Knowledge. Put them in Skills or the relevant Tool description.
- Do not put escalation thresholds only in a factual page. Put hard boundaries in Guardrails or Behavior.
- Do not edit source-backed PMS content directly when the source will overwrite it on the next sync.
- Do not duplicate the same policy at global and scoped levels unless the scoped version intentionally overrides the global one.