【ITニュース解説】Go's ecosystem is going agent-readable

Go言語のエコシステムでは、情報提供のあり方が大きな転換期を迎えている。これまでは人間が理解しやすい形式が中心だったが、近年、AIエージェントなどのプログラムがGoパッケージやツールをより効率的かつ安定的に利用できるよう、情報が構造化されたデータ形式で提供される動きが加速している。

Goパッケージの公式情報源であるpkg.go.devは、以前はウェブサイトのHTML形式でしか情報を提供していなかった。そのため、プログラムがその情報を利用するには、HTMLを解析するしか方法がなかった。この方法は、ウェブサイトのデザインや構造が変更されるたびにプログラムの修正が必要となるなど、不安定な側面を持っていた。しかし、2023年6月にGoogleはpkg.go.devのAPI（アプリケーション・プログラミング・インターフェース）を公開した。このAPIは、Goのパッケージやモジュールのメタデータ、バージョン情報、含まれるシンボル（関数や変数など）、そのパッケージが何に利用されているか、脆弱性情報などをJSON形式で提供する。JSONは機械が処理しやすいデータ形式であり、このAPIは特に機械がGoパッケージに関する情報を正確かつ決定論的に理解できるように設計されている。構造化されたAPIによる情報アクセスは、かねてより強く求められていた機能だったため、このリリースは大きな意味を持つ。

Goパッケージの情報提供だけでなく、個々の開発ツールのレベルでも同様の課題と解決策が見られる。一般的なコマンドラインインターフェース（CLI）ツールをプログラムから利用する場合、その使い方を知るためには、--helpコマンドのテキスト出力を解析したり、コマンドを実行した結果のテキストを推測したりする必要があった。これもまた、テキストの書式変更によってプログラムが壊れる可能性をはらむ不安定な方法だった。これに対し、ax-goというツールは、この問題を解決している。ax-goは、任意のCLIツールに対して__schemaという特別なコマンドを提供し、そのツールが持つコマンド、利用できるフラグ、期待されるデータの型などをJSON形式で前もって提供する。これにより、エージェントはツールの詳細を正確に把握し、安定して利用できる。この情報は、常に同じ入力に対して同じ形式の出力を保証するように設計されており、エージェントが利用することを前提としたMCP（Machine Readable Command Protocol）という特定の形式でも情報を提供できる。

このような「スクレイピングして推測する」から「質問して取得する」への変化は、Goのエコシステム全体で加速している。pkg.go.devのAPIが提供されたことで、パッケージの情報は機械が直接問い合わせて取得できるようになった。そして、CLIツールレベルではax-goが同様の構造化された情報提供を推進している。興味深いのは、Googleが新しいpkg.go.dev APIの参照クライアントとして公開したpkgsite-cliというツール自体が、JSON形式のAPIを消費するGo言語製のコマンドラインツールであることだ。これは偶然ではなく、人間が使う場合でも、スクリプトやエージェントが使う場合でも、同じように安定した構造化された情報を返すことを標準化するという、ax-goが提唱するのと同じアプローチを示している。つまり、Goエコシステムの入り口となる公式ツール自体が、この新しい情報提供の形を体現しているのである。

Go言語のバージョン1.27がリリースされた際、直接的に「エージェント」という言葉は使われていないものの、その機能の多くは機械がGoコードをよりよく理解し、操作できるようにすることを目的としているように見える。例えば、テストを実行するgo test -jsonコマンドの出力には、新たにOutputTypeというフィールドが追加され、出力された行がエラーメッセージなのか、スタックトレースなのか、通常の出力なのかを明確に区別できるようになった。これにより、エージェントは正規表現で推測することなく、テスト結果を正確に解析できる。また、go testはデフォルトでstdversion vetというチェックを実行するようになった。これは、Goモジュールが指定しているGoのバージョンよりも新しい標準ライブラリのシンボルを使用しているコードを検出する機能であり、機械が生成するコードに起こりがちな問題を自動で検出できる。さらに、go fixコマンドには4つの新しいモダン化機能が追加された。これらはコードの機械的な移行を決定論的に適用するもので、機械が複雑な推論なしにコードを更新できる。Goのエコシステムはこれに応えるように、JetBrains社もエージェントが直接実行できるCLIプラグイン「Modern Go Guidelines」をリリースするなど、業界全体で機械対応が進んでいる。

機械が利用する情報は、単に構造化されているだけでなく、その内容が正確であることが極めて重要である。ax-goのバージョン0.7.0では、エージェントが実行すべきではない「罠」となるコマンド（人間向けの対話型インターフェースを起動するものや、無限に処理をブロックするものなど）を__schemaの出力から除外する機能が追加された。具体的には、開発者が特定のコマンドを「エージェント向けのツールではない」と明示的にマークするためのmcp.Exclude機能も提供された。これにより、エージェントが事前に読み取るツールのリストは、実際に安全に実行できるコマンドのみを含むようになり、エージェントが誤ったコマンドを実行してシステムを停止させるリスクが大幅に減少した。構造化された情報は、それが事実と正確に一致している場合にのみ真に役立つ、という原則がここにはある。

プラットフォーム自体がエージェントを「第一級の読み手」として認識し、構造化された情報提供を進めることは、開発ツールやシステムの安定性を大幅に向上させる。これまでの方法、つまりウェブサイトのHTMLをスクレイピングしたり、コマンドの--helpテキストを解析したりする方法は、常に「不安定さ」というコストを伴っていた。ウェブサイトのマークアップやテキストの書式が少し変わるだけで、プログラムが動作しなくなるリスクがあったのだ。構造化されたAPIの導入は、Goエコシステム全体がこの不安定さという負債を返済している動きである。Goは、パッケージレジストリのレベルでも、ツールチェインのデフォルト設定のレベルでも、次に来る主要な情報利用者が「機械」であると判断し、それに応じた変化を進めている。これにより、開発者はより安定した基盤の上で、機械と協調するツールやアプリケーションを構築できるようになるだろう。