#489 仕様書たった1ページ。Googleが出した「AIが読む知識」の置き方「OKF」

この番組は、エンジニアの成長は楽しい学びからをモットーに、昨日より少しだけ成長できる学びをお届けする、エンタメ系テックラジオでございます。

よろしくお願いいたします。

よろしくお願いいたします。さて、今日、えー、何を学んでいくべきか。

べきか？

はい。今日何を学んでいくべきか、もうお気づきですね。

むずいっすね。

OKFでございます。

OKF？なんだそれは。

これ、Googleが提唱したOKFでございます。

OKRみたいなやつ？

オブジェクティブ・アンド・キー・リザルツ。

リザルツ？

はい。とは—

オブジェクティブ、かな。

はい。それとはね、320度くらい違いますね。

あー、じゃあ40度しか変わんないってことですね。

そうか。

ははは、確かに。論破した。論破してしまった。

確かに。ベクトルにしたらそうだな。

はい。

まあ20度しか違わないっす。

じゃ、じゃあ。

40度か。

RかFの違いなのか、ほぼ。

まあ、そうだね。うーん、全然違うんですけど。

ファクター？違うんかい。

ん？

ファクターじゃないんですか。

全然違います。なんなら、あの、別に人材マネジメント系の話でもありません。

あー、じゃあ全然違うじゃないですか。

そうですね。これはですね、オープンナレッジフォーマットという、うーん、Google Cloudが2026年の6月に発表したですね、AIエージェントが読む知識をどのファイル形式で持つか、みたいなところを定めたフォーマット。

へえ、そんなのあるんだ。

で、今日はこれをね、まあどんなものなのかっていうのをちょっと読んでいこうかな、という回でございます。

はい、ありがたい。

はい。ただ、これね、実はめっちゃシンプルなんですよね。

いいですね。シンプルなのはいいことです。

うん。でも、これね、ちょっと、んー、どうだ、うーん、シンプルすぎて不安になると思う。

ほう。もう不安ですよ、その前置き。

不安だよな。

はい。

まあでも、この一緒、えーと、何、この不安を一緒に共有して、えー、一緒に強くなっていこうと思っていて。

わかりました。

はい。まずですよ。

うん。

これの仕様書。

はい。あ、ちょっとおさらいしていいっすか。おさらいっていうか、前提の整理さしていいっすか。

はい。

AIエージェントが利用する知識を記載するフォーマットですよね。

そう。

プロンプトってことで合ってますか。システムプロンプトみたいな。

いな。

違う。

プロンプトではないっす。

じゃあ、なんですか。

これはですね、AI向けのドキュメント？

ほう。

の、整理方法と言っていいでしょう。

ほー。AI向けのドキュメント？AIが何するときに使うドキュメントですか。

AIが参照するときに使うドキュメントですね。何かを。

知識？

ラグとか、ラグとかってさ。

はい。

えーと、何かを達成するにあたって。

うん。

情報をゲットして。

うん。

それを元にいろいろ考えて、えー、アウトプット作りますよね。

はい、はい、はい。

その何かを参照する部分のところのフォーマットを定めていると言ってもいいでしょう。

あー、わかりました。じゃあ、どっちかというと、その、なんか、動作とか、そういうのを定義するようなものというよりは。

うん。

AIエージェントが動く上で利用する、ほんとにナレッジ、知識。

うん。

えー、例えば、なんか、何かのサービスのQAチャットボット的なのがいたとしたら。

うん。

そのサービスドキュメントをどう整理するかみたいな。

うん。

ものを、ま、Googleが整備したやつってことなんですね。

そんなとこです。そうです。

あー、ありがとうございます。つかめましたよ。

それ、なんか、ナレッジマネジメント系。

はい、はい。

の、えー、フォーマットですと。

はい。

で、これ、なんと仕様書ですね。

うん。

たったの1ページでございます。

えー、すご。

これをね、すごいと捉えるか、すごくないと捉えるかはね。

はい。

あとで議論しましょう。

わかりました。

はい。で、えーと、まず仕様書がとてもシンプルで簡単なので。

はい。

どういう仕様なのかという話からいこうかな、もう。

うん。全文読み上げれるレベルなんじゃないですか、ひょっとして。

いけるかもね。

うん。

ま、ちょっと聞いて理解できるかは置いといて。

うん。いや、いけるかもしんない、理解まで。

マジっすか。

うん。

ただ、なんで？とはなるかも。

気になるな、余計に。

こ、構造はわかった。なんで？ってなるかもしんない。

ああ。

まずOKFのね、目的と思想からいきます。

はい。

これは、あの、仕様書を読み解いてるというよりは、えー、Claudeの説明を読み解いています。

はい。

で、まずですね、これ、あの、3つの原則を元に書かれております。

うん。

その1、最小限の制約。

うん、大事。

読み方のルールだけを決めておりまして。

うん。

AIがこれを読み取るときのルールだけ決めていて、えー、かなりそのルールは緩く作られてますと。

うん。

で、その2、生産者と消費者、えーとね、こ、この言い方じゃないな、多分これ、ドキュメントは。

なんかとコンシューマーですね。

うん。でもね、クリエイターでもないんだよな。なんて書いてあったっけな。

プロバイダー？

プロデューサー。

プロデューサー？あんま。

プロデューサーとコンシューマー。

聞きなじみなかったな。

これを、えー、独立させます。

はい、はい。

簡単に言うと、えー、そういうドキュメントを書く側と読む側に分離した上で。

ああ。

えー、ツールは自由に交換できますよ、みたいな。

うん、うん、うん。なるほど。はい。

うん。

なんか、あれですね。あー、ソリッドですね。

ソリッド。

はい。ソリッド、原則的な意味の。

うん。ちょっとでも、これはね、俺、あんまり内容、内容としてはしっくり来てないかもしれない。

うん。

ま、一旦3つ紹介します。

はい。

で、3つ目。これはプラットフォームではなくフォーマットですよと。

どういうこっちゃ。

いや、どこに保存するとか、そういう細かいことを規定してるわけではないと。どんなツールを使っても、えー、使えるように定めたフォーマットのルールです、っていう。

プラットフォームの意味わかってないかもな。

えー、まあ、1番わかりやすいやつだと、まずエージェントフレームワークですね。

ああ。

多分これに依存してるものとすると、えー、例えば、あの、Claude MDなんて、まあ、ぶっちゃけ、ぶっちゃけ本気出せば依存してないと思うんですけど。

うん。まあでも、ファイル名、Claudeじゃないと使えないっすもんね、あれね。

そうそうそうそうそう。そういうのにも依存、依存させないし、えーと、どこに保存するか、ま、データベースなのか、なんなのか、みたいなところとかね。ファイルなのかとか。

うん。

ま、そういうのにも依存させませんよと。

うん、うん。

これはあくまで、えー、そういう共通のルールとして使えるように作っていきますよ、っていう、そういう思想をね、感じますね。

うん、うん。まあ、なんかすごい。

うん。

素敵なルールですね。すごい。

素敵なルール。

賢い人が考えた感がある。

ここがこうだと、ここが、なんか動かしにくくなるから、みたいな、そういうこと？

そうそうそう。なんか、今後の、なんか、よくわからない分野の拡張性も、ある程度許容した懐の深さとか。

うん。

とはいえ、ここだけ定めとく、解いたほうがいいだろう、みたいなものとか。

うん。

で、今んとこ、その情報量が少ないのも、ま、真心だと感じていますけど。

あー、どっちだろうね。どっちだろうねって感じなんですよね。

多分、真心の部分と、まだ確定させたくないっていう気持ちの2つを感じますね。

うん、なるほど。

なんか、バージョニングにそれを感じるというか。

あー。

今、これバージョン0.1なんですよ。

なるほどね。

なので、なんか、真心プラス、いや、まだあるっしょっていう、なんか、可能性を感じてる部分の両方を感じるというか。

うん、うん。まあまあ、完成じゃないんですね。

まだ作ってく気満々だと思いますね。

うん。

うん。

で、えー、こっからはですね、じゃあどうなってるのっていう構造の話していきます。

はい。

まず、ファイルは全部マークダウンで作ります。

へー。え、いきなり結構どうぎもいの書いてるんですけど。

うん。

どぎもいすぎかな。ちょっと、僕の感覚が正しくなかったら申し訳ないんですけど。

はい。

ラグって別にマークダウンで保存されてないじゃないですか。

うん。

ベクトルじゃないですか、あれ、多分。

はい。

でも、えー、OKFでしたっけ。

うん。

えー、オープンナレッジフォーマットは、ま、マークダウン。

はい。マークダウンでございます。

まあでも、コーディングエージェントの知識はマークダウンですから、まあ、なんかそういうことってことか。

そうだね。まあ、これどっちかっていうと、あの、コーディングエージェント向けに、あのー、サービスのドメイン知識を渡すためのものと考えたほうがわかりやすいかもしれない。想像しやすいかもしれない。

あー、はい、はい、はい。じゃあ、その頭で聞こうかな。まあでも、マークダウンは、なんかそう考えると、まあ、まあまあまあ。

うん。

人間がね、見やすいしね。

そうそうそうそうそう。で、これ、人間が読めるってのもね、結構大事なポイントの1個です。

ほう。

エージェントも読めるし、人間もそれを読める。これはどっちも大事な、大事にしてそう。

うん。

あの、思想になかったけど。

それ、なんでなんですか。なんか、か、感じれます？

これはどっちの気持ちなんだろうな。ちょっとごめん、これ、Claudeの気持ちなのか、Googleの気持ちなのか、若干怪しいんですけど。

はい。

キャットでも見れるし、みたいなこと書いてあったな。

なんでキャットで見たいんでしょうねっていうと、まあ、やっぱり人間がその知識はメンテする必要があるから、あるよねってことなんですかね。

そうですね。で、あと、これ元々は、あの、ベースになってる考え方にLLMウィキってのがあるんですよ。

はい。

で、このLLMウィキも2026年の4月にですね、カーパシーさんっていう人が提唱した比較的新しいやつで。

比較的どころじゃないっすよ。

もうそう。

めちゃくちゃ新しい。

絶対的。絶対的新しさ。

あ、はい。今からするとね、あの、収録時点からすると。

今からすると。そう。まあでもね、1年後に聞いた人からすると、比較的古いになってしまってるかもしれない。

そうっすね。

まあ、今、これ撮ってる現在ではね、とても新しいです。

はい。

まあ、これもどうやってLLMの知識を整理してくのっていうやつなんですよ。

うん。

で、ラグって仕組み的に、毎回こう検索かけて、で、その拾ってきた情報を元に、えー、ナレッジを形成して、それで、えー、回答しますよ、みたいな。

うん。

もう、毎回毎回やってるっていう。

うん、うん、うん。

脳みそと同じっすね。

うん、うん。

脳みそも思い出すとき、毎回こう再構築して作ってるらしいんですけど。

あー、まあ、そうかもね、確かに。

そう。なんか、あれ、あるものを見つけてるんじゃなくて、毎回思い出してるらしいっすよ、あれ。

おも、お、思い出すっていう、なんか、ワードチョイスもむずいっすね。なんか、思い出すというか。

うん、そうだね。思い出すっていう説明の中に、思い出すを使ってしまうと、もう崩壊してるんだけど。毎回あれ構築してるらしい。

はい、はい。構築が正しそうっすね。

そう。で、構築するのに、な、なんだ、必要な電気回路がどんどんそれで強くなってって、えー、暗記してるかのようになる、みたいな。

なんか、実際ね、その、言語化とか言葉にするっていうのも、なんか、再構築してしゃべってる感覚ですもんね、どっちかっていうとね。

うん、そうね。あー、確かに。それはそうかも。

はい。

なんで、結構ラグはそういう動きをしている。

まあ、どこまでも日本の、日本じゃねえや、人間の脳を模してますね。

うん。そう。でもラグ、間違えた。えー、LLMウィキはちょっと、えー、それを1歩進めてるというか。まずデータソースはこう、人間がちゃんと用意する、みたいな。

うん。

で、その状態で、えーと、LLMがそのデータソースを元にウィキを作ると。

はい。

あ、これなんて書いてあったっけな。なんか、LLMウィキだとね、なんか、ザ・ウィキみたいなものを作るって言ってた気がするんだよな。

あー、もう、LLMにとってはもうそれがウィキであり、それ以外はウィキでないと。

そう。

はい。

あー、うん。しかも、ちゃんとザ・ウィキって書いてました。

うん。

これ、あの、あとでGitHubのページの、あの、リンクも貼っておきます。

はい。あとでというか、説明欄にですか。

うん。説明欄に貼っておきます。

はい。

あと、なんか、ザ・スキーマってのもあるな。すごいな、これ。LLMウィキのアーキテクチャすごいぞ、これ。RawSourcesがさっきの生データっすね。

えーと、すいません、生データっていうのは、ま、マークダウンとかじゃなくて、えーと。

うん。

渡す事前知識の情報の生データですね。

これは、うん、そう。わた、僕が集めた、えー、ソース群。

なんか、いろんな形式があり得るっていう理解で合ってますか。

いろいろあり得る。画像とかもあり得る。

うん、うん。

で、LLMはここは読むだけで絶対書き換えちゃいけませんっていうルール。

うん、うん。

で、ザ・ウィキは、えー、それを元に生成した、ま、サマリーページとか、ま、概念ページとか、比較とか、なんか、そのLLMが作るウィキ。

うん。

で、ここは基本はLLMがもう作って、人間は書き換えないっすと。あなたは読むだけですと。

うん。

で、最後、ザ・スキーマ。これはLLMにウィキの構造や監修、ワークフローを教える文章。

うん。

これはね、要は、あの、Claude MDとかCodexのエージェンツ、MDみたいなやつらしいですね。

あー、えっと、わかるんですけど。

うん。

正しくClaude MDを使ってないと、多分伝わんなくて。

あ、そうなの？

はい。あの、Claude MDに、別に、あの、知識書きうるじゃないですか。

あー、まあ、書きうるね。

はい。ただ、それは正しい使い方じゃなくて。

うん。

ちょっと、今わかんなかったのが。

うん。

ウィキには、あの、データの、なんだ、なんか、調査とか、あとは、その、データから読み取れない、その、背景知識みたいなものが多分書かれると思うんですけど。

うん、うん、うん。

ウィキの中には、そのデータが、の構造とか、ウィキの構造は書かれないってことなんですね。

そう。

で。

ん？

いや。

あー、こ、あー、構造は書かれるかもしれない。えっと、これ、すみ分けを簡単に言うとですね。

はい。

ウィキはどうなっているか、が書かれている。

どうなっているか。

うん。

で、データが？

データがというか、この世が。

はい、はい。

何がが書かれてるのがウィキ。

はい。

で、命令が書かれてるのがスキーマだと思う。

じゃあ、あ、今って登場人物全部出ました？ データとウィキとザ・スキーマ。

えーと、出ました。

で、えー、実際にAIエージェントが情報をたどる際には、スキーマから読み始めるんですか。

そう。

で、スキーマ読んで、あー、これここにありそうだわっつってウィキ見て、ウィキ読んだ上で、ま、すべてがそこにあるのか、ウィキになかったらさらにそのデータを読みに行くのかみたいなので。

うん。

情報を参照して。

うん。

えー、元の、ま、例えばチャットボットとかだとしたら、その質問に答えるような。

うん。

情報を作るっていうイメージなんですね。

だいぶそのイメージです。

あー、なるほどねー。

うん、うん。

なんか、話、やや飛ばしなんですけど。

はい。

今って、ま、調べ物するときとか。

うん。

なんか、そういうやり方してて、今。

調べ物するとき。

はい。なんだろうな。じゃあ、例えば、その、O、OKFについて調べようと思ったときに。

うん。はい、はい、はい。

とにかくOKFの情報を含んだ、ま、URLやらページやらを、まず一旦集めますと。

うん、うん、うん。

で、それが多分、いわゆるデータ？ データでしたっけ、名前。

RawSources。

あ、RawSources。

うん。

で、RawSourcesを元に、なんか、調査レポートを書かせるんですよ。

うん、うん。

何枚も。その各分野に対する。

うん、うん、うん。

で、その上で、それらを、なんか、まとめたレポートまとめページみたいなのを作って。

うん。

で、それと壁打ちしながら、今、なんか、原稿割と作ってるんですよ。

おー。

で、それもなんだっけな。なんか、ちょっとどっかのYouTubeので見た、なんか、やり方パクってやってたりするんですけど。

うん、うん、うん。

なんか、それに近いなと思いました、っていう。

おー、なるほどね。今、俺、それを聞いてて、なんか、ちょっと、頭ん中にほんわかディープリサーチの動きが出てきましたね。

あー、でもそうかも。

ディープリサーチって、なんか、多分、えーと、最初にどうやって情報収集するかっていう計画が出てきて。

はい。

それを元にRawSourcesバーッて集めてきて。

うん。

で、集めた情報を統合して、ウィキを作るよねっていう。

うん、うん、うん。そうっすね。Claudeのディープリサーチも、おおむねそんな動きをしてる気がする。

うん、うん、うん。

じゃあ、なんか、そ、そ、それって、あれなんですかね。やっぱり、各AIエージェント、ま、コーディングエージェントとかにも、そのDNA入ってるんですかね、このOKFの。

OKF、DNA入ってんのかな。入ってないんじゃないかな。

あ、入ってないんですか。

まだ。

ある程度、なんか、複雑そうな情報を整理する上で、なんか、こういうフォーマットで進めようぜ、みたいなのが、ディープリサーチの動きから垣間見えるってことかなと思ってて。

あー、でね、ちょっとごめんなさい。あの、途中でいきなりLLMウィキの話に飛んでしまったので。

はい。

えーと、どっちかっていうと、LLMウィキがさっきのやつですね。あの。

はい。

ウィキとスキーマとソースは。

はい。

で、えーと、このオープンナレッジフォーマットOKFはですね。

はい。

ただ、LLMウィキ、すごいいい考えだけど、弱点もあるよねっていう。

ほう。

ところから、なんか、出てるんですよ。

あー、じゃあ、また別なんですね。

うん。で、まずLLMウィキって、結構、その、オブシディアンベースで考えられてるんですよ。

はい。

なので、えー、まずそこが、あの、プラ、ま、プラットフォームに依存しちゃってるよねっていう。

うん。

ところ。

うん。

に行ってしまっていると。

うん。ちょっと、そうなのかがよくわかってないけど、まあ、一旦飲み込みましょう。

あ、そう。で、LLMウィキはさっきのやつをオブシディアンで作ろうねってこと書かれてるんですよ、もう。

あ、オブシディアンで作ろうねなんですね。

あ、そう、そう、そう。

なんか、別にね、階層構造のマークダウンだったらなんでも良さそうですけどね。

まあ、まあ、そうなんだけどね。

はい。

うん。これ、なんでなんだろうね、確かに。

うん。オブシディアン好きだったんでしょうね。LLMウィキ作った人が。

あれ、か、書かれてるな。あれ、うそだったらすいません。

あ、はい。

いや、でもね、あの、その、もうウィキのウィキ？ GitHubのね、作ってるページの中にね、もう、オブシディアンってめっちゃ書かれてますね。

ふーん。

設定こうしろよまで書かれてる気がする。

へー。まあ、なんか、思想がそっちなのかな、その。どっちかっていうと、レールを敷いて。

うん。

その通りやれば、ある、ある程度うまくいくぜっていうタイプの。

うん、うん、うん。

法整備をする人なのかもしれない。

かもね。

だって、オブシディアンじゃなきゃいけない理由ない、あるわけないもんな。多分。

うん、まあね。でも、なんか、推奨設定まで書かれてるってことは、まあ、僕のこの考えだってやるなら、オブシディアン使うとめちゃはまるよっていうことなんだろうね、きっと。

はい。

ま、ていうのもあって、えー、そっから、なんか、あの、もっといろんなとこで使えるようにしようよっていうので出て、出てきたのが、えーと、OKFなんですよ。

はい。

ていう。

はい、はい、はい。

で、ちょっとすいません、これザ・ウィキの話、ザ・ウィキじゃねえや。LLMウィキの話が、あのー。

ちょっと。

これと言ってしまって、これ、元々何の説明しようとしてたのか、ちょっと思い出せてないんですけど。

すいません。

ど、ど、ど、ど、ど、ど、ど、ど、ど、ど、まだあれじゃないですか。

惑わせてましたっけ。

まだあれだよね。あの、フォーマットの話してないよね。

してない、してない。

そう。で、えーと、これね、じ、ここまで、あの、いろいろ話してきてるんですけど。構造は超シンプルなんですよ。

うん。

まずフォルダとね、マークダウンだけですと。

一緒じゃないっすか。LLMウィキと。

ほぼ一緒、ほぼ。

ほぼ一緒。

はい。

でも、オブシディアンは使わない。

はい。

はい。

い、一緒ですよ、今んとこ。

今んところね。

僕は、僕ら。

いや、いや、オブシディアン使わないは今んところ違うんだけど。

はい。

えー、まずそこがマークダウンとフォルダのみですと。

はい。

で、作るマークダウンのフォーマットのルールがあります。

ほう、はい、はい、はい。

ファイルの中身がに制約があるんですね。

はい。

で、まず、え、YAMLフロントマターって聞いたことあります？

うわー、知らん。なんすかそれ。

これは、えーと、割と最近のマークダウン形式のファイル見たときに、なんか上のほうにさ、あの、ハイフン3つで区切られて、なんか、いろんな情報が書かれてる。

はい、はい、はい。

スタイル。

なんか。

見ません？

オブシディアンとかもありますよね。

あ、てか、オブシディアンはまさにそう。

はい。

ノーションも実はエクスポートしたらそう。

あー、そうなんだ。はい。

そう。こういうのYAMLフロントマター、ああいう形式で書かれてるやつ、YAMLフロントマターっていうやつらしいんですけど。

なんか、マークダウンのメタデータ書かれてるみたいなイメージなんですかね。

あ、そう、そう、そう、そう、そう、そう、そう。

なんか、作られた日とか。

うん。で、な、何書くかのルールは多分ね、あのー、プラットフォームによって違うと思う、フォーマットとか。

はい。

で、えー、そこに書くルール、唯一の必須ルールがあります。

はい。

それは、タイプというものを作る。

ほう。

以上。

何が入るんだ、タイプは。

まずこれ、1ファイル1コンセプト書きましょうっていうのがルールであるんですけど。

はい。

そのコンセプトの、ま、タイトルみたいな感じだね。

え、なんか、ゆるすぎてなんの意味があるかわからない。

いや、そう。で、えーと、そうなんですよ。ついに気づいてしまいましたね。

はい。

僕も基本的にこれ全体読んでて、まずゆるすぎて、なん、何のためのやつかよくわかんないってのが結構あった。

はい、はい、はい、はい。

うん。一旦、あの、そのゆるさを確かめるために他も言ってっていいっすか。

いいっすよ。

で、別に、あの、なんでしょう、このファイルの種類以外にもいろんなルールがあります。

はい。

で、えー、まずタイプが必須。

はい。

これだけが唯一の、えー、必須ルール。

はい。

このファイル形式においては。

うん。