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 分享

資料來源

本文依據上方所列參考來源與標示之核對日期整理;票價、時刻、功能規格或服務條款可能變動,出發、預訂或購買前請至相關官方網站確認最新資訊。

生活分享