
When to Use Q&A Instead of Documents
| Situation | Recommendation |
|---|---|
| Frequently asked questions with a fixed answer | Q&A |
| Short policies and rules | Q&A |
| Extensive technical manuals | Document |
| Company website content | Website Crawler |
| Information that changes weekly | Q&A (easy to edit) |
Creating a Q&A Pair
Fill in the question
Write the question as the user would likely ask it. The more natural it sounds, the better the semantic retrieval.
Write the answer
Provide a complete and accurate answer. Be direct — the agent will use this text as the basis for its final response.
Add category and tags (optional)
Categories and tags help organize the base and make searches in the manager easier. They do not affect the agent’s semantic search.
Q&A Structure
| Field | Required | Description |
|---|---|---|
question | Yes | The question exactly as the user would ask it |
answer | Yes | The complete and correct answer |
category | No | Thematic grouping (e.g., “Payments”, “Support”) |
tags | No | List of keywords for filtering in the manager |
Editing and Deleting Q&As
To edit, click the pencil icon next to the pair. The editing modal is identical to the creation modal. After saving, the vector is automatically regenerated with the new content. To delete, click the trash icon. Deletion is immediate and irreversible.Organizing with Categories and Tags
Use categories to separate distinct topics within the same base:- Finance: payment methods, installments, refunds
- Technical support: access problems, common errors
- Product: features, limitations, integrations
urgent tag to mark answers that need frequent review.
Search and Filtering in the Manager
The search field at the top of the manager filters Q&As by:- Question text
- Answer text
- Category name
- Any tag
The manager search is a simple text search (not semantic) to help with base administration. The semantic search used by the agent in production operates independently.