Google Cloud 发布 OKF v0.3:信任层级只计最新验证,新增两项 Agent 技能

Google Cloud 宣布开放知识格式 OKF 推出 v0.3,加入一致性规则、只认最新验证的信任层级与 superseded_by 等机制,并推出使用案例指南与两项 Agent 技能。

新闻日期: 阅读时间约 6 分钟

LINE 分享
目录
  1. 1. OKF v0.3 相比 v0.2 改了什么?
  2. 2. 信任层级如何随 agent 编辑而更新?
  3. 3. 哪些变更可能影响现有 bundle?
  4. 4. 使用案例与 Agent 技能是什么?

Google Cloud 在其 Data Analytics 博客宣布,开放知识格式(Open Knowledge Format,OKF)v0.3 已于发文当天发布。OKF 是一套开放规范,用纯 markdown 与 YAML 文件为 AI agent(能自动执行任务的 AI 助手)提供所需的背景上下文;放在同一个文件夹、一起交付的这组知识文件称为 bundle。规范、使用案例与技能都放在新的独立 GitHub 组织。对于让多个 agent 共同编辑知识库、并在组织间交换的团队,这次更新让“谁审核过、审核后内容是否又被改过”更清晰可靠。

OKF v0.3 相比 v0.2 改了什么?

据 Google Cloud 说明,OKF 于 6 月推出,7 月的 v0.2 加入来源、信任、新鲜度、生命周期与认证等信任信号。v0.3 则聚焦于 bundle 在组织间流动、多个 agent 编辑同一语料,以及独立工具需要以相同方式读取 bundle 的场景。

  • 一致性:新增正式的一致性章节,规范自成一体并使用 RFC 2119 关键字(标示“必须”“应该”等要求程度的标准用词);采用 YAML 1.2 frontmatter(写在文件开头的元数据区块)、CommonMark(含 GFM 表格与脚注)与 RFC 3339 时间戳。
  • 共存:没有 type 的 .md 文件会被 OKF 消费端(读取 bundle 的工具)忽略,因此 README.md、AGENTS.md、CONTRIBUTING.md、SKILL.md 可放在 bundle 内。
  • 容错:消费端可接受 null、空字符串、应为列表却只有单个值等输入;验证器对格式错误只记录警告,bundle 不会因可选字段缺失或链接失效而失败。
  • 自描述:bundle 根目录的 index.md 可带 okf_version、title、description、license 等 frontmatter,供 agent 判断该使用哪个 bundle。
  • 替代:新增 superseded_by,让已弃用的概念指向替代者,也可用于移动与重命名。

信任层级如何随 agent 编辑而更新?

v0.2 为每个概念提供 unverified、machine-confirmed、human-reviewed 三种信任层级。Google 指出,v0.3 规定只有“当前有效”的验证才计入,也就是验证时间不早于内容最后一次实质变更(记录于 generated.at)。

以 Google 的例子说明:有人审核并签核某个指标定义,一周后 agent 修改了该定义,此时该概念只算 machine-confirmed,直到有人再次确认。旧的签核仍留在文件中作为历史,界面可显示为“最后一次变更前已审核”。v0.3 另新增 team: 行动者前缀,与 human:、process: 并列;但只有 human: 才能取得 human-reviewed,因为团队名称无法说明实际是哪位人员检查了内容。

哪些变更可能影响现有 bundle?

Google 表示 v0.3 有两项破坏性变更,且现有 v0.2 bundle 仍可读取。下表整理这两项变更与其他要点。

OKF v0.3 主要变更与兼容性(依 Google Cloud 说明整理)
项目v0.3 做法兼容性/备注
路径字段与链接解析带 scheme 者为绝对 URL;以 / 开头自 bundle 根目录解析;其余自所在文件目录解析破坏性变更;标示 v0.2 或更早、或无版本的 bundle,消费端也可自根目录解析
信任层级只有当前有效的验证计入破坏性变更;无需后备,因为层级只会降低
bundle 元数据index.md 可带 okf_version、title、description、license重新生成 index.md 的工具必须保留此 frontmatter
扩展字段允许出现在任何层级;编辑者须保留不认识的字段未来版本不会定义以 x- 开头的字段
版本政策1.0 之前的次要版本可有破坏性变更,并尽量附消费端后备自 1.0 起次要版本将严格为新增式,已发布的规范文本不会原地修改

使用案例与 Agent 技能是什么?

OKF 核心规范刻意保持精简,并链接 Avro、Protobuf、OpenAPI 等既有领域结构。Google 新推出的“使用案例”是搭配其他行业标准的指南,每份说明边界划分、如何连接两者、agent 应如何运用,并附可复制的完整示例。它们建立在核心规范之上而非其一部分,忽略它们的 bundle 仍符合 OKF。使用案例放在仓库 usecases/ 下各自的文件夹,Google 欢迎以 pull request 提案,初稿粗略也可以。

两项技能按开放的 Agent Skills 格式提供,任何支持技能的 agent 都能加载。根据 Google 说明,okf-generate 可编写、更新、迁移与验证 bundle,为每项主张引用来源,且仅在当事人确认时才记录人工审核;okf-consume 则从 bundle 回答问题,并针对所用概念报告信任层级、状态、新鲜度与认证结果,只通过 bundle 配置的 executor 与 attester 执行已认证的运算。

如何在 Gemini CLI 安装技能?

Google 的文章列出以下 Gemini CLI 命令,其他 agent 的安装步骤请见仓库 README。

Google 文章中的 Gemini CLI 安装命令(okf-generate 与 okf-consume) · bash
gemini skills install https://github.com/open-knowledge-format/open-knowledge-format --path skills/okf-generate
gemini skills install https://github.com/open-knowledge-format/open-knowledge-format --path skills/okf-consume

常见问题

我现有的 v0.2 bundle 还能用吗?

据 Google 表示可以,现有 v0.2 bundle 仍可读取,type 仍是唯一必填字段。路径字段的解析有后备机制,但信任层级改为只计当前有效的验证,会使部分概念的层级下降。

为什么人工审核后被 agent 修改,层级会降低?

因为 v0.3 规定验证必须发生在最后一次实质变更之后才算有效。旧的签核保留为历史,概念在有人重新确认前只算 machine-confirmed。

使用案例是核心规范的一部分吗?

不是。Google 说明使用案例叠加在核心规范之上,不采用它们的 bundle 仍符合 OKF;若某项惯例在多个案例中被证明有效,可按常规流程提议纳入核心规范。

OKF 的代码与规范在哪里?

Google 表示项目已移出 Google Cloud Platform GitHub 组织,改放在独立组织的仓库 github.com/open-knowledge-format/open-knowledge-format,内含规范、示例、使用案例与参考实现。

查看同分类最新消息

觉得这篇整理实用吗?分享给需要的朋友

LINE 分享

资料来源

本文依据上方所列参考来源与标示之核实日期整理;票价、时刻、功能规格或服务条款可能变动,出发、预订或购买前请至相关官方网站确认最新信息。

生活分享