FDE 企业 AI 落地与交付 · 企业知识治理 · 2026-06-20

Google 的 Open Knowledge Format (OKF),想把 Agent 需要的组织知识装进文件夹

Google推出OKF,用文件夹形式组织企业知识,让AI Agent更懂业务逻辑。

核心内容:

  1. OKF如何定义知识单元与文件结构
  2. YAML frontmatter与Markdown body的协作机制
  3. 通过普通链接建立跨文件知识关系

Google Cloud 本周发了 Open Knowledge Format,简称 OKF。它看起来很朴素:一个目录,里面放 Markdown 文件,每个文件顶部写 YAML frontmatter,再用普通 Markdown 链接把文件连起来。

这个东西值得写,是因为它碰到的痛点很实在。Agent 已经能写 SQL、查文档、调用工具,但在企业里经常卡在另一层:这张表到底能不能用,指标口径是谁定的,订单表和客户表应该怎么连,事故 runbook 放在哪里,某条规则有没有来源。模型不缺语法,缺的是可消费的组织知识。

它是什么

OKF 定义的基本单位叫 Knowledge Bundle。Bundle 就是一个文件夹,可以放在 Git 仓库里,也可以打成 zip 或 tarball。文件夹里每个非保留的 .md 文件叫 concept,表示一个知识单元。

concept 可以是一张 BigQuery 表,一个数据集,一个 API endpoint,一个指标,一个业务流程,一个 incident playbook,也可以是一篇参考资料。文件路径就是它的 ID,比如 tables/orders.md 对应的 concept id 是 tables/orders。

这种设计挺工程化。你不需要先部署服务,也不需要注册 schema registry。只要能读文件,就能读 OKF;只要能 git clone,就能分发 OKF。

技术细节

一个 concept 文件分成两段:YAML frontmatter 和 Markdown body。

frontmatter 里唯一必填字段是 type。它告诉消费者这个 concept 大概是什么,比如 BigQuery Table、Metric、Playbook、Reference。Google 没有做中心化 type registry,生产者自己起名字,消费者遇到未知 type 也应该继续读。

推荐字段有 title、description、resource、tags、timestamp。这里的思路很清楚:frontmatter 只放少量需要过滤、展示、索引的结构化信息。

真正的语义放在 Markdown body 里。比如表的字段说明、示例 SQL、join 方式、使用限制、引用来源,都可以用标题、表格、代码块、普通段落来写。Spec 里给了几个约定标题:# Schema、# Examples、# Citations。这些属于约定,对人和 Agent 都好读。

跨文件关系也很朴素:普通 Markdown 链接。orders.md 里可以链接到 /tables/customers.md,关系类型靠周围文字说明。这个选择降低了写入成本,也让图可视化器可以先把所有链接当作 directed edge。

这里有个取舍。关系语义不会特别强,想做严格的知识图谱查询会嫌它松。但我反而觉得 v0.1 这样挺合理。企业知识刚开始被整理时,最难的是让人愿意写、让 Agent 写出来不容易坏。强 schema 太早压上去,很多团队会直接放弃。

index.md 和 log.md 很关键

OKF 里有两个保留文件名:index.md 和 log.md。

index.md 负责分层导航。Agent 可以先读根目录的 index,看有哪些 dataset、table、metric、playbook,再按任务逐层打开相关文件。不用一口气把整个知识库塞进上下文。

log.md 负责变更历史。比如某个目录下新增了一个表、修改了一个指标口径、废弃了一个 playbook,都可以按日期记下来。Agent 后续读取时,能知道最近发生过什么,不用完全靠全文搜索碰运气。

这套设计明显继承了 LLM Wiki 的味…

— 以上为试看内容(约 40%),开通会员后阅读全文 —

原文出处:https://www.53ai.com/news/zhishiguanli/2026062090351.html