Skip to main content
A Q&A pair is a single question and its canonical answer. It’s the most direct way to control what your agent says. If you only invest in one knowledge format, make it this one.
Q&A pairs are available on Growth and above. Starter workspaces use website crawl, file upload, and text snippet sources.

​
Add Q&A pairs

1

Open Knowledge

Sidebar → Knowledge → New source → Q&A pairs.
2

Name the source

Group related pairs, e.g. “Returns FAQ”, “Shipping FAQ”.
3

Add rows

Click Add pair and fill in:
  • Question — how a customer would phrase it
  • Answer — the exact reply you’d want the agent to give
4

Pick an agent and save

Indexed in seconds.

​
Writing great pairs

The question should sound like a real customer, not a doc heading: The answer should be copy-pastable into a reply:
Short. Specific. Has a next step.

​
Cover the 20 most common questions

Pull your inbox’s last 500 conversations and group by intent. The top 20 questions usually cover 80% of volume — write a pair for each. This is the highest-ROI single thing you can do for your agent’s accuracy.

​
Multiple phrasings

Customers ask the same thing three different ways. Add separate pairs for each, pointing at similar answers:
Don’t try to merge them — separate pairs match better in search.

​
Editing pairs

Open the source in Knowledge → edit any row inline → save. Changes re-index immediately. Deleted pairs are removed from the index within seconds.

​
Exporting pairs

Click the source → ⋯ → Export CSV. Handy for bulk editing in a spreadsheet then re-uploading.

​
When NOT to use Q&A pairs

  • For a narrative document (use file upload or text snippet).
  • For live, changing data like order status (use a tool instead, e.g. Shopify order lookup).