回到頂部
一組文件、指標與操作流程被整理成 AI 代理可讀知識包的深色技術插圖

OKF 是什麼?給 AI 代理讀的知識包白話指南

OKF 是 Google 的開放知識格式,把文件、指標、SOP 整理成 AI 代理可讀的知識包。用非工程視角看用途、適用團隊與導入時機。

內容查核: 來源查核:

如果你聽到 OKF 的第一反應是「又一個工程規格」,可以先把它當成一套公司知識整理法。當 AI 代理要回答「退款規則怎麼判斷?」「這個數字怎麼算?」「這份 SOP 哪一版才是最新?」它需要一份可靠、可更新、能追到來源的知識。

OKF(Open Knowledge Format)的做法,是把一組相關知識整理成一個資料夾。資料夾裡每份知識都用 Markdown 寫成檔案,檔案開頭再放一小段 YAML 欄位,標明這份知識的類型、標題、來源、標籤與更新時間。人可以直接讀,AI 代理也能用這些欄位判斷該讀哪一份、能不能引用、是否已經過期。

這篇先給產品、內容、客服、營運、資料與工程主管看。你不需要先會寫程式;先判斷 OKF 跟你現在遇到的知識混亂有沒有關係,再決定要不要請工程或資料團隊評估實作。

本文依據 Google Cloud 官方公告、OKF 0.1 版規格、GitHub README 與 commit 紀錄整理。Google Cloud 的參考工具尚未在本站實測,因此本文把 OKF 當成新草案與導入方向來評估,不把它寫成已驗證的正式標準。

OKF 是什麼?用四個概念看懂

一句話:OKF 是「一個知識包+多份知識檔+檔頭欄位+正文」。

OKF 概念用白話說常見例子
知識包(knowledge bundle)一整包相關知識,通常是一個資料夾或 repo客服政策知識包、產品規則知識包、資料指標知識包
知識檔(concept document)描述一個主題的 Markdown 檔退款規則、週活躍使用者定義、訂閱方案限制
檔頭欄位(YAML frontmatter)檔案最前面的小型資料卡類型、標題、來源、標籤、最後更新時間
正文(Markdown body)人類直接閱讀的說明定義、範例、限制、判斷步驟、引用來源

這裡的「知識」範圍比工程文件更廣。只要是代理需要穩定引用、不能亂猜的內容,都可以放進這種整理方式裡,例如:

  • 客服退款與升級規則。
  • 產品功能限制與適用對象。
  • 行銷活動的品牌用語與禁用語。
  • 內容審稿標準與更新週期。
  • 公司內部 SOP。
  • 營收、留存、活躍使用者等指標定義。
  • 資料表、程式介面(API)與系統限制。
  • 事故處理紀錄與應變流程。

代理讀到 OKF 知識檔時,除了段落文字,也會取得知識類型、來源、最後確認時間,以及可連結的相關知識。

OKF 想解決什麼問題?

很多公司的痛點在於:知識存在,但太分散。規則在雲端文件,最新說法在 Slack,表格定義在資料工具,例外狀況在客服主管腦中,真正的限制又寫在工程文件裡。

人類還可以靠經驗判斷哪份比較新。代理比較麻煩:它可能抓到舊文件、引用錯來源,或把兩套互相矛盾的規則混在一起。最後看起來像模型亂回答,其實問題常出在「公司沒有一份可被信任的知識來源」。

OKF 的思路是先把可分享的知識變成普通檔案。普通檔案有幾個好處:

團隊需要的能力OKF 的做法實際價值
人能讀懂用 Markdown 寫正文產品、客服、營運與工程能共同維護
代理能篩選用檔頭欄位標明類型與來源先挑對知識,再讀細節
能追版本放進 Git 或文件系統更新可審查、可回溯、可找責任人
能搬移不綁單一知識庫服務換工具時知識比較不會被鎖死
能互相連結用一般文件連結串概念指標、規則、流程和來源可以形成知識網

換句話說,OKF 不等於新的聊天機器人。它比較像把「代理要讀的公司知識」整理成一套人類也能維護的格式。

跟 llms.txt、RAG、MCP 差在哪?

這幾個名詞常被放在一起講,但處理的層次不同。你可以先這樣分:

名稱白話理解跟 OKF 的關係
OKF知識本身怎麼整理把客服規則、產品限制、指標定義整理成知識包
llms.txt告訴 AI 這個網站有哪些重要頁面可以把 OKF 入口或文件站列進索引
RAG從知識庫找片段,再交給模型回答OKF 可以成為比較乾淨、可維護的資料來源
MCP讓代理連接工具與服務工具可以讀 OKF,或把 OKF 裡的知識提供給代理查詢
NLWeb / WebMCP讓網站或瀏覽器提供代理可調用的能力更偏網站查詢與操作;OKF 偏知識內容整理

如果你是內容或營運負責人,先不用背這些英文縮寫。重點只有一句:OKF 管的是「知識本身要長什麼樣」,其他技術多半在處理「代理要怎麼找到知識、怎麼使用工具」。

如果你想把 OKF 放進更完整的代理網站脈絡,可以接著看本站的 MCP 開發指南;如果你的任務偏向文件站與 AI 可讀內容,則可搭配 GitBook AI 文件、llms.txt 與 MCP 指南 一起評估。

非工程團隊可以怎麼用 OKF?

OKF 最容易被誤會成資料工程規格,但它的價值也延伸到客服、內容、產品與營運知識。以下幾種情境更接近一般團隊會遇到的問題:

角色或團隊可以先整理的知識為什麼值得
客服主管退款規則、升級流程、補償條件客服機器人回答時比較不會引用舊政策
內容團隊品牌語氣、禁用詞、審稿標準、更新週期寫作或審稿工具可以依同一份規則判斷
產品團隊功能限制、方案差異、適用/不適用客群業務、客服與文件不會各說各話
營運團隊活動規則、例外處理、跨部門責任遇到客訴或異常時可追到最新版本
資料團隊指標定義、資料來源、計算方式AI 產報表或 SQL 時比較能引用同一份定義
工程團隊程式介面、服務責任、權限與風險代理執行任務前能先讀限制

一個非工程試點可以從「退款政策」開始,不必一開始就整理全公司知識庫。你可以先建立三份知識檔:

客服知識包/
├── 退款規則.md
├── 補償條件.md
└── 升級人工處理.md

每份檔案至少寫清楚:這份規則適用誰、權威來源在哪裡、最後誰確認、多久要重看一次、代理可以直接回答哪些情境、哪些情境必須轉人工。

這樣做完後,就算還沒有完整代理,也能先改善文件治理。等到要接客服機器人、內部搜尋或自動審稿工具時,代理讀到的是一包有來源、有責任人、有更新節奏的知識,而非散落在各處的舊文件。

如果你是資料團隊:再看指標知識包

資料團隊可以從「週活躍使用者」這種常被問、也常被算錯的指標開始。先建立一份指標知識檔,寫清楚權威資料表、計算公式、排除條件、資料負責人、最後確認日期與可引用來源;再補上資料延遲處理方式與常見例外。

這個試點的成功標準看三件事:新人能看懂指標變更,分析師能追到權威來源,代理在產生報告或查詢語句時會引用同一份定義。若連這個小知識包都維護不起來,就先不要擴到客服、合規或跨部門知識庫。

如果團隊已在 Google Cloud 上做代理,OKF 也可以和 Google ADK、Vertex AI Agent Engine 這類架構互補:代理平台負責執行任務,OKF 負責整理代理要讀的知識脈絡。

現在該不該導入 OKF?

建議用團隊狀態判斷:

團隊狀態建議
只是一般內容網站或部落格不必急著導入 OKF。先顧好內容品質、結構化資料、FAQ 與 llms.txt。
正在用生成式工具寫文件或做內部問答可以先借用 OKF 的精神:重要知識用文件寫清楚,補上來源、責任人與更新日期。
已有客服機器人、內部搜尋或 RAG值得挑一個高價值知識區域試做,降低舊文件與 PDF 造成的混亂。
正在做代理或跨工具自動化值得正式評估 OKF,並同步設計權限、審查與更新流程。

對 SEO 或內容網站來說,OKF 目前不屬於搜尋排名因素。它比較像 AI 時代的知識治理工具:你的內容能不能被人與代理正確理解、引用、更新,才是核心。

實作時要注意的限制

OKF 現階段仍是 0.1 版草案,距離成熟標準還有距離。導入前要先接受幾個限制。

1.格式不會自動救內容品質

文件格式再漂亮,如果內容過時、定義互相矛盾、沒有負責人,代理還是會讀到錯誤脈絡。OKF 最有價值的地方是讓知識可以審查、比對、引用與追蹤;它不能替你決定哪個說法才是公司真相。

2.欄位太自由會失控

官方規格刻意保持彈性,目前只強制每份知識檔要有 type。這讓格式容易採用,但企業內部最好仍訂一份自己的欄位慣例。

建議至少統一:

  • 知識類型。
  • 負責人。
  • 權威來源。
  • 檢查週期。
  • 保密等級。
  • 代理可使用範圍。
  • 是否已停用。

3.權限需要另外設計

OKF 知識包可以很容易被複製、索引與交給代理讀。這是優點,也是風險。涉及個資、營業秘密、客戶資料、內部事故、合約條款時,要把 OKF 放進既有權限與審計流程,避免把整包敏感知識直接交給模型。

4.不要把 OKF 當成唯一資料層

OKF 適合描述脈絡與知識,不適合取代資料庫、功能規格、程式介面文件或正式資料目錄。比較健康的做法,是讓 OKF 引用這些權威系統,並把「人與代理真正需要理解的上下文」寫清楚。

最新時間線:官方 repo 已經有後續修正

時間軸要看官方公告,也要看 GitHub repo。

時間事件編輯判斷
2026-06-12GoogleCloudPlatform/knowledge-catalog repo 匯入 OKF 參考工具OKF 已有規格、README、範例知識包與參考工具,超過單篇 blog 概念介紹
2026-06-13Google Cloud Blog 顯示「Introducing the Open Knowledge Format」發布一手公告,定位為可攜、人類與代理都能讀的知識格式
2026-06-13GitHub repo 修正 OKF 內部連結,改用相對路徑實作細節仍在調整;寫工具時要看最新規格與 repo,單看新聞轉述不夠

這個後續修正很有意思:它把概念之間的連結改成一般 Markdown 在 GitHub 裡也能正常瀏覽的寫法。這代表 OKF 很重視「普通文件在普通工具裡也要可讀」,服務對象不侷限於某個特定平台。

給繁中團隊的採用建議

OKF 短期內不會變成每家公司必用的標準,也不保證會被所有雲端或 AI 平台採納。

但它抓到一個真正的問題:企業代理要可靠,不能只靠更大的模型或更長的上下文。代理需要的是可維護、可驗證、可追溯的知識供應鏈。

如果你的問題是「代理不知道公司規則」,OKF 可能比換模型更值得研究;如果你的問題是「使用者需求還沒驗證」,OKF 的優先級很低。

FAQ

OKF 是 Google Cloud 專用格式嗎?

Google Cloud 官方把 OKF 定位為可攜的開放知識格式;規格本身是 Markdown 檔案加 YAML 欄位,不需要 Google Cloud 帳號或特定 SDK 才能讀。不過 Google Cloud 同時提供 Knowledge Catalog 與 BigQuery 相關參考工具,Google 生態的整合會比較早出現。

非工程師需要懂 OKF 嗎?

需要懂概念,不一定要懂實作。產品、客服、營運、內容與資料主管真正要判斷的是:公司是否有一批常被 AI 引用、常被問、又容易過期或互相矛盾的知識。如果有,就值得請工程或資料團隊評估 OKF 類似的整理方式。

OKF 可以取代 RAG 嗎?

不建議這樣看。RAG 是「怎麼從知識庫找資料再回答」的做法,OKF 是「知識本身要怎麼整理」的格式。OKF 可以讓 RAG 的來源更乾淨、更可維護,但仍然需要檢索、權限控管、提示設計與評估。

小公司需要現在導入 OKF 嗎?

如果只是一般內部文件,不必為了追新規格而改造。更好的做法是先用 OKF 的精神:重要知識用 Markdown 或文件寫清楚,加上來源、負責人、更新日期與適用範圍。等 AI 工作流真的需要,再補更完整的知識包規範。

OKF 和 llms.txt 最大差別是什麼?

llms.txt 比較像網站給 AI 的索引入口,告訴 AI 哪些頁面重要;OKF 則是把一組知識整理成可攜、可維護的知識包。簡化說:llms.txt 告訴 AI 去哪裡看,OKF 定義 AI 看到的知識包長什麼樣。

OKF 對 SEO 或內容網站有用嗎?

短期 SEO 影響有限,因為 OKF 主要面向企業知識與代理脈絡,目前不屬於搜尋排名因素。但對文件站、教學站與產品知識庫來說,OKF 的思路可以幫助內容變得更容易被代理正確引用。這和 GitBook AI 文件、llms.txt 與 MCP 的方向一致:內容要讓人看得懂,也要讓 AI 能正確引用。

參考來源

№ · further reading

延伸閱讀