Assistant CoreAssistant Core
Knowledge Base

Best Practices

Tips for organizing your knowledge base for the best AI answers.

Document Organization

Use Clear Structure

  • Use headings (H1, H2, H3) to organize content
  • Keep sections focused on one topic
  • Use bullet points and numbered lists for clarity

Keep Documents Updated

  • Remove outdated documents — stale information can confuse the AI
  • Re-upload when content changes significantly
  • Smaller, focused documents work better than one giant file

Optimize for Retrieval

The AI splits your document into chunks of ~4000 characters. Structure your content so each section makes sense on its own — this helps the AI retrieve the most relevant information.

What Works Well

Content TypeExampleAI Performance
FAQs"How do I reset my password?"⭐⭐⭐⭐⭐ Excellent
Product docsFeature descriptions, specs⭐⭐⭐⭐⭐ Excellent
How-to guidesStep-by-step tutorials⭐⭐⭐⭐ Great
Policy docsTerms, privacy, compliance⭐⭐⭐⭐ Great
Meeting notesUnstructured discussions⭐⭐⭐ Good

What to Avoid

  • Scanned images without OCR — The AI can't read image-only PDFs
  • Very long documents (500+ pages) — Split into smaller files
  • Duplicate content — Remove redundant documents
  • Sensitive data — Don't upload passwords, API keys, or personal data

On this page