Field Manual

Preparing internal knowledge for useful AI retrieval

Useful answers begin with owned sources, preserved context, and a retrieval process you can evaluate.

Translucent source sheets and archival dividers viewed through a clear lens with a copper tab.

An internal assistant cannot repair the meaning of a disorganized source collection on its own. If two policies disagree, a confident answer may simply make that disagreement harder to see. Preparing knowledge is therefore part of the system design, not housekeeping to postpone until after launch.

Retrieval-augmented generation uses retrieved material as context for a response. That makes the quality and scope of the retrieved material important. It does not, by itself, establish that an answer is correct, current, or appropriate for every user.

Decide which sources are authoritative

Begin with a small inventory. For each repository or document set, record its owner, audience, update process, and role in the business. Distinguish an approved policy from a working draft, an archived procedure, or a discussion that never became a decision.

Resolve obvious duplicates and contradictions with the owners. Where a conflict cannot be resolved immediately, preserve the distinction and decide how the assistant should surface it. Quietly choosing whichever passage is easiest to retrieve creates an accidental policy decision.

Useful metadata includes a stable source identifier, title, effective or revision date where available, owner, section heading, and access classification. Do not invent dates or assume that the last upload time means the content was reviewed.

Preserve meaning when dividing documents

Search systems often divide documents into smaller pieces. The right boundary depends on the material. A policy exception may need the rule above it. A table row may be meaningless without the column headings. A procedure may need its prerequisites attached to each retrieved step.

Test the resulting passages with real questions. If a retrieved fragment loses an important condition, adjust the preparation rather than hoping the answer generator reconstructs it. Keep a reliable path from the passage back to its source document and version.

Make access part of retrieval

A shared index should not imply shared access to everything it contains. Map user identity and source permissions to the retrieval layer. Test with representative roles, including a user who should receive no relevant result.

Also decide what happens after permissions change or a source is removed. An index that refreshes content but retains obsolete access metadata can create a different problem from an outdated answer. Include deletion and permission-change tests in the refresh plan.

Test what was found and what was said

Prepare questions with expected supporting passages and known limits. Include questions with no answer in the collection, questions with similar terminology, and questions whose answer depends on a particular version.

Microsoft’s RAG evaluation documentation distinguishes retrieval quality from response qualities such as groundedness, relevance, and completeness. That separation helps diagnose a failure: the system may have missed the right passage, or it may have used a good passage poorly. A single satisfaction score will not tell you which part to change.

Automated evaluators can support repeatable checks, but the evaluation set and business judgment still matter. Inspect failures with subject-matter owners. A citation is useful only if it actually supports the statement and the user can open the source.

Assign ongoing ownership

Before release, name who approves new sources, resolves conflicting guidance, and reviews unanswered questions. Define refresh behavior and what the experience should say when evidence is insufficient. Keep those decisions visible to the people maintaining the collection.

A useful first release may cover a narrow policy library exceptionally clearly. Expand it when the source and evaluation process can support more material, rather than treating a larger index as evidence of a better answer.