Google Antigravity プラグイン

Google Antigravity 向け CoreWeave Forge プラグインは、エージェントのターン、モデルの Call、ツール呼び出し、サブエージェントをトレースします。ターンが終了すると、プラグインの Stop フックが会話のトランスクリプトを読み取り、そのターンを 1 つのトレースとして Agent Lens に送信します。同じ Antigravity の会話に属するターンは会話 ID を共有するため、Agent Lens では 1 つの会話としてまとめて表示されます。このガイドでは、プラグインのインストールと設定、生成されたトレースの確認、よくある問題のトラブルシューティングについて説明します。

このプラグインは Antigravity のセッションデータを Agent Lens に送信します。このデータには、プロンプト、モデルの応答と推論、ツールの引数と結果 (ツールが出力した内容をすべて含む) が含まれる可能性があります。PII のスクラブや機密データのマスキングは実装されていません。プラグインは、取得したコンテンツからシークレットや個人データを削除しません。プロンプト、応答、推論、ツールの引数と結果を除外するには、FORGE_ANTIGRAVITY_INCLUDE_CONTENT=false を設定してください。ただし、その場合もスパンには名前、タイミング、ワークスペースのパスが含まれます。詳しくは、コンテンツの取得を参照してください。セキュリティやコンプライアンスの要件上、このデータを Agent Lens に送信できない場合は、このプラグインをインストールしないでください。

前提条件

プラグインをインストールする前に、以下を用意してください。

Antigravity CLI (agy) 1.1.10 以降
uv (フックは uv の uvx コマンドで実行されます)
Python 3.10 以降
CoreWeave Forge アカウントと APIキー
トレースの送信先となる Agent Lens の project ([YOUR-TEAM]/[YOUR-PROJECT])

プラグインをインストールする

以下の手順に従ってプラグインをインストールし、最初のトレースを Agent Lens に送信します。

project と APIキーを設定する

[YOUR-TEAM]/[YOUR-PROJECT] を Agent Lens の project に、[YOUR-API-KEY] をご自身の APIキーに置き換えてから、エクスポートします。

export FORGE_TRACE_PROJECT="[YOUR-TEAM]/[YOUR-PROJECT]"
export WANDB_API_KEY="[YOUR-API-KEY]"

フックは、agy を起動した環境で実行されます。FORGE_TRACE_PROJECT と APIキーはシェルのプロファイルなど、agy を起動する環境で設定し、uvx がその環境の PATH に含まれていることを確認してください。フックは WANDB_API_KEY の代わりに、~/.netrc 内の Weights & Biases ホストのエントリからキーを読み取ることもできます。

インストーラーを実行する

uvx forge-agent-lens-for-google-antigravity@latest install

インストーラーは agy plugin install でプラグインを登録し、フックに必要な設定を確認したうえで、トレースの表示先を出力します。

Installed the Antigravity plugin (forge-agent-lens-for-google-antigravity X.Y.Z).
✓ Hook command         uvx forge-agent-lens-for-google-antigravity@X.Y.Z
✓ FORGE_TRACE_PROJECT  my-team/antigravity-traces
✓ W&B API key          WANDB_API_KEY
View traces: https://forge.coreweave.com/agent-lens/my-team/antigravity-traces

インストーラーに ✗ Hook command と表示された場合は、トラブルシューティングを参照してください。

新しいセッションを開始する

新しい agy セッションを開始します。完了したターンはそれぞれ Agent Lens に表示されます。

Agent Lens で Antigravity のトレースを表示する

インストーラーは、project のトレースへのリンクを出力します。Agent Lens UI から project を開くこともできます。

CoreWeave Forge にアクセスし、プロダクトメニューから Agent Lens を選択します。次に、サイドメニュー上部の project セレクターで対象の project を選択します。
サイドメニューで Conversations を選択します。
Conversations タブを選択すると、project に保存済みのすべてのエージェントの会話が表示されます。
会話を選択すると、会話ツリー全体を確認できます。

Conversations タブの詳細については、エージェントのアクティビティを表示するを参照してください。プラグインは、セッションの最初のワークスペースフォルダーの名前を各会話の名前として使用します。セッションにワークスペースフォルダーがない場合、会話名は Antigravity になります。

トレースされる内容

ターンごとに 1 つのトレースが作成されます。

invoke_agent Antigravity     ターン（リクエストからエージェントが停止するまで）
├─ chat <model>              モデルの各応答
├─ execute_tool <tool>       各ツール呼び出しとその結果
└─ invoke_agent <subagent>   invoke_subagent で開始された各サブエージェント

スパンは OpenTelemetry (OTel) GenAI セマンティック規約 (gen_ai.* 属性) を使用し、各スパンの時間は Antigravity のトランスクリプトに記録された各ステップのタイムスタンプに基づいて算出されます。

制限事項

このプラグインには次の制限事項があります。

Antigravity のトランスクリプトにはトークン使用量、モデルのリクエスト設定、応答 ID が記録されないため、トレースにはトークン数やコストが含まれません。
サブエージェントの invoke_agent スパンにはプロンプトと結果が含まれますが、子スパンは含まれません。トランスクリプトには、サブエージェント自身によるモデルの Call やツール呼び出しが記録されないためです。

設定リファレンス

プラグインは環境変数で設定します。環境変数は、agy を起動する環境で設定してください。

変数	デフォルト	説明
`FORGE_TRACE_PROJECT`	必須	Agent Lens の project。`[YOUR-TEAM]/[YOUR-PROJECT]` の形式で指定します。
`WANDB_API_KEY`	`~/.netrc` のエントリ	Forge の APIキー。
`FORGE_ANTIGRAVITY_INCLUDE_CONTENT`	`true`	`false` に設定すると、プロンプト、応答、推論、およびツールの引数と結果が除外されます。

コンテンツの取得

FORGE_ANTIGRAVITY_INCLUDE_CONTENT=false を設定した場合でも、スパンには次の情報が含まれます。

モデル名、ツール名、サブエージェント名、およびサブエージェントのロール
タイミング
ワークスペースのパス
Stop フックの実行番号と終了理由

また、Forge SDK はすべてのスパンにオペレーティングシステムと Python のバージョンを追加します。

トラブルシューティング

トレースが Agent Lens に届かない場合は、まず grep コマンドでプラグインのメッセージを検索してください。Antigravity は、フックの出力をターミナル UI にも agy -p の出力にも表示しません。フックのメッセージは、トレースを表示できる場所へのリンクやエクスポートエラーも含めて、CLI ログに書き込まれます。

grep -h "forge-agent-lens-for-google-antigravity:" ~/.gemini/antigravity-cli/log/cli-*.log | tail

次に、確認した内容を以下の表と照らし合わせてください。

症状	確認事項
`install` で `✗ Hook command` と表示される	uv をインストールし、`uvx` が `PATH` から実行できるようにしてください。
ログに `FORGE_TRACE_PROJECT is not set` と表示される	`agy` を起動する環境でこの変数を設定してから、新しいセッションを開始してください。
ログに `trace export failed` と表示される	エラーの詳細はその行の続きに記載されています。APIキーが有効であること、および対象の project へのアクセス権があることを確認してください。
プラグインのログが出力されない	`agy plugin list` を実行してプラグインがインストールされていることを確認し、`agy` の起動時の `PATH` に `uvx` が含まれていることを確認してください。

プラグインを管理する

アップグレードするには、インストールコマンドを再実行します。インストール済みのプラグインは置き換えられます。バージョンを固定する場合や別のバージョンに切り替える場合は、そのバージョンを指定してインストールします。

uvx forge-agent-lens-for-google-antigravity@[VERSION] install

プラグインの無効化、再有効化、削除には agy plugin を使用します。

agy plugin disable forge-agent-lens-for-google-antigravity
agy plugin enable forge-agent-lens-for-google-antigravity
agy plugin uninstall forge-agent-lens-for-google-antigravity

uv tool install でバージョン 0.1.0 または 0.1.1 を設定した場合、アップグレード後はその実行ファイルが使用されなくなります。次のコマンドで削除してください。

uv tool uninstall forge-agent-lens-for-google-antigravity

​前提条件

​プラグインをインストールする

​Agent Lens で Antigravity のトレースを表示する

​トレースされる内容

​制限事項

​設定リファレンス

​コンテンツの取得

​トラブルシューティング

​プラグインを管理する