← Blog

Internal Knowledge Base AI for Staff Questions

An internal knowledge base AI lets staff ask a question in plain English and get an answer from your own documents. The AI is the easy half. The hard half is whether the documents are current, who may see them and whether staff can check where an answer came from.

We build internal knowledge assistants through our AI integration service, so weigh that. Every fact below about Anthropic, Cloudflare, Slack, Google, Microsoft, Atlassian and Notion was checked against their own documentation in October 2026.

Short answer: If your handbook and policies are small, you may not need retrieval at all: Anthropic says a knowledge base under about 200,000 tokens can go straight into the prompt. If it’s larger, use retrieval-augmented generation (RAG): find the relevant passages, pass only those to Claude and have it cite them. Either way, show the source with every answer, respect the permissions your document tools already enforce, log the questions it can’t answer and give every content area an owner. Model costs are usually small. The documentation work is not.

What the Vendor Docs Say

As of October 2026, from Anthropic, Cloudflare, Atlassian, Microsoft and Notion documentation:

TopicWhat the docs say
Small knowledge baseUnder 200,000 tokens (about 500 pages), put it all in the prompt
Contextual RetrievalIn Anthropic’s tests, cut failed top-20 retrievals by 49%, or 67% with reranking
EmbeddingsAnthropic has no embedding model; its docs name Voyage AI as one option
CitationsClaude cites exact passages from documents you send
Claude Sonnet 5.5$2 input, $10 output per million tokens; cache hits $0.10
Claude Haiku 5.5$0.10 input, $0.50 output per million tokens, for prompts up to 100,000 tokens
Cloudflare AI SearchManaged indexing; external sources resync every 6 hours by default
Source permissionsConfluence and Microsoft Search return what the user can view; Notion returns what’s shared with the integration

Sources: Anthropic on Contextual Retrieval, Claude embeddings, Claude citations, Anthropic pricing, Cloudflare AI Search syncing, Confluence search API, Microsoft Search API, Notion search API.

What AI Knowledge Base Integration Actually Does (vs. What Vendors Claim)

The pitch: staff ask in plain English, get the right answer and nobody interrupts HR or IT. The reality: they get an answer. The AI can only use what exists in a form it can read, and it will answer from outdated or contradictory content if that’s what it finds.

RAG Systems vs. Prompt-Stuffed Chatbots: The Distinction That Matters

There are two ways to give Claude your knowledge, and both are legitimate.

Everything in the prompt. If your knowledge base is under about 200,000 tokens, roughly 500 pages, Anthropic says you can include all of it in the prompt with no RAG (source). That post is from 2024, and Anthropic now says Claude 4.7 and later models use a tokenizer that produces about 30% more tokens for the same text (source). Measure your documents, don’t count pages.

Retrieval-augmented generation. For a larger or fast-changing knowledge base, a search step finds the passages relevant to each question and passes only those to Claude. Anthropic doesn’t make an embedding model, the piece that turns text into searchable vectors; its docs name Voyage AI as one provider and suggest comparing several (source). Anthropic’s Contextual Retrieval method adds a short note, usually 50–100 tokens, on where each chunk sits in its document before indexing it. In Anthropic’s tests that cut failed top-20 retrievals by 49%, and by 67% with reranking (source).

The distinction that matters isn’t which approach you pick. It’s whether the content is current and the answer shows its source. A bot built once from a snapshot of your docs, with no citations and no rebuild when a policy changes, is the one to avoid.

What Employee Queries AI Can and Cannot Reliably Answer

AI handles factual lookups with a written answer well: “What’s our parental leave policy?”, “What’s the limit for equipment purchases?”, “Where do I submit a vendor invoice?” It does badly on judgment calls, sensitive HR situations and anything where the real answer is “it depends on context nobody wrote down”. Send everything past that boundary to a person.

The Documentation Prerequisite No One Talks About

Much of what staff need to know lives in email threads, chat history and the memory of long-serving colleagues. AI can’t retrieve what isn’t there. Before an integration adds value, that knowledge has to be written down, organised and kept current.

Why Undocumented Processes Produce Confident AI Hallucinations

Suppose a new employee asks: “What’s the process for onboarding a new client?” If the real answer lives in an account manager’s head and an old document that no longer matches practice, the AI answers from the old document, with no caveat. The employee follows the old process. Nobody notices until something goes wrong.

That’s a documentation failure, not a technology one.

Running a Documentation Inventory Before Any AI Integration

Before building anything, audit what you have:

  • List the categories of question staff ask HR, IT, finance and managers.
  • For each, check whether a current, accurate document exists and where it lives.
  • Note which department owns each gap.

That inventory is the foundation of the project. A useful test: if you can’t answer a question by searching your documents, the AI won’t either.

Assigning Ownership and a Maintenance Cadence

A knowledge base with no owner goes stale. AI makes stale content more dangerous, because it makes it easier to find and easier to trust. Give each content area a named owner, set a review cadence that fits how often it changes, and budget that time as a running cost.

How to Build an Internal AI Knowledge Base That Actually Gets Used

A correct system that staff route around is still a failed project.

Integration Points Employees Already Work In

Put the assistant where people already work, which for many teams is Slack or Microsoft Teams. A Slack bot that answers HR policy questions has a real chance of replacing the “quick question for HR” message.

In Slack, a bot can subscribe to the app_mention event, which fires when someone mentions it. Direct messages to the bot don’t arrive that way; it needs the message.im event (source). Where staff ask changes who sees the answer.

Permissions: Who Is Allowed to See the Answer

Your document tools already decide who can read what. A Google Drive file carries permissions for users and groups, and child items inherit from their folder (source). Confluence’s search API returns only content the user may view (source). Microsoft’s Search API queries OneDrive and SharePoint content the signed-in user can read (source). Notion’s search returns pages shared with the integration, not with the person asking (source).

So if you copy everything into one index, your integration must apply those permissions itself, or a finance folder becomes answerable by anyone. Cloudflare AI Search, for example, applies metadata filters such as a folder before retrieval (source).

Source Attribution: Why Employees Need to See Where Answers Come From

Every answer should show the source document, its last-updated date and a link. Staff can check it, and someone notices when a cited document is out of date.

Claude’s citations feature returns the passages behind each claim, as page ranges for PDFs and character ranges for plain text (source). With your own retrieval, you can pass results as search result blocks carrying your source and title, and Claude cites them (source). For anything touching HR policy, compliance or finance, treat attribution as required.

Feedback Loops and Content Gap Detection

Log every question. Review the ones the assistant couldn’t answer: they are your documentation gaps and the owners’ backlog. Make the review someone’s named task.

Realistic Running Costs for SMBs

Two costs matter: model calls and people time. Model calls are the small one. Our own worked example, from Anthropic’s published prices (source):

  • RAG on Claude Sonnet 5.5: 6,000 input tokens and a 400-token answer cost $0.012 + $0.004 = $0.016 per question, $16 per 1,000.
  • The same on Claude Haiku 5.5: $0.0006 + $0.0002 = $0.0008 per question, under $1 per 1,000.
  • A 150,000-token handbook in the prompt: $0.30 input per question uncached on Sonnet 5.5, or $0.015 as cache hits. Haiku 5.5 charges more above 100,000 tokens.

The cache lasts 5 minutes by default and resets each time it’s used, with a 1-hour option (source). Hosting, search and embeddings add their own costs. We don’t quote a standard timeline, because it depends mostly on your documents.

Build vs. Buy: Custom Claude API Integration vs. an Off-the-Shelf Tool

Off-the-shelf knowledge tools are a fair choice when your documents already live in a supported tool and your questions are standard. Setup is faster, but you work within the product’s limits. We haven’t reviewed those products’ current features or prices for this post, so check their own pages.

A custom build on the Claude API means you own the retrieval, prompts and interface, and it can reach internal systems a packaged tool doesn’t support. It costs more to build. See how we scope this through AI integration.

What the First Months Actually Look Like

The stages are the same each time. How long each takes depends on your documents:

  1. Inventory: list question categories, find gaps, assign owners.
  2. Clean-up: fix, merge or retire the documents the assistant will use.
  3. Build: connect sources, apply permissions, add citations and logging.
  4. Pilot: a small group asks real questions; review every unanswered one.
  5. Rollout: open it up and keep the review loop running.

Teams that jump to step 3 tend to return to step 1 once wrong answers cost them staff trust.

Ongoing Maintenance: The Cost Everyone Skips in the ROI Calculation

Return-on-investment estimates often stop at “hours saved times salary”. That leaves out keeping the knowledge base current: owners reviewing documents, updating policies and acting on the gap log. Skip it and the knowledge base decays.

The Bottom Line

The technology is the easy part. The documentation, permissions and review loop are the hard part. Get both right, in that order, and staff get answers they can check.

Frequently Asked Questions

What types of employee questions can an AI knowledge base handle reliably?

Policy lookups, process steps, where to find things and factual operational questions, such as “What’s our expense limit?” or “How do I request leave?”. Questions that need judgment, like grievances or unclear policy, should go to a person.

How do you prevent an AI knowledge base from giving employees wrong answers?

You can’t remove them entirely, but you can make them visible and fixable. Show the cited source with every answer. Keep documents current through named owners. Log unanswered questions and fill the gaps. Retrieval quality matters too: adding context to each chunk before indexing cut failed retrievals in Anthropic’s tests.

What’s the difference between an AI knowledge base and an internal chatbot?

The labels overlap. One that reads your live documents and cites them gives answers you can trace, and they change when the document changes. One built from a one-off snapshot with no citations goes stale, and nobody can see why it said what it said.

How long does it take to implement an internal AI knowledge base for a 50-person company?

It depends mostly on your documentation, so we don’t quote a standard figure. If your policies are current and in one place, the build is the main work. If they’re scattered or unwritten, the documentation comes first and takes longer than the build.

Do you need a developer to build an internal AI knowledge base, or can you use off-the-shelf tools?

Off-the-shelf tools can work without a developer if your documents live in a format they support. You need a developer to connect internal systems, apply your own permission rules, build a custom Slack bot or own the whole thing. The real question is whether the product’s limits fit how you work.

What happens to existing knowledge when you integrate AI: does it replace the current system?

No. The AI adds a question-and-answer layer on top of your documents, which stay the system of record and still need maintaining. Staff ask a question and get an answer with a link to the source.

Want staff to get answers from your own documents, with sources they can check? Tell us where your knowledge lives and what people keep asking. We'll tell you plainly what it would take, and whether the documents need work first. Start a conversation, or see how we build this through AI integration.