Products

Explore live avatars
How it Works?PricingContact Us

Guides3 min read

Build a knowledge base your AI agent can use

An AI agent is only as good as what it reads. A practical method for choosing, writing, testing and maintaining the documents behind it.

A wall of shelves filled with books
Photo by Ü Lõ on Unsplash
On this page
  1. 1. Start from the questions, not the files
  2. 2. Pick one source of truth per topic
  3. 3. Write for the question
  4. 4. Choose the right size for your plan
  5. 5. Test before you launch
  6. 6. Review transcripts every week
  7. Frequently asked questions

Key takeaways

  • Start from the questions customers really ask, then write or fix the documents that answer them.
  • One topic per section, one current version per policy. Contradictions are the main cause of wrong answers.
  • Treat the knowledge base as a product: test it before launch and review transcripts every week.

When an AI agent gets an answer wrong, the cause is usually in the documents, not the model. Out-of-date pricing, two versions of a policy and a page that only makes sense to the person who wrote it all produce confident, wrong replies. The fix is editorial work you can do before launch.

1. Start from the questions, not the files

Export the last few months of support tickets, chat logs and sales emails. Group them by topic and count them. The top 50 questions are your launch scope. Anything outside that list can wait.

2. Pick one source of truth per topic

  • Name the document that owns each policy: refunds, shipping, pricing, eligibility, service levels.
  • Remove or archive older copies. If two files disagree, the agent has no way to know which is right.
  • Date every policy and put the date at the top of the file.

3. Write for the question

A document written for a lawyer is hard for anyone to retrieve from. A short section that begins with the question and answers it directly works far better.

  • Use headings that read like questions: "How long do refunds take?"
  • Answer in the first sentence, then add the detail and the exceptions.
  • Keep one topic per section so the agent can quote it cleanly.
  • Spell out terms, plan names and product codes the way customers say them.
  • Add a short "what we do not do" page. Honest limits prevent made-up answers.

4. Choose the right size for your plan

Avarole's AI knowledge base answers from the documents you upload and cites the source file, so a reader can check it. Storage and retrieval depth scale with the plan.

PlanKnowledge storageKnowledge base
Free25 MBBasic
Starter250 MBStandard
Business1 GBStandard
Professional10 GBWith RAG
AI Team50 GBWith RAG

Plain text, FAQs and policies are small, so most teams are far from the limit. Large manuals, contract archives and product catalogues are what move you up a tier. Compare plans on the pricing page.

5. Test before you launch

  1. Take 50 real questions from your list, including awkward ones with typos and mixed languages.
  2. Ask each one to the agent and record the answer and the source it cited.
  3. Mark each as correct, partly correct or wrong. Fix the document, not the question.
  4. Add the questions the agent should refuse, such as legal advice or things you do not offer, and check it declines.

6. Review transcripts every week

Transcripts are included on every plan. Read a sample each week and look for three signals: questions the agent could not answer, answers customers pushed back on and topics that keep coming up. Each one is a document to write or correct. After a month the base reflects what your customers actually ask.

Frequently asked questions

What file types can I upload?

Upload the documents you already have, such as policies, contracts and FAQs. See the AI knowledge base page for details.

Does the agent show where an answer came from?

Yes. Answers from your documents cite the source file so a person can check them.

How much storage do I get?

From 25 MB on the Free plan to 50 GB on AI Team. See the table above or the pricing page.

Turn your documents into answers.

Upload policies, contracts and FAQs and get source-cited answers for customers and leaders.

Keep reading

Related articles