How do you build an internal AI assistant using company documents? Start with a governed knowledge collection, not a model. Inventory authoritative sources, assign owners and review dates, preserve source permissions during indexing, retrieve only evidence the user may access, and require answers to cite that evidence. Test with real employee questions and deliberate failure cases before expanding. The difficult work is ownership, access, freshness, citation and evaluation—not uploading files.

A company knowledge base is more than a folder connected to a chat interface. It is an operating system for deciding which source is authoritative, who may see it, how it is found and when it must be reviewed. Retrieval-augmented generation, or RAG, can bring relevant internal content into a model's context. Microsoft describes the pattern as retrieve, augment and generate; Google's current RAG documentation similarly separates ingestion, transformation, indexing, retrieval and grounded generation. Those mechanics help the assistant use private or changing information, but they do not repair contradictory policies or absent ownership.

Define the job before choosing the platform

“Answer questions from our documents” is too broad for a safe first release. Name one audience, one knowledge domain and one measurable outcome. A useful pilot might help service staff find approved troubleshooting steps, help operations teams locate an SOP, or help new employees navigate HR policies. Each has different sources, permissions, error costs and escalation paths.

Scope decisionExampleAcceptance evidence
UsersCustomer-support employees in one business unit.Named group, identity provider and access rules.
QuestionsProduct setup, warranty and approved troubleshooting.A representative question set drawn from tickets and interviews.
SourcesCurrent manuals, service bulletins and approved procedures.Owner, version, approval state and review date for every source.
Excluded workRefund decisions, legal interpretation and account changes.Clear refusal or hand-off behavior.
OutcomeFind the correct approved procedure with a citation.Retrieval relevance, citation support and time-to-answer measures.

Keep the first assistant read-only. It may help an employee locate and understand approved material, but it should not silently update records or execute a process. If the eventual goal is action, first prove that retrieval, permissions and evidence are dependable; then add a separately controlled workflow using the architecture in the AI automation tech stack guide.

Use a seven-stage knowledge lifecycle

01InventoryIdentify authoritative sources, owners, audiences, sensitivity, duplication and known gaps.
02AuthorizeCarry source permissions and classification into every searchable document and chunk.
03PrepareClean, structure and split content while preserving headings, source URLs and business context.
04RetrieveCombine keyword, semantic or vector retrieval with metadata and permission filters.
05AnswerRequire grounded responses, visible citations, uncertainty and a safe no-answer path.
06EvaluateTest retrieval and answers on real questions, denied content, ambiguity and stale documents.
07MaintainSync changes, remove revoked content, review failures and assign recurring ownership.
A trustworthy knowledge assistant is a maintained lifecycle: source governance and access begin before retrieval, while evaluation and ownership continue after launch.

1. Inventory content and authority

List the places employees currently search: shared drives, SharePoint, Google Drive, wikis, ERP attachments, ticketing systems, email, chat and individual folders. Sample the content instead of trusting folder names. For every candidate source, record its business owner, intended audience, sensitivity, approval state, effective date, review date, source URL and superseded version.

Classify sources as authoritative, supporting, historical or excluded. An approved policy can answer a policy question. A meeting note may provide context but should not override that policy. A sales proposal, expired price list or former employee's personal notes may be searchable for a narrow purpose, yet should not be treated as current operating truth.

Duplicates need an explicit rule. Do not let retrieval ranking decide which of three similar leave policies is “probably” current. Select the authoritative copy, link or archive the others and make version status part of the searchable metadata.

2. Preserve permissions at retrieval time

The assistant must not turn broader technical index access into broader employee access. Carry user, group, role or source access-control metadata into the index and filter before evidence is returned to the model. Post-answer redaction is too late: the model has already received the restricted content.

Microsoft's current Azure AI Search guidance documents several patterns for document-level access control and explains that query-time filtering compares the caller with permission metadata stored alongside indexed content. It also notes a critical operational detail: source permission changes only affect search after the relevant metadata is synchronized. Whatever platform you use, test revocation and group changes as carefully as initial access.

  • Use the company identity: authenticate every user and resolve current group or role membership server-side.
  • Keep source permissions authoritative: do not maintain an informal, disconnected allowlist if the source system already governs access.
  • Filter every chunk: when a document is split, each resulting passage must retain the document's access and classification metadata.
  • Deny by default: missing or malformed permission metadata should exclude content, not make it public.
  • Log evidence access: retain who asked, which sources were retrieved and which version produced the answer.

3. Prepare content for useful retrieval

Extraction should preserve structure that carries meaning: titles, headings, tables, lists, page numbers and source links. Clean repeated headers, broken OCR and navigation noise. Split content at logical section boundaries rather than arbitrary character counts where possible. A retrieved passage needs enough context to stand on its own without mixing unrelated topics.

Attach metadata that can improve both filtering and diagnosis: document type, department, product, region, language, effective date, review date, owner, version, status and source URL. AWS Bedrock's current knowledge-base documentation, for example, supports metadata filters and illustrates filtering by modification time. The broader design lesson is vendor-neutral: metadata lets the system narrow evidence by business context and freshness instead of relying only on semantic similarity.

Tables, scanned PDFs, diagrams and spreadsheets need targeted tests. A parser that extracts prose well may lose merged cells, column relationships or the labels inside an image. The AI document-processing guide shows how to separate capture, extraction, validation and review when source formats are messy.

4. Retrieve evidence before generating an answer

Start with a simple retrieval baseline. Keyword search is strong for exact product codes, policy names and error messages. Semantic or vector search can find conceptually similar language. A hybrid approach can combine both, sometimes followed by a reranker. The right choice depends on your questions and content; it should be proven on an evaluation set, not selected because one method sounds more advanced.

Store citation fields such as title, source URL, section and page with each passage. Microsoft notes that an index can hold titles, URLs and filenames to improve citation quality. The response should connect claims to those sources, allow employees to open them and show an effective or modified date where it affects the decision.

Retrieved documents are data, not trusted instructions. A malicious or accidental instruction inside a document should not override the assistant's system rules, permissions or application logic. Keep tool access separate from retrieval, restrict outbound actions and treat indexed content as potentially untrusted input.

5. Design the answer contract

A reliable internal assistant needs an explicit response policy. It should answer from retrieved approved sources, distinguish direct evidence from a concise synthesis, cite the supporting passages and state when the available evidence is insufficient or conflicting. It should not fill gaps with a plausible policy.

SituationRequired responseWhat the user sees
Supported answerAnswer only the question asked and attach the strongest approved sources.Short answer, citations, source date and link.
Conflicting sourcesDo not choose silently; name the conflict and route it to the content owner.Both sources, versions and owner or escalation path.
Insufficient evidenceSay that the knowledge base cannot support an answer.What was searched and a safe next step.
Restricted contentDo not reveal whether a hidden document exists or summarize it.A neutral access-safe response.
High-impact decisionProvide relevant guidance, then require the named human authority.Policy evidence and decision owner.

6. Evaluate retrieval, answers and access separately

A polished answer can hide weak retrieval. Build an evaluation set of real questions with expected sources, acceptable answers, known no-answer cases and required permissions. Keep part of it held out from tuning. Microsoft's RAG guidance explicitly calls for testing retrieval quality, answer accuracy and citations; NIST's Generative AI Profile frames evaluation and risk management as lifecycle work aligned with the organization's context and tolerance.

Measure components rather than one vague “accuracy” score:

  • Retrieval hit rate: did the expected authoritative passage appear in the top results?
  • Evidence precision: how much retrieved content was relevant rather than distracting?
  • Answer support: is each material claim supported by the cited passage?
  • Citation correctness: does the link open the exact source and useful location?
  • No-answer behavior: does the assistant refuse unsupported or ambiguous questions?
  • Access isolation: do denied users, revoked users and cross-department questions retrieve nothing restricted?
  • Freshness: after a source changes or is withdrawn, how long until answers reflect it?

Include ordinary language, abbreviations, misspellings and multi-part questions. Add adversarial cases: instructions embedded in a document, a restricted title mentioned by an unauthorized user, a superseded policy and two sources that disagree. Review failures with subject-matter owners, not only developers.

7. Operate it as a knowledge product

Launch creates a maintenance obligation. Assign a business owner for each content domain and a technical owner for ingestion, retrieval, access and monitoring. Set review intervals by risk and rate of change. Automatically flag expired or ownerless sources, but require accountable people to approve replacements.

Track unanswered questions, weak citations, repeated user corrections, stale-source incidents, permission failures and topics that generate many conflicting results. These are signals for content work as much as model tuning. If employees cannot find a clear approved answer because the company has never written one, the correct fix is to create and govern that knowledge.

Synchronize additions, edits, deletions and permission changes. Test that deleted or revoked content disappears from retrieval, caches and citations. Version the retrieval configuration and prompt, maintain rollback, and re-run the evaluation set after any material change to parsing, chunking, embedding, ranking or model behavior.

A production-shaped pilot plan

  1. Select one knowledge domain, one employee group and one accountable business owner.
  2. Inventory and classify the sources; remove duplicates and resolve obvious contradictions.
  3. Define required metadata, source permissions, answer rules and escalation paths.
  4. Create a representative evaluation set before tuning retrieval.
  5. Index approved content with source, version, owner, date and access metadata.
  6. Test retrieval and citation without answer generation so ranking failures stay visible.
  7. Add the model with a grounded answer contract and a deliberate no-answer path.
  8. Run a limited employee pilot, review failures weekly and expand only after business and security owners sign off.

The first useful outcome is not an assistant that answers everything. It is a narrow system that helps one group find approved knowledge faster without crossing permissions or concealing uncertainty. Trust grows when employees can inspect the evidence and see that corrections make the system better.

Primary sources checked for this guide

Checked 22 August 2026. Product documentation supports the current retrieval, metadata, citation and permission patterns described above; NIST supports the lifecycle risk and evaluation approach.

Start with knowledge readiness

Find out whether your content is ready before connecting an AI assistant.

I help operations teams map source systems, permissions, ownership, evaluation questions and the narrow pilot that can prove value safely.

Run a knowledge-readiness assessment →