Open Knowledge Format: The Markdown Standard for AI Agents

AI Agent 的智能程度取决于你提供给它们的上下文。

大多数团队都面临同样的瓶颈。你拥有强大的模型和稳健的框架，但 Agent 对你的组织一无所知。它不知道你的数据库表、指标公式或故障处理手册 (runbooks)。

这些知识散落在 Notion、Slack 和维基 (wikis) 中。为了让 Agent 获取这些知识，你通常需要为每一个数据源构建定制化的集成方案。

开放知识格式 (Open Knowledge Format, OKF) 改变了这一点。

OKF 是一种厂商中立的规范。它将你的知识打包为纯 Markdown 文件。任何 Agent 都可以直接读取，无需定制 SDK 或专用工具。

工作原理： 一个 OKF 包是一个包含 Markdown 文件的目录。每个文件代表一个概念，例如一张表、一个指标或一个 API。

为什么这种方式有效：

  • 通过文件路径进行身份识别：文件路径即是 ID。无需数据库或注册表。
  • 通过链接构建知识图谱：Markdown 链接在概念之间建立了联系。这使得一个文件夹变成了一个可导航的图谱。
  • 无需额外工具：文件系统本身就是 API。你不需要安装新软件即可使用。

如何使用：

  • 数据团队：记录表结构和指标，以便 Agent 编写准确的 SQL。
  • SRE 团队：编写故障处理手册，以便 Agent 能够诊断故障。
  • 平台团队：发布 API 定义，以便 Agent 理解端点 (endpoints)。

OKF 并不是 RAG 或 MCP 的替代品。

  • 使用 OKF 来管理稳定的、经过整理的知识，如 Schema 和故障处理手册。
  • 使用 RAG 来处理大规模、非结构化的文档存档。
  • 使用 MCP 来处理实时数据和工具连接。

该格式遵循 Apache 2.0 协议。它的分发成本极低，且能防止厂商锁定。你的知识存储在 Git 仓库中，并保持任何工具都可读取的状态。

从小处着手。找一个文档混乱的团队，编写三个 OKF 文件，然后让 Agent 指向它们。

Source: https://dev.to/suhas_mallesh/open-knowledge-format-okf-the-markdown-standard-your-ai-agents-have-been-waiting-for-3mfb

Optional learning community: https://t.me/GyaanSetuAi