The pitch for an internal AI assistant is easy to like.
You upload your handbook, your service manual, your old support emails, your contract templates, your standard operating procedures. The assistant reads them. From now on, anyone in the team can ask it a question and get the answer drawn from your own documents instead of guessing or pinging a colleague.
That pitch is not wrong. The version that works really does feel like that.
The thing nobody warns you about is that the assistant is the easy half. The work that decides whether it ends up useful or quietly abandoned is the work nobody finds glamorous: looking at every document you fed it, asking whether it is true, asking whether it is current, and deleting most of it.
Reliable answers start with reliable sources
A team that buys an internal AI assistant tends to buy it as a tool. A search box. A chat window. Maybe an integration into the team's project tools.
But the tool is not really the thing being delivered. The thing being delivered is the answer the assistant gives to a member of staff at half past three on a Tuesday when they are trying to do a job.
That answer comes from documents. If the documents are out of date, conflicting, vague, or missing the bit the staff member actually needs, the answer is going to be out of date, conflicting, vague, or wrong. No amount of clever wording in the prompt will change that. The assistant cannot know more than its sources. It can only summarise them faster.
This is the part that surprises buyers. They expect the difficulty to be technical. The difficulty is editorial.
What ready source material looks like
Most internal documents were never written to be read by an assistant. They were written to be read by one specific person, on one specific occasion, often in a hurry. They contain in-jokes, unstated assumptions, references to people who left two years ago, and steps that have been replaced by a quieter informal process nobody bothered to document.
Before an assistant can reliably answer from them, four properties need to be in place.
Clarity. Each document should answer one question, or describe one process, or define one thing. Long documents that try to be three documents at once tend to confuse the assistant the same way they confuse a new starter. A page titled "Onboarding" that drifts into holiday booking, expense rules, and the office WiFi password will get cited oddly when somebody asks one of those questions in isolation.
Freshness. Old answers do not get more correct because they are written down. If the price changed, the policy changed, or the process changed, the old version needs to come out. An assistant reading two contradictory documents will pick one or quietly mix them. Either is worse than not answering.
Scope. The assistant should know what is in its remit. A staff handbook is not a legal opinion. A service manual is not pricing advice. The boundary needs to be in the documents, or in the prompt, or both. Otherwise the assistant will try to be helpful about things it has no business answering.
Ownership. Each document needs someone who is responsible for keeping it correct. This is the part that quietly fails first. People are happy to write a document once. They are less happy to be the person who reviews it every quarter. Without ownership, freshness rots within a few months of launch.
If those four properties are missing, the project is really a documentation project with an AI project sitting on top. That is fine. It is just better to know which one you have signed up for.
A staff policy assistant shows the problem
A while back we looked at a knowledge base that had been built up over a decade. Roughly four hundred documents. The team wanted an assistant that could answer staff questions from it.
The first version, with everything ingested, gave plausible answers that were quietly wrong about a third of the time. Old supplier names. Out-of-date approval thresholds. A policy that had been replaced two years earlier but never deleted.
The fix was not a better model. It was three afternoons of two people sitting with a list, marking documents as keep, archive, or rewrite. About 60% went to archive. The remaining 40%, properly tagged and lightly rewritten for clarity, made the assistant trustworthy. The model did not change. The sources did.
That is the pattern most knowledge-base AI projects hit. The first launch is too eager. The useful version comes after the prune.