AIエージェントが操作して知識グラフを管理するCLI「okf」

okf は、Open Knowledge Format（OKF）のための Go 製 CLI ツールキットです。最新版 v0.2.0 では、信頼レベル、来歴、ライフサイクル、アテステーション計算などの新機能が追加されました。このツールはエージェントファースト、JSON ネイティブ、ベンダーニュートラルな設計で、AI エージェントが知識グラフを管理するための CLI として利用できます。

OKF は Google が提唱するオープンな知識フォーマットですが、公式のリファレンス実装は Python と Gemini、BigQuery に強く依存しています。そのため、Google のクラウドスタックを利用しないエージェントは公式ツールを扱えません。okf は単一の Go バイナリを提供し、Python 環境や API キー、BigQuery を必要とせず、どこでも動作する中立的な代替手段です。

okf の設計思想は「エージェントファースト」です。CLI が内部で LLM を呼び出すのではなく、外部の AI が okf schema コマンドを通じて CLI 全体の JSON マニフェストを取得できます。マニフェストには各コマンドの引数、出力形式、終了コードが含まれ、エージェントはこれに基づいて CLI を操作します。stdout には JSON のみが出力され、診断情報は stderr に送られます。終了コードはエラー種別と 1 対 1 に対応し、プロンプトエンジニアリングなしでエージェントが処理を分岐・復旧できます。

v0.2.0 の主な強化点は、OKF v0.2 仕様の完全実装です。信頼レベル（未検証、機械確認、人間レビュー）は各概念に自動で付与され、来歴情報は著者、使用回数、最終変更日などのソースクレデンシャルとともに管理されます。ライフサイクル（draft、stable、deprecated）と stale_after により、データの鮮度を日付比較で判断でき、失効当日に検証で警告されます。また、新しい概念タイプ「attested computations」では、ランタイム、型付きパラメータ、実行器、決定的アテスターを含む契約を定義し、okf がバンドル内の契約パスを検証します。

ツールには 11 のコマンドが含まれ、すべて既定で JSON を出力します。スキーマとバージョンに加え、バンドル作成の init、インデックス生成の index、バリデーションの validate、lint、一覧の list、検索の search、詳細表示の show、グラフ構築の graph、逆参照の backlinks などがあります。これらは 88 のテストで検証され、Go 標準ライブラリのみに依存し、Apache 2.0 ライセンスで提供されています。Google の knowledge-catalog リポジトリにあるすべてのリファレンスバンドルをエラーなしで検証しており、v0.1 の旧形式バンドルも移行警告付きで動作します。

インストールは Homebrew または go install、ソースからのビルドに対応し、cosign 署名と SBOM が付属します。任意の AI エージェントに知識グラフ管理を統合したいチームにとって、okf は堅牢でオープンな基盤となるでしょう。