Tutorial: Add PDFs and Q&A Pairs to Your Bot
Not all your knowledge lives on a website. Product manuals, policy documents, and FAQs might be in PDF files or simply in your team’s heads. This tutorial shows you how to add PDFs and manual Q&A entries to your bot’s knowledge base.
Time needed: About 10 minutes.
What you’ll learn:
- How to upload PDF documents as a knowledge source
- How to create manual Q&A entries
- How to combine multiple source types in a single bot
Add a PDF source
Section titled “Add a PDF source”- Go to Knowledge Base in the sidebar.
- Click ”+ Add Source”.
- Choose PDF.
- Upload one or more PDF files. You can drag and drop or use the file picker.
- Give the source a name (e.g., “Product Manual” or “Policy Documents”).
- Click Upload.
ChatbotIQ extracts text from each page and indexes it. Each PDF page counts as one indexed page toward your plan’s limit.
Tip: If your PDF is a scanned document (basically an image of text), the text extraction may be limited. PDFs with actual text content work best.
Manage PDF pages
Section titled “Manage PDF pages”After uploading, you can:
- View the indexed pages for each PDF.
- Delete individual pages you don’t want indexed.
- Add more PDFs to the same source at any time.
Add Q&A entries
Section titled “Add Q&A entries”Q&A entries are manually created question-and-answer pairs. They’re perfect for:
- Frequently asked questions that aren’t on your website
- Specific answers you want the bot to give
- Filling knowledge gaps that Analytics identifies
- Company policies or information that lives in people’s heads
Create Q&A entries one by one
Section titled “Create Q&A entries one by one”- Go to Knowledge Base → ”+ Add Source” → Q&A.
- Give the source a name (e.g., “FAQs” or “Common Questions”).
- For each entry, type:
- Question: The question a user might ask (e.g., “What are your business hours?”).
- Answer: The answer you want the bot to give (e.g., “We’re open Monday to Friday, 9am to 6pm CET. Weekend support is available via email.”).
- Click Add to save each entry.
Bulk import from CSV
Section titled “Bulk import from CSV”Have a lot of Q&A pairs? Import them in bulk:
- Prepare a CSV file with two columns:
questionandanswer. - In the Q&A source, click Import.
- Upload your CSV file.
Assign sources to your bot
Section titled “Assign sources to your bot”Now make sure your bot knows about these new sources:
- Go to Bots and click Edit on your bot.
- In the Knowledge Sources section, make sure your new PDF and Q&A sources are selected.
- If your bot is set to “All sources,” it will automatically include them.
Test it
Section titled “Test it”- Open the Playground for your bot.
- Ask questions that should be answered from your PDF or Q&A content.
- Check the Debug panel — you should see citations pointing to your PDF pages or Q&A entries.
Q&A entries have high retrieval priority because the question directly matches what users ask. They’re a great way to ensure specific questions get specific answers.
Combining sources effectively
Section titled “Combining sources effectively”Here’s a common multi-source setup:
| Source | Type | Content |
|---|---|---|
| Help Center | Website | General product documentation |
| Product Manual | Detailed technical specifications | |
| FAQs | Q&A | Top 20 most-asked questions |
| Release Notes | What’s new in each version |
When a user asks a question, the bot searches across all sources and uses the most relevant content, regardless of source type.
Related
Section titled “Related”- Source Types Reference — all supported source formats
- Add a Website Source — adding websites
- Find and Fix Knowledge Gaps — use analytics to decide what Q&A entries to add