SINOON

AI knowledge base: how to build an internal assistant that answers with the source

By Christian Alves, founder of SINOON
6 min
RAGInternal assistantProductivity

An AI knowledge base is an assistant that answers your team's questions using the company's own documents: manuals, policies, contracts and procedures. It finds the right passage, writes the answer and shows where the information came from. Behind the scenes, it uses a technique called RAG, which searches the documents before answering.

Stacks of paper documents and file folders
Photo: Wesley Tingey / Unsplash

What an AI knowledge base is

Every company has a knowledge base, even if nobody calls it that: folders in Drive, PDF manuals, policies buried in email, procedures in the heads of the people who have been there longest. The problem isn't a lack of information, it's finding it.

An AI knowledge base organizes that material and puts an assistant in front of it that understands questions in plain language. Instead of looking for the right file, a person asks "what is the refund deadline for corporate clients?" and gets the answer with a link to the source document.

How it works on the inside, without jargon

The most common technique is RAG (Retrieval-Augmented Generation). It works in two steps: first, the system searches the documents for the passages most related to the question; then it hands those passages to the language model, which writes the answer using only that information.

That's the difference from asking ChatGPT directly: the model doesn't answer from memory, it answers from your documents, and it can show the source. If you want to understand the technique in detail, see our guide on what RAG is and when to use it.

What companies use it for

The most common uses show up wherever the same question comes back every week:

  • ✓Onboarding: new hires ask the assistant instead of interrupting a colleague.
  • ✓Policies and HR: vacation, reimbursements, benefits and internal rules.
  • ✓Support: proven fixes for recurring customer problems.
  • ✓Legal: searching templates, clauses and past opinions.
  • ✓Sales: arguments, price tables and answers to objections, always up to date.

What goes into the base and what stays out

What goes in is what the team looks up often and has an official version: manuals, policies, procedures, FAQs and document templates. What stays out, or restricted to those who can see it, is anything sensitive: salaries, customers' personal data, board documents.

Outdated documents are the assistant's worst enemy. That's why the first step of the project is usually a cleanup: identifying the correct version of each document and discarding old copies. Many companies discover at this point how much of their material was contradictory.

How to avoid made-up answers

A reliable internal assistant follows four rules:

  • ✓Answer only from the documents: the assistant is instructed not to use its own knowledge for company matters.
  • ✓Show the source: every answer comes with the document and passage used, for anyone who wants to check.
  • ✓Say it doesn't know: when the information isn't in the base, the assistant says so instead of improvising.
  • ✓Test with real questions: before launch, the team asks the questions that come up most in daily work and validates the answers.

Permissions and security

Each person should only get answers based on documents they already have permission to see. A well-built assistant respects the permissions of the source folders or has its own access rules per department.

It's also worth checking the AI provider's contract: choose plans whose terms guarantee that the data sent isn't used to train models. And because documents may contain personal data, the project needs to comply with data protection laws such as LGPD and GDPR.

Another precaution is logging: keeping a record of which questions were asked and which documents backed each answer helps audit usage, find gaps in the base and show leadership the value of the project.

Step by step to build an internal assistant

The path that usually works has five steps:

  • ✓Map: which questions slow the team down the most, where the documents that answer them are and who needs access to what.
  • ✓Organize: clean up, update and structure the documents.
  • ✓Build and test: connect the sources, configure the assistant and test it with real questions.
  • ✓Launch where the team already works: Slack, Teams, Google Chat or WhatsApp, instead of yet another tab to open.
  • ✓Maintain: update the base when a document changes and review the questions that went unanswered.

How to measure whether the assistant is working

In the first weeks, review a sample of answers every week; after that, the review can be monthly. The most helpful metrics:

  • ✓Usage: how many people ask questions each week and whether usage grows after launch.
  • ✓Unanswered questions: they show what's still missing from the base.
  • ✓Answer ratings: a helpful or not helpful button on every answer.
  • ✓Interruptions avoided: fewer repeated questions reaching the experts.
  • ✓Onboarding time: how long it takes a new hire to become independent.

Common mistakes when rolling it out

Almost every project that doesn't take off stumbles on one of these points:

  • ✓Adding all the documents at once, without cleaning out old versions.
  • ✓Launching without testing with the team's real questions.
  • ✓Ignoring permissions and exposing sensitive documents.
  • ✓Creating yet another tool instead of bringing the assistant to where the team already is.
  • ✓Not defining who updates the base when a process changes.

Off-the-shelf tool or a custom assistant?

Off-the-shelf tools work well when the documents are in one place and the use is general. A custom build pays off when the information is spread across several systems, when each department needs its own access rules or when the assistant needs to work in a specific channel, such as the field team's WhatsApp.

That's the work we do on our internal AI assistant, with team training so the team gets value from day one.

Frequently asked questions

What's the difference between an AI knowledge base and using ChatGPT?

ChatGPT answers with the model's general knowledge. An AI knowledge base answers with your company's documents, shows the source and respects who can see what.

My documents are disorganized. Can I start anyway?

Yes. Organizing the base is part of the project and is usually the first win, because it reveals duplicate, outdated or contradictory documents.

How does the knowledge base stay up to date?

Connected folders can sync automatically, and the team can update documents manually. Reviewing the questions that went unanswered shows what's still missing from the base.

Is company data safe?

With access control per person or department, providers that don't train models on the data sent and compliance with data protection laws, yes. Sensitive documents can be left out of the base.

Does the assistant work in Slack, Teams or WhatsApp?

Yes. It can work in the channel the team already uses, which greatly increases adoption.

How long does it take to launch an internal assistant?

It depends on the volume and state of the documents. A first version, focused on one department and an organized set of documents, usually ships within a few weeks; expanding to other departments is done in stages.

Put AI to work in your company

Talk to the SINOON team and find out which agent, squad or engagement makes sense for where you are now.

Custom AI agents, automation squads, consulting and team training.