Key takeaway
- OKF is a knowledge format; RAG is a retrieval pattern. How the Open Knowledge Format and RAG fit together in a hybrid architecture for governed AI agents.
Does the Open Knowledge Format (OKF) replace RAG? No. RAG is a retrieval pattern: it decides how an agent finds text at query time. OKF is a knowledge format: it decides how trusted knowledge is written down before any question arrives. They sit at different layers of the stack, and production agents need both. Governed facts such as metric definitions and policies belong in OKF; large, fast-changing document collections belong in RAG; a router decides which path each question takes.
Every Enterprise Agent Has Two Memory Problems
Most teams are solving both with the same tool, and that is where the silent errors come from.
In June 2026, Google Cloud introduced the Open Knowledge Format (OKF). Within weeks, the headlines called it a RAG killer. It isn't. And framing it as "OKF vs RAG" misses what actually matters for leaders deploying agents.
An enterprise agent needs two different kinds of knowledge, and they fail in different ways.
- Known-knowns. Metric definitions, revenue recognition rules, table schemas, approval policies, runbooks. Hundreds to low thousands of concepts. They change slowly, a team owns them, and a wrong answer propagates into every downstream decision.
- The long tail. Contracts, support tickets, incident logs, email threads, product PDFs. Millions of documents, changing constantly, owned by no one.
RAG was built for the long tail. Yet most enterprises push their known-knowns through the same pipeline, asking a vector index to re-derive "what counts as an active customer" from whichever chunks score highest. OKF is the first open standard that takes that distinction seriously.
What Is RAG? A Runtime Retrieval Architecture
RAG treats knowledge as a large body of text to be searched at query time. It needs a vector database (Pinecone, Milvus, pgvector) plus an embedding model, and it runs as two pipelines.
- Indexing runs whenever content changes: parse, split into fixed-size chunks, embed, write to a nearest-neighbour index.
- Querying runs on every question: embed the question, pull the top-k most similar chunks, rerank, stuff them into the prompt.
What RAG is excellent at: recall across corpora far too large to curate by hand. Drop in ten million tickets and they are searchable tomorrow.
What it structurally lacks: similarity search returns text that looks relevant, which is not the same as text that is correct. The pattern has no standard notion of who wrote a chunk, whether anyone checked it, or whether it has expired. Every team bolts that on with its own metadata schema.
What Is OKF? A Persistent Knowledge Format
OKF is a specification, not a service. A bundle is a directory of Markdown files, one concept per file, each with YAML frontmatter.
- Cross-links between files form a lightweight knowledge graph
index.mdmaps each directory for progressive disclosurelog.mdrecords change history- No vector database, no chunking, no embedding model. If you can
git clonea repo, you can ship OKF.
The bundle is the contract between whoever writes knowledge and whatever reads it. Experts author through pull requests, curation agents generate and maintain concepts, pipelines export from catalogs. On the other side, an agent reads it directly, a graph tool indexes it, and a RAG pipeline can chunk it as unusually clean input.
Here is what a single concept looks like:
---
type: Policy
title: Refund window
description: Full refund within 14 days of delivery.
status: stable
generated: { by: policy_agent/v2, at: 2026-09-01T10:00:00Z }
verified: { by: human:legal-ops, at: 2026-09-03T09:00:00Z }
stale_after: 2027-03-31T00:00:00Z
sources:
- id: tos
resource: https://example.com/legal/terms#refunds
---
# Rule
Refunds are accepted up to 14 days after delivery.[^tos]
Exceptions follow the [escalation playbook](/playbooks/refund-escalation.md).
How an agent reads it: open the root index.md, descend into the relevant directory, open only the concept it needs, follow links to related concepts. Nothing is ranked or guessed. Retrieval is structural, not probabilistic.
The v0.2 Trust Layer: What OKF Standardises That RAG Never Did
Most explainers still describe OKF v0.1. Version 0.2 is the part that matters for governance. It answers five questions an agent-maintained corpus raises: where did this come from, how much should I trust it, is it still true, is it current, and was this number produced the way we said it must be.
| Control | How OKF v0.2 expresses it |
|---|---|
| Provenance | Sources with credibility signals (author, usage_count, last_modified), cited per claim by footnote |
| Trust | generated (who wrote it) kept separate from verified (who confirmed it) |
| Lifecycle | status (draft, stable, deprecated) and stale_after, an absolute expiry instant |
| Attestation | Sanctioned computations with deterministic, no-LLM checks |
Trust tiers are derived, never stored. No verified field means unverified. Verification only by agents or processes means machine-confirmed. Any human actor means human-reviewed.
Attested computations close the "the agent wrote its own SQL" gap. A sanctioned calculation such as fiscal-year revenue becomes its own concept. The agent may only fill typed parameters. It may not author or edit the query.
The attester re-derives the bound query and compares it with what actually ran. A rewritten query, a swapped file or a mutated dependency fails the check, and the value shown is re-read from the source by job ID, not taken from the agent's text.
Note the distinction: verified confirms a definition still matches policy. Attestation confirms a single run produced the value the sanctioned way. A governed agent needs both. RAG offers neither as a standard.
The principle is the same one behind a Context OS: an agent's action is only as defensible as the context it can prove it used.
One Question, Two Paths
A support agent is asked: "The parcel arrived 12 days ago. Can the customer still get a full refund?" The policy is a 14-day window.
The RAG path. Embed the question. Top-k returns the current terms, a 2023 FAQ that says "30 days", and a ticket where someone granted an exception. The reranker scores relevance, not authority. The answer is fluent and usually right, but it can blend 14 and 30 without raising any error.
The OKF path. Read index.md, open policies/refund-policy.md. One concept, status stable, verified by legal ops, not past its expiry. Follow the link to the escalation playbook. Answer: "Yes, 2 days remain," with the source and verifier attached. One small file read, no vector infrastructure.
RAG is not broken here. It is answering a precise, governed question with a tool designed for fuzzy recall over a haystack.
OKF vs RAG: Head to Head
Different layers of the agent stack. Production systems use both.
| OKF · Open Knowledge Format | RAG · Retrieval-Augmented Generation | |
|---|---|---|
| Nature | Persistent knowledge format | Runtime retrieval process |
| Infrastructure | Markdown files in Git | Vector DB + embedding model |
| Organization | One concept per file, index.md | Auto-chunked text, similarity search |
| Relationships | Explicit Markdown links | Inferred from co-retrieved chunks |
| Retrieval | Structural: open index, open file | Probabilistic: top-k, then rerank |
| Trust & provenance | Standard: sources, verified, tiers | Per-implementation metadata |
| Freshness | Declared: stale_after, status | Depends on re-indexing schedule |
| Governance | Git history, PR review, log.md | Hard to version vector chunks |
| Computation integrity | Attested computations | Not addressed |
| Token efficiency | High (reported ~70x, curated) | Lower: retrieve + rerank per query |
| Scale | Hundreds to thousands of concepts | Millions of documents |
| Best for | Canonical, high-stakes facts | Large, fast-changing corpora |
Sources: OKF v0.2 specification (Google Cloud); token-efficiency figure as reported by Context Studios, not an independent benchmark.
One caution on the efficiency numbers circulating: the widely quoted ~70x token-efficiency figure for OKF is a reported vendor-side claim, not an independent benchmark. The saving is real for small curated sets and shrinks as an agent opens more files.
How Does Each One Fail?
They fail in opposite directions. RAG fails silently at query time. OKF fails slowly through neglect.
| Failure | What happens | Fix |
|---|---|---|
| Plausible but wrong | RAG chunking cuts across logic boundaries | Route governed facts to OKF |
| Stale knowledge | An outdated chunk ranks as well as a fresh one; an OKF concept can outlive its truth | stale_after gates, re-index policy |
| Conflicting sources | RAG blends versions | One canonical OKF concept; demote conflicting chunks |
| Over-curation | The bundle becomes a second unmaintained wiki | Curate only what is reused often and costly to get wrong |
| Improvised calculations | Agents write their own SQL from snippets | Bind numbers to attested computations |
| Adoption risk | OKF is young | It is plain Markdown in Git, so the exit cost is close to zero |
How Do OKF and RAG Work Together? The Hybrid Architecture
OKF does not replace RAG. It enhances it. Production stacks combine them in three moves:
- Upfront curation. Mission-critical rules, metric definitions and schemas are authored and version-controlled as OKF bundles, reviewed through pull requests like code.
- Runtime search. Sprawling, unpredictable or historical archives stay in a conventional RAG index.
- A router in front. Deterministic, high-trust questions go to OKF. Broad, exploratory questions fall back to RAG.
The router can be a lightweight classifier or the agent itself, checking the bundle's index for a named, governed concept. If the 14-day refund window is a concept, the agent reads it rather than searching for it, which removes retrieval error on that fact.
Context assembly gives OKF facts precedence over chunks and carries their trust tier into the prompt. A chunk that contradicts a human-reviewed concept is flagged, not blended.
The curation loop keeps the system improving: questions the RAG path answers again and again, from the same few sources, get promoted into OKF concepts.
Rule of thumb: if a fact is read on most tasks and a wrong answer causes real damage, it earns a concept file. Everything else stays in retrieval.
A Decision Framework for Leaders
Ask four questions of each body of knowledge, not of the technology: how big is it, how often does it change, how often is it reused, and what does a wrong answer cost?
| Body of knowledge | Where it belongs |
|---|---|
| Metric definitions, business rules, schemas | OKF |
| Regulated facts and approval policies | OKF, verified by a named human owner |
| Financial or operational numbers shown to users | OKF attested computations |
| Millions of tickets, chats, PDFs, logs | RAG |
| Fast-moving research or competitive corpora | RAG |
| Enterprise agents doing real work | The hybrid |
What This Means for Decision Infrastructure
The industry spent two years optimising how agents find text. OKF signals the next phase: governing what agents are allowed to treat as true.
Provenance, verification, expiry and attestation are the same controls an enterprise already demands of people making decisions. They now have a portable, file-level form. It is the problem Context OS at ElixirData is being built to solve.
Three implications for leaders:
- Knowledge ownership becomes an operating discipline. Every concept an agent relies on needs an owner, a review path and an expiry date, the way code does.
- Retrieval quality stops being the main governance lever. The question shifts from "did we retrieve the right chunk?" to "was this decision grounded in verified context, and can we prove it?"
- Standards lower switching costs. Plain Markdown in Git stays portable across models, vendors and agent runtimes.
RAG is the right tool for scale. OKF is the right tool for certainty. The architecture that wins is the one that knows which question needs which.
Decide Which Knowledge Your Agents Must Treat as True
In a Context Workshop, XenonStack works with your data and business owners to sort your knowledge into curated context and retrieval, name owners for the governed concepts, and scope the context layer on ElixirData with agents on ElixirClaw. Related reading: Why Your AI Stack Needs a Trusted Knowledge Layer, Healthcare Knowledge Management with Agentic AI, Database Migration with Agentic AI and The Rollback Era.
Book a Context Workshop | Explore ElixirClaw Agentic OS
Frequently Asked Questions
What is the Open Knowledge Format (OKF)?
OKF is an open specification introduced by Google Cloud in June 2026. A bundle is a directory of Markdown files, one concept per file with YAML frontmatter, that records trusted knowledge before any question is asked.
Is OKF a replacement for RAG?
No. RAG is a retrieval pattern for searching large bodies of text at query time. OKF is a format for curated, governed knowledge. Production agents use both, with a router in front.
What does OKF v0.2 add?
A trust layer: provenance per claim, separation of who generated and who verified a concept, lifecycle status with an expiry instant, and attested computations with deterministic checks.
When should knowledge go into OKF rather than RAG?
When a fact is read on most tasks and a wrong answer causes real damage, such as metric definitions, policies and schemas. Large, fast-changing collections such as tickets, chats and PDFs stay in RAG.
What is an attested computation?
A sanctioned calculation stored as its own concept. The agent may only fill typed parameters, and an attester checks that the query that ran matches the sanctioned one before the value is shown.
Further reading
- Open Knowledge Format specification v0.2 (Google Cloud, GitHub)
- How the Open Knowledge Format can improve data sharing (Google Cloud blog)
- OKF vs RAG: Does Google's Open Knowledge Format Replace RAG? (GEO Toolbox)
This article first appeared in Navdeep Singh Gill's LinkedIn newsletter, AI + Human = Human Squared.
Explore the XenonStack Platform and Agent Network
Platforms: ElixirData · ElixirClaw · ElixirHub · NexaStack · MetaSecure · Neural AI · AutonomousOps · CohortIQ · AI Aviator · SAIF Aviator
AI agents: AgentAnalyst · AgentEvaluation · AgentForce · AgentGRC · AgentHR · AgentInstruct · AgentLabel · AgentPixel · AgentQA · AgentRAI · AgentScrum · AgentSearch · AgentSketch · AgentSRE
XenonStack: xenonstack.com · xenonstack.ai · xenonstack.ae · xenonstack.jobs