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 的味…