April 25, 202612 min read
Building a company AI agent that knows your knowledge base (without pretending to be omniscient)
RAG, permissions, freshness, and governance so your agent reflects docs and policies—without substituting breadth for judgment.
Sales decks love the phrase “an agent that knows more than you do.” Engineers wince, because breadth is not judgment. Retrieval-augmented generation can surface facts from hundreds of pages faster than any single employee—but it does not understand your political constraints, your risk appetite, or which promises legal will allow in public chat. Company AI agent knowledge base governance is how you turn retrieval from a liability factory into a durable advantage.
This article is for operators who already bought into RAG and now need the boring work: permissions, freshness, conflict resolution, audit trails, and escalation design. Read it alongside train an AI agent on website content and how to create an AI agent. For security specifics, use the customer-facing security checklist. Product context: Agents, onboarding, pricing.
Source authority: who wins when pages disagree?
Marketing says “ship in two weeks.” Engineering’s internal roadmap says “beta next quarter.” Legal says “subject to change.” If all three are indexed, retrieval may return any chunk depending on phrasing—and the model may paraphrase them into a single false certainty. Governance starts with declaring canonical sources per topic class: pricing only from /pricing and the official PDF, roadmap only from the public changelog, policies only from /legal.
When conflicts exist, fix the website. Do not ask the model to “reconcile” contradictions in customer chat. Your visitors deserve coherent facts, not an AI improv session.
Corpus segmentation: customer vs employee vs partner
Treat corpora like filesystem permissions. Customer agents should not read HR handbooks, acquisition drafts, or incident postmortems unless counsel explicitly approves external use. Create separate indices with explicit promotion workflows: internal draft → reviewed snippet → customer-visible retrieval.
Partners add another layer: co-marketing claims expire when partnerships end. Version partner snippets and attach provenance so you can purge them quickly.
Freshness cadence tied to releases
Assign named owners per segment: marketing site, help center, API reference, legal policies. Tie refresh cadence to release trains: major launch → forced re-crawl before the blog post goes live. Minor tweak → diff-based update if your platform supports it.
Stale answers are brand incidents. If your agent quotes last year’s SLA table during renewal season, you will find out on LinkedIn before your analytics dashboard tells you.
Evaluation scaled to risk
High-risk topics—money, health-adjacent claims, regulated industries—need stricter rubrics and weekly regression tests. Low-risk small talk still needs tone checks, but monthly may suffice. Log near misses where the model almost overstepped; those transcripts are gold for prompt updates and routing tweaks.
Escalation that preserves dignity
When uncertain, the agent should escalate with a structured summary: user goal, attempted sources, why confidence is low, suggested next step. Dumping users into an empty ticket form is how you manufacture rage clicks.
Measure repeat contact within 24 hours as a proxy for unresolved pain. If that metric rises after a corpus change, roll back the change before you chase model upgrades.
Audit trails your compliance team can defend
Immutable logs of retrieval hits and emitted answers are not paranoia—they are evidence. Decide retention with counsel: long enough for investigations, not so long that you become a honeypot of personal data. Redact PII in logs unless a ticket explicitly requires it.
Synthetic augmentation: proceed carefully
Synthetic FAQs can fill gaps, but they also introduce subtle contradictions if nobody reviews diffs. Treat synthetic content like code: PRs, reviewers, and rollback. If you cannot review it, do not ship it.
Multilingual governance
Machine-translating policies without legal review is a foot-gun. Tag languages in metadata to avoid cross-language contamination, and route locale-specific questions to the correct corpus slice.
Incident response playbooks
When wrong answers ship: freeze the affected corpus slice; patch sources; add regression tests; resume only after QA passes. Communicate transparently to support with approved talking points—not improvisation.
Data minimization and retrieval scope
Retrieve only what you need to answer the question class. If a visitor asks about return policies, avoid pulling unrelated account troubleshooting articles that happen to share keywords. Narrow retrieval reduces both latency and the probability of cross-contamination. Some teams implement “collections” per intent (billing, product, security) and route queries to collections explicitly rather than searching the entire universe every time.
Row-level security patterns for authenticated help
If your agent can access authenticated knowledge bases, enforce the same row-level security your app enforces. A support agent that leaks one customer’s data into another’s chat is a catastrophic incident. Treat RLS tests as blocking launch gates, not nice-to-haves.
Contractual language with customers
If your customer contracts promise “AI-assisted support,” define what that means: human review steps, data retention, and subprocessors. Ambiguous marketing language becomes legal exposure when enterprise procurement reads transcripts during audits.
Tool outputs are part of the knowledge story
When tools fetch live data (inventory, appointment slots), log which endpoint version answered. Static retrieval logs alone will not explain a mismatch if the tool returned stale inventory due to caching bugs. Unify trace IDs across retrieval and tool calls for coherent postmortems.
Knowledge debt metrics
Track “pages older than 180 days referenced by the agent” and “questions with zero retrieval hits.” Both signal knowledge debt. Assign owners to burn down those lists monthly. If you ignore zero-hit questions, your team will quietly train users to distrust the widget.
Related cluster
Closing
Grounding without governance is how clever demos become public liabilities. Convia’s onboarding pushes teams to decide authority, segmentation, and escalation early—before customers do it for you in screenshots. Start at onboarding, keep corpora tight, and treat governance as a product surface you maintain weekly—not a slide you show once in procurement.
If you only remember one sentence: your agent is not omniscient—it is a mirror. Polish the mirror’s surface with models, but fix the objects behind it with governance, ownership, and evaluation discipline that survives leadership changes, vendor churn, and the next fiscal year’s reorganizations without losing continuity or institutional memory.
Ready to ship an agent on your site?
Convia helps you launch grounded AI agents with onboarding, channels, and voice—without a months-long build.