User Guide
Knowledge Base
The Knowledge Base allows you to upload documents that the AI chatbot can search when answering user questions. By adding your organisation's documentation, guides, and reference materials, you give the AI access to a richer context — resulting in more accurate and comprehensive chat responses.
Plan requirement
The Knowledge Base powers Advanced AI Chat, which is available on the Pro plan. Plus plan users have access to Basic AI Chat, which responds using only the article content. Chat is not available on the Starter plan. See Plans & Pricing for details.
How It Works
The Knowledge Base uses vector search (semantic search) to find relevant information across your uploaded documents. When a user asks a question in the chat widget, the AI:
- Receives the user's question and the article context
- Searches your Knowledge Base for relevant passages using vector similarity
- Combines the article content with relevant Knowledge Base passages
- Generates a comprehensive answer drawing from all available context
This means the AI can answer questions that go beyond what's written in the specific article being viewed, drawing on your broader organisational knowledge.
Document Types
The Knowledge Base supports two types of documents:
Text Documents
Plain text content entered directly into the dashboard. Ideal for FAQs, guidelines, glossaries, company information, or any text-based reference material.
PDF Documents
Upload PDF files from your computer. The platform extracts the text content and indexes it for search. Ideal for reports, whitepapers, product documentation, and other existing materials.
Managing Documents
Adding a Document
From the FAQSIR dashboard, navigate to the Knowledge Base section for your site. You can add documents by:
- Clicking the "New Document" button
- Entering a descriptive title
- Choosing the document type (Text or PDF)
- Either entering text content or uploading a PDF file
- Saving the document
Document Status
Each document goes through an indexing process after creation or update:
| Status | Description |
|---|---|
| Pending | The document has been created and is queued for indexing |
| Indexed | The document has been processed and is available for chat search |
| Failed | An error occurred during indexing — check the document content and try again |
Indexing time
Documents are indexed asynchronously. New documents typically become searchable within a few minutes, but processing time may vary depending on document size and current system load.
Updating a Document
When you update a document's title, content, or file, it is automatically re-indexed. The previous version is removed from the search index and replaced with the updated content.
Deleting a Document
Deleting a document removes it from both the dashboard and the search index. The AI will no longer reference this document when answering chat questions.
Best Practices
Document Quality
The quality of your Knowledge Base documents directly impacts the quality of AI chat responses. For best results:
- Write clear, well-structured content with descriptive headings
- Break large documents into focused topics rather than uploading one massive file
- Include the specific terminology and language your audience uses
- Keep documents up to date — outdated information leads to inaccurate responses
Document Organisation
- Use descriptive titles that clearly indicate the document's subject matter
- Cover different aspects of your business, products, or domain in separate documents
- Include context that might not be obvious from your article content alone
What to Include
Good candidates for the Knowledge Base include: company background and values, product specifications and pricing, industry glossaries and definitions, compliance and regulatory information, customer support FAQs, technical documentation, and market analysis.
How It Enhances Chat
Without Knowledge Base documents, the Basic Chat can only answer questions based on the specific article content. With the Knowledge Base:
| Scenario | Basic Chat (Plus) | Advanced Chat (Pro) |
|---|---|---|
| Question about article content | ✓ Answers from article | ✓ Answers from article |
| Question about company background | ✗ Cannot answer | ✓ Searches Knowledge Base |
| Cross-referencing multiple topics | ✗ Limited to article | ✓ Draws from all documents |
| Industry-specific terminology | ✗ Generic understanding | ✓ Uses your definitions |
Next Steps
Chat Widget
Configure and customise the chat interface on your site.
Plans & Pricing
Compare Basic and Advanced Chat across plans.
Chat Endpoint
Technical API reference for the chat feature.
Sources & Content
Understand how source content works alongside the Knowledge Base.