发布日期：2026-06-20 15:13:37 浏览次数： 1648
作者：Vibe编码
微信搜一搜，关注“Vibe编码”
推荐语
Google推出OKF，用文件夹形式组织企业知识，让AI Agent更懂业务逻辑。
核心内容：
1. OKF如何定义知识单元与文件结构
2. YAML frontmatter与Markdown body的协作机制
3. 通过普通链接建立跨文件知识关系
杨芳贤
53AI创始人/腾讯云(TVP)最具价值专家
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 的味道。Karpathy 那篇 LLM Wiki 讲的也是三层：raw sources、wiki、schema。OKF 做的事，是把这个社区里已经跑起来的模式，变成一个供应商中立的交换格式。
## 为什么 Google 要做这个
Google 的切入点是数据目录和 Agentic Data Cloud。企业数据系统里有太多上下文放在服务里：Dataplex、BigQuery、Looker、文档站、内部 wiki、工单、Slack 讨论。Agent 要想真的帮人分析数据，只拿到字段名远远不够。
举个很常见的场景。一个销售收入指标，字段名可能叫`revenue`，但它到底包不包含退款、税费、折扣、跨境汇率调整，往往在另一个文档里。再往下问，这个指标能不能按周聚合，能不能和用户表 join，历史分区有没有数据质量事故，又会散到更多地方。
传统 RAG 可以检索这些资料，但每次都要重新拼。OKF 的想法是把稳定知识先整理成 wiki，让它持续累积。Agent 查询时读的是整理后的 concept，而不只是 raw docs 的碎片。
Google 这次也给了参考实现。README 里写到 enrichment agent 会先读取 BigQuery metadata，为数据集、表等概念生成 OKF 文档；然后通过 web pass 抓取权威文档，把 citation、说明、关系补进去。它还能生成一个自包含 HTML visualizer，用图方式看 bundle 里的 concept 和链接。
我更在意的是它把数据目录知识拉回了工程工作流。指标口径更新、join path 修订、verified SQL 加入，都可以变成 Git diff，可以走 PR，可以被 review。对数据团队来说，这比又多一个聊天入口实际得多。
## 和几个相邻标准怎么分
OKF 很容易和 llms.txt、MCP、OpenLineage 混在一起看，但它们管的层不一样。
llms.txt 更像站点给 LLM 的入口导航，告诉模型重要文档在哪里。MCP 是 Agent 连接工具、资源和数据源的协议。OpenLineage 记录作业运行时的血缘事件，比如哪个 job 读了哪些 dataset，产出了哪些 dataset。
OKF 更像上下文资产本身。它可以被 llms.txt 指向，也可以通过 MCP 暴露给 Agent，还可以把 OpenLineage 结果写成概念说明或 citation。它关注的层，是把组织知识做成可移动、可审查、可读取的文件包。
## 落地方式
如果团队想试 OKF，我不建议一上来就把整个公司知识库导出。比较稳的路径是选一个小域，比如一个 BigQuery dataset、一个核心业务指标域，或者一个产品线的数据资产。
先定本地 profile。也就是把`type`清单、推荐 frontmatter 字段、固定章节模板、citation 规则写清楚。比如表必须有 Schema、Examples、Citations；指标必须说明口径、过滤条件、刷新频率、owner；playbook 必须说明触发条件、处理步骤、升级路径。
然后从现有系统导出第一版。dbt docs、LookML、BigQuery INFORMATION_SCHEMA、DataHub、Dataplex、内部 wiki，都可以成为 producer。第一版不用追求完美，先把高价值 concept 做出来。
接着让人审最关键的内容。尤其是指标口径、权限边界、SQL 示例、业务规则。Agent 写出来的东西可以加速整理，但不能把它当成事实来源。OKF 里的 citation 很重要，最好每个关键判断都能追到原文档、系统链接或 owner。
这一步之后，让 Agent 只读消费。比如 SQL Agent 先读`index.md`，再打开相关表和指标 concept，沿链接找到 join path 和示例查询。观察生成质量有没有变稳，错误是否更容易定位。等只读消费稳定后，再考虑让 Agent 写回建议修改，并通过 PR 让人审。
## 边界
OKF v0.1 还很早。它没有权限模型，没有查询基础设施，没有统一 type registry，也没有强关系语义。它不能替代数据治理系统，不能替代 schema 管理，也不能替代运行时血缘采集。
权限尤其要小心。把表说明、示例 SQL、业务规则导出成文件后，传播会变得更容易。哪些字段能写进 bundle，哪些示例会泄漏业务敏感信息，哪些 concept 只能给特定团队读，这些都要在外部系统里处理。
还有规模问题。几百到几千个 concept，用文件、Git、index、grep、静态 viewer 很舒服。到了几十万级别，肯定需要搜索索引、分片、增量同步和权限过滤。OKF 负责交换形态，不负责大规模 serving。
OKF 这件事，我的判断是可以小规模试，别急着押成平台战略。
它最有价值的地方，是把 Agent 需要的组织知识变成普通文件。普通到可以放进 Git，可以被人审，可以被脚本检查，可以被不同工具搬来搬去。这个方向很对。
我也有点担心 type 和章节约定后面会分裂。没有 registry 带来灵活性，也会带来映射成本。真正落地时，团队一定要写自己的 OKF profile，不然文件夹很快会变成另一种松散 wiki。
如果你现在已经在做数据问答、SQL Agent、企业知识库、代码 Agent 项目，我会把 OKF 当成一个很轻的中间层来试：先从一个小域导出，给 Agent 读，再看错误有没有少一点。别让格式本身变成新负担。它应该帮知识流动，减少新流程负担。
[登录查看剩余 70% 内容](javascript:void (0);)
https://www.53ai.com/keyword/%E7%9F%A5%E8%AF%86%E7%AE%A1%E7%90%86https://www.53ai.com/keyword/%E4%BC%81%E4%B8%9A%E7%9F%A5%E8%AF%86%E7%AE%A1%E7%90%86https://www.53ai.com/keyword/AI%E7%9F%A5%E8%AF%86%E5%BA%93
分享：
用微信扫描二维码
用微信扫描二维码
用微信扫描二维码
用微信扫描二维码
53AI，企业落地大模型首选服务商
**产品**：场景落地咨询+大模型应用平台+行业解决方案
**承诺**：免费POC验证，效果达标后再合作。**零风险落地应用大模型**，已交付160+中大型企业
https://www.53ai.com/news/zhishiguanli/2026062196873.htmlhttps://www.53ai.com/news/zhishiguanli/2026061976038.html
https://www.53ai.com/news/zhishiguanli
相关资讯
https://www.53ai.com/news/zhishiguanli/2026070483450.htmlhttps://www.53ai.com/news/zhishiguanli/2026070298312.htmlhttps://www.53ai.com/news/zhishiguanli/2026070210735.htmlhttps://www.53ai.com/news/zhishiguanli/2026070128069.htmlhttps://www.53ai.com/news/zhishiguanli/2026070103542.htmlhttps://www.53ai.com/news/zhishiguanli/2026070130596.htmlhttps://www.53ai.com/news/zhishiguanli/2026063070523.htmlhttps://www.53ai.com/news/zhishiguanli/2026063026970.html
https://www.53ai.com/solution.html
https://www.53ai.com/solution.html
160+中大型企业正在使用53AI
[立即咨询](javascript:void(0))[预约演示](javascript:void(0))
https://www.53ai.com/news/dongtai/2025012294502.htmlhttps://www.53ai.com/news/dongtai/2025012234192.html
https://hub.53ai.com/
热点资讯
https://www.53ai.com/news/zhishiguanli/2026040727630.htmlhttps://www.53ai.com/news/zhishiguanli/2026042838960.htmlhttps://www.53ai.com/news/zhishiguanli/2026041292651.htmlhttps://www.53ai.com/news/zhishiguanli/2026040796142.htmlhttps://www.53ai.com/news/zhishiguanli/2026060472109.htmlhttps://www.53ai.com/news/zhishiguanli/2026040705498.htmlhttps://www.53ai.com/news/zhishiguanli/2026042094382.htmlhttps://www.53ai.com/news/zhishiguanli/2026061189154.htmlhttps://www.53ai.com/news/zhishiguanli/2026042650829.htmlhttps://www.53ai.com/news/zhishiguanli/2026040807925.html
大家都在问
https://www.53ai.com/news/zhishiguanli/2026070483450.htmlhttps://www.53ai.com/news/zhishiguanli/2026063028037.htmlhttps://www.53ai.com/news/zhishiguanli/2026062952940.htmlhttps://www.53ai.com/news/zhishiguanli/2026062917592.htmlhttps://www.53ai.com/news/zhishiguanli/2026061976038.htmlhttps://www.53ai.com/news/zhishiguanli/2026060469170.htmlhttps://www.53ai.com/news/zhishiguanli/2026060124079.htmlhttps://www.53ai.com/news/zhishiguanli/2026052737860.html
热门标签
https://www.53ai.com/news/neirongchuangzuohttps://www.53ai.com/news/LargeLanguageModelhttps://www.53ai.com/news/gerentixiaohttps://www.53ai.com/news/langchainhttps://www.53ai.com/news/llamaindexhttps://www.53ai.com/news/MultimodalLargeModelhttps://www.53ai.com/news/RAGhttps://www.53ai.com/news/zhinengkefuhttps://www.53ai.com/news/knowledgegraphhttps://www.53ai.com/news/finetuninghttps://www.53ai.com/news/RAGFlowhttps://www.53ai.com/news/cozehttps://www.53ai.com/news/difyhttps://www.53ai.com/news/fastgpthttps://www.53ai.com/news/Bishenghttps://www.53ai.com/news/Qanythinghttps://www.53ai.com/news/AIqichehttps://www.53ai.com/news/AIjinronghttps://www.53ai.com/news/AIgongyehttps://www.53ai.com/news/AIpeixunhttps://www.53ai.com/news/AISaaShttps://www.53ai.com/news/tishicikuangjiahttps://www.53ai.com/news/tishicijiqiaohttps://www.53ai.com/news/AIdianshanghttps://www.53ai.com/news/AImianshihttps://www.53ai.com/news/shuziyuangonghttps://www.53ai.com/news/zhinengbaobiaohttps://www.53ai.com/news/zhishiguanlihttps://www.53ai.com/news/OpenSourceLLMhttps://www.53ai.com/news/zhinengyingxiaohttps://www.53ai.com/news/zhinengyingjianhttps://www.53ai.com/news/zhinenghuagaizaohttps://www.53ai.com/news/AIyiliaohttps://www.53ai.com/news/MaxKBhttps://www.53ai.com/news/Palantirhttps://www.53ai.com/news/Gleanhttps://www.53ai.com/news/Openclaw
[应聘简历请发送至： ceo@53ai.com](mailto:ceo@53ai.com)
https://www.53ai.com/product.html
https://www.53ai.com/product/quanyuanAIhttps://www.53ai.com/product/gongzuoduihuahttps://www.53ai.com/product/neirongchuangzuohttps://www.53ai.com/product/zhinengwendanghttps://www.53ai.com/product/mofacaidan
https://www.53ai.com/product/yewuAIhttps://www.53ai.com/product/weixinfenshenhttps://www.53ai.com/product/haiwaikefuhttps://www.53ai.com/product/guanwangkefuhttps://www.53ai.com/product/douyinkefuhttps://www.53ai.com/product/shuzilaoshihttps://www.53ai.com/product/shuzidudaohttps://www.53ai.com/product/zhinengfuwutai
https://www.53ai.com/product/AIXyewuhttps://www.53ai.com/product/zhinengwenshuhttps://www.53ai.com/product/zhinengshenhehttps://www.53ai.com/product/zhinenggongdanhttps://www.53ai.com/product/qiweigenjinzhushouhttps://www.53ai.com/product/zhinengbaojiahttps://www.53ai.com/product/qiweixiaoshouzhushouhttps://www.53ai.com/product/zijianyingyonghttps://www.53ai.com/product/qiweikefuzhushou
https://www.53ai.com/consulting.htmlhttps://www.53ai.com/fine-tuning.html
https://www.53ai.com/kehuanli.html
https://www.53ai.com/kehuanli/hangyeanlihttps://www.53ai.com/kehuanli/solution
https://www.53ai.com/news.html
https://www.53ai.com/news/qianyanjishuhttps://www.53ai.com/news/agentplatformhttps://www.53ai.com/news/hangyeyingyonghttps://www.53ai.com/news/qiyejingyinghttps://www.53ai.com/prompt.html
https://www.53ai.com/about.html
https://www.53ai.com/about/introductionhttps://www.53ai.com/about/cooperation
友情链接：
https://www.waytoagi.com/https://www.yuncan.com/https://www.wescrm.com/https://www.mingpian.top/https://www.uweb.net.cn/
CopyRight © 2012-2026 深圳市博思协创网络科技有限公司 版权所有
https://beian.miit.gov.cn/
广州：广州市华景路37号(华景软件园)暨南大学科技大厦6楼（整层）
深圳：深圳市福田区泰然四路29号天安创新科技广场一期A座1204
上海：上海市浦东新区金新路58号1602室
微信扫码
和创始人交个朋友
联系我们
售前咨询
[186 6662 7370](tel:18666627370)
预约演示
[185 8882 0121](tel:18588820121)
微信扫码
添加专属顾问
回到顶部
加载中…
扫码咨询
[](https://www.53ai.com/news/zhishiguanli/2026062090351.html)
https://work.weixin.qq.com/ca/cawcde2599cf74e2d9https://work.weixin.qq.com/ca/cawcdefb661890e885[电话咨询](tel:400-838-1185)
扫码登录
– [x] 登录即表示您同意[《53AI网站服务协议》](javascript:void(0);)
服务协议
欢迎您使用【53AI 官方网站】（以下简称“本网站”或“我们”）。本《会员服务协议》（以下简称“本协议”）是您（以下简称“会员”或“用户”）与【深圳市博思协创网络科技有限公司】之间关于注册、登录及使用本网站会员服务所订立的法律协议。
在您注册或登录前，请务必审慎阅读、充分理解各条款内容，特别是免除或限制责任的条款、知识产权条款、争议解决条款等。此类条款将以加粗形式提示您注意。 当您通过微信公众号授权、手机验证码验证或其他方式成功登录本网站时，即视为您已完全理解并同意接受本协议的全部内容。
一、 定义
本网站：指由【深圳市博思协创网络科技有限公司】运营的，域名为【53ai.com】的网站及相关移动端页面。
会员服务：指本网站向注册会员提供的知识库文章查阅、内容检索及其他相关增值服务。
知识库内容：指本网站发布的包括但不限于文字、图表、数据、研究报告、行业分析等数字化内容资源。
二、 账号注册与登录
登录方式：本网站支持以下登录方式，您可根据实际情况选择：
微信公众号授权登录：您同意将您的微信OpenID信息授权给本网站，用于创建或关联会员账号。
手机验证码登录：您需提供真实有效的手机号码，并通过短信验证码完成身份验证与登录/注册。
账号安全：您的账号仅限您本人使用，禁止赠与、借用、租用、转让或售卖。因您保管不善导致的账号被盗、密码泄露等损失，由您自行承担。
实名认证：根据相关法律法规要求，我们可能要求您在特定功能下完成实名认证。如您拒绝提供，可能无法使用部分或全部服务。
未成年人保护：若您未满18周岁，请在法定监护人的陪同下阅读本协议，并在征得监护人同意后使用本服务。
三、 服务内容与规范
知识库查阅权限：会员登录后，有权按照其会员等级对应的权限范围，在线浏览、检索本网站知识库中的相关文章及内容。
服务变更：我们有权根据业务发展需要，调整、变更或终止部分服务内容，并将以网站公告、公众号消息等方式提前通知。
禁止行为：您在使用服务时不得实施以下行为：
利用技术手段批量爬取、下载、转存知识库内容；
将知识库内容用于商业目的或未经授权地向第三方传播；
干扰本网站正常运行或侵犯其他用户合法权益；
发布违法违规信息或从事违反公序良俗的活动。
四、 知识产权声明
权利归属：本网站知识库中的排版设计、软件代码等内容的知识产权均归【公司全称】或原权利人所有，受《中华人民共和国著作权法》等法律保护。
有限许可：本网站授予会员一项非独占、不可转让、不可转授权的普通许可，仅限于个人学习、研究之目的在线查阅知识库内容。
侵权追责：未经书面许可，任何单位或个人不得以任何形式复制、转载、摘编、镜像、汇编或以其他方式使用上述内容。一经发现，我们保留追究其法律责任的权利。
五、 个人信息保护
我们重视对您个人信息的保护。关于我们如何收集、使用、存储和保护您的个人信息，请单独阅读 《隐私政策》。
您通过微信公众号授权或手机号验证所提供的信息，我们将严格按照《个人信息保护法》的规定处理，仅用于身份识别、服务提供及安全验证等必要用途。
您可以随时通过网站设置或联系客服行使查阅、更正、删除个人信息及撤回授权同意的权利。
六、 免责声明
内容准确性：知识库内容仅供参考，不构成专业建议。我们不对其完整性、准确性、时效性作任何明示或暗示的保证，您应自行判断并承担使用风险。
不可抗力：因自然灾害、政策法规变化、网络故障、第三方平台接口异常（如微信接口维护、运营商短信通道故障）等不可抗力导致的服务中断或延迟，我们不承担违约责任。
第三方链接：本网站可能包含指向第三方网站的链接，该等网站的内容和服务不受我们控制，请您自行甄别风险。
七、 违约责任
如您违反本协议约定，我们有权视情节采取警告、限制功能、暂停服务、注销账号等措施，并保留要求赔偿损失的权利。
如因您的违约行为导致我们遭受行政处罚、第三方索赔或商誉损失，您应承担全部赔偿责任（包括但不限于罚款、赔偿金、律师费、公证费等）。
八、 法律适用与争议解决
本协议的订立、执行和解释均适用中华人民共和国大陆地区法律。
因本协议产生的或与本协议有关的任何争议，双方应友好协商解决；协商不成的，任何一方均可向【公司所在地】有管辖权的人民法院提起诉讼。
九、 其他
本协议构成双方就本服务达成的完整协议，取代此前任何口头或书面约定。
本协议任一条款被认定为无效或不可执行的，不影响其他条款的效力。
我们对本协议享有最终解释权，并在法律允许的范围内保留随时修改的权利。修改后的协议一经公布即生效，继续使用服务即视为同意修订内容。
[已查阅](javascript:void(0);)
安全验证
拖动下方拼图完成验证
AI生成背景
您的速度已超过 99% 的用户
验证错误,请重试
确定
安全验证
刷新验证码
反馈
切换无障碍验证
切换常规验证
