Google Cloud が OKF v0.3 を公開:信頼レベルは最新の検証のみ対象に、Agent スキル2種を追加

Google Cloud はオープンな知識フォーマット OKF の v0.3 を発表。適合性ルール、最新の検証のみを数える信頼レベル、superseded_by などの仕組みを加え、ユースケースガイドと2つの Agent スキルも公開した。

ニュース日: 読了目安 9 分

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 は、AI agent(タスクを自動実行する AI アシスタント)が必要とする背景コンテキストを、プレーンな markdown と YAML ファイルで提供するオープン仕様です。同じフォルダにまとめて配布される知識ファイル一式は 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 の3段階の信頼レベルがありました。Google によると、v0.3 では「現在有効」な検証のみを数えます。つまり、検証の時刻がコンテンツの最後の実質的な変更(generated.at に記録)より前でないものです。

Google の例では、ある人物が指標の定義をレビューして承認し、1週間後に agent がその定義を修正した場合、その概念は誰かが再確認するまで machine-confirmed 扱いになります。古い承認は履歴としてファイルに残り、UI では「最終変更前にレビュー済み」と表示できます。v0.3 はさらに、human:、process: と並ぶ team: アクタープレフィックスを追加しました。ただし human-reviewed を得られるのは human: のみです。チーム名では、実際にどの担当者が内容を確認したのかを示せないためです。

既存の bundle に影響しうる変更は?

Google は、v0.3 には2つの破壊的変更(従来の読み方や動作が変わり、既存のツールに対応が必要になりうる変更)があり、既存の v0.2 bundle は引き続き読み取れると述べています。次の表に、この2点とその他の主な変更をまとめます。

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 での提案を歓迎しており、粗い下書きでも構わないとしています。

2つのスキルはオープンな 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で送る

出典

上記の参考資料および記載の確認日時点の情報をもとに整理しています。料金・時刻・機能・利用規約は変更される場合があるため、ご旅行や予約・購入の前には該当する公式サイトで最新情報をご確認ください。

ライフスタイル