OKF ガイド
Open Knowledge Format (OKF) とは?
Open Knowledge Format (OKF) は Google Cloud が公開した、YAML frontmatter 付き Markdown ファイルのディレクトリとして精選知識をまとめる開放仕様で、人と AI エージェントの両方が読めます。
ひとことで言うと
OKF は知識を通常の Markdown ファイルとして保存し、先頭に小さな YAML frontmatter を付けます。Markdown であり、ファイルであり、少数の構造化フィールドだけ:データベース、API、SDK は不要です。AI エージェントがファイルを直接読み書きし、ファイルシステム自体がインターフェースになります。
OKF ファイルの構造
各 OKF 文書は、人が読める Markdown 本文と、クエリ可能な少数フィールドのための型付き frontmatter で構成されます:type、title、description、resource、tags、timestamp。本文は自由形式の Markdown のままなので、どこでも表示でき編集も容易です。
AI エージェントが OKF を使う理由
エージェントは精選され安定した文脈で最も力を発揮します。OKF は毎回ゼロから導出せずに直接読み込める事前コンパイル済みの知識層を提供します。llms.txt(サイト単位の地図)や Model Context Protocol(必要時にデータを取得)を補完します。
関連する OKF ツールとガイド
FAQ
Open Knowledge Format は誰が作りましたか?
OKF は Google Cloud のデータチームが Apache-2.0 の開放仕様として公開しました。v0.1 は意図的に小さく、生産者と消費者が増えるにつれ進化する見込みです。
OKF は llms.txt と同じですか?
いいえ。llms.txt は AI システムを重要な URL へ導くサイト単位の単一 index です。OKF は精選知識そのもの:エージェントが文脈に読み込む型付き Markdown ファイルの束です。
OKF はどう使い始めますか?
テンプレートから始め、OKF バリデーターに貼り付けて frontmatter を確認し、API、dataset、metric、製品ドキュメント向けの focused file を公開します。