Use /knowledge to create and edit documents. The agent structures content consistently, validates SQL, and adds wiki links between related documents. You can also edit documents directly in the knowledge base UI.
/knowledge requires the Developer role. Explorers can use the analytics agent but cannot modify the knowledge base.
Creating documents
Document a table:
The agent creates a document at sales/table/orders with schema, relationships, common filters, and usage notes.
Create a metric:
The agent creates a document at finance/metric/mrr with the business definition, tested SQL, source tables, and filters.
Create a business rule:
Create a note:
Providing better context
The more context you give, the better the documentation. Compare:
vs:
Namespace structure
Documents are organized hierarchically: {domain}/table/{name}, {domain}/metric/{name}, {domain}/rule/{name}, {domain}/note/{name}. Documents reference each other with wiki links like [[sales/table/orders]].
Keeping documentation current
Schema changes — when tables are renamed or columns change:
Fix incorrect SQL:
Update business definitions:
Validate periodically:
Add new documentation as your data grows:
For larger additions, configure new sources and run Update Knowledge from Context > Jobs. See the Onboarding guide. 
