> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Google Antigravity プラグイン
> Google Antigravity のエージェントのターンを Agent Lens でトラッキングし、可観測性の向上とデバッグに役立てます。
[Google Antigravity 向け CoreWeave Forge プラグイン](https://github.com/coreweave/forge-agent-lens-for-google-antigravity)は、エージェントのターン、モデルの Call、ツール呼び出し、サブエージェントをトレースします。ターンが終了すると、プラグインの [Stop フック](https://antigravity.google/docs/hooks)が会話のトランスクリプトを読み取り、そのターンを 1 つのトレースとして Agent Lens に送信します。同じ Antigravity の会話に属するターンは会話 ID を共有するため、Agent Lens では 1 つの会話としてまとめて表示されます。
このガイドでは、プラグインのインストールと設定、生成されたトレースの確認、よくある問題のトラブルシューティングについて説明します。
このプラグインは Antigravity のセッションデータを Agent Lens に送信します。このデータには、プロンプト、モデルの応答と推論、ツールの引数と結果 (ツールが出力した内容をすべて含む) が含まれる可能性があります。
PII のスクラブや機密データのマスキングは実装されていません。プラグインは、取得したコンテンツからシークレットや個人データを削除しません。プロンプト、応答、推論、ツールの引数と結果を除外するには、`FORGE_ANTIGRAVITY_INCLUDE_CONTENT=false` を設定してください。ただし、その場合もスパンには名前、タイミング、ワークスペースのパスが含まれます。詳しくは、[コンテンツの取得](#content-capture)を参照してください。セキュリティやコンプライアンスの要件上、このデータを Agent Lens に送信できない場合は、このプラグインをインストールしないでください。
前提条件
プラグインをインストールする前に、以下を用意してください。
* [Antigravity CLI](https://github.com/google-antigravity/antigravity-cli) (`agy`) `1.1.10` 以降
* [uv](https://docs.astral.sh/uv/getting-started/installation/) (フックは uv の `uvx` コマンドで実行されます)
* Python 3.10 以降
* CoreWeave Forge アカウントと [APIキー](https://forge.coreweave.com/settings#apikeys)
* トレースの送信先となる Agent Lens の project (`[YOUR-TEAM]/[YOUR-PROJECT]`)
プラグインをインストールする
以下の手順に従ってプラグインをインストールし、最初のトレースを Agent Lens に送信します。
`[YOUR-TEAM]/[YOUR-PROJECT]` を Agent Lens の project に、`[YOUR-API-KEY]` をご自身の APIキーに置き換えてから、エクスポートします。
```bash lines theme={"system"}
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 ホストのエントリからキーを読み取ることもできます。
```bash lines theme={"system"}
uvx forge-agent-lens-for-google-antigravity@latest install
```
インストーラーは `agy plugin install` でプラグインを登録し、フックに必要な設定を確認したうえで、トレースの表示先を出力します。
```text theme={"system"}
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` と表示された場合は、[トラブルシューティング](#troubleshooting)を参照してください。
新しい `agy` セッションを開始します。完了したターンはそれぞれ Agent Lens に表示されます。
Agent Lens で Antigravity のトレースを表示する
インストーラーは、project のトレースへのリンクを出力します。Agent Lens UI から project を開くこともできます。
1. [CoreWeave Forge](https://forge.coreweave.com) にアクセスし、プロダクトメニューから Agent Lens を選択します。次に、サイドメニュー上部の project セレクターで対象の project を選択します。
2. サイドメニューで **Conversations** を選択します。
3. **Conversations** タブを選択すると、project に保存済みのすべてのエージェントの会話が表示されます。
4. 会話を選択すると、会話ツリー全体を確認できます。
Conversations タブの詳細については、[エージェントのアクティビティを表示する](/ja/products/agent-lens/conversations/view-activity)を参照してください。
プラグインは、セッションの最初のワークスペースフォルダーの名前を各会話の名前として使用します。セッションにワークスペースフォルダーがない場合、会話名は `Antigravity` になります。
トレースされる内容
ターンごとに 1 つのトレースが作成されます。
```text theme={"system"}
invoke_agent Antigravity ターン（リクエストからエージェントが停止するまで）
├─ chat モデルの各応答
├─ execute_tool 各ツール呼び出しとその結果
└─ invoke_agent invoke_subagent で開始された各サブエージェント
```
スパンは [OpenTelemetry (OTel) GenAI セマンティック規約](https://opentelemetry.io/docs/specs/semconv/gen-ai/) (`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 ログに書き込まれます。
```bash lines theme={"system"}
grep -h "forge-agent-lens-for-google-antigravity:" ~/.gemini/antigravity-cli/log/cli-*.log | tail
```
次に、確認した内容を以下の表と照らし合わせてください。
| 症状 | 確認事項 |
| - | - |
| `install` で `✗ Hook command` と表示される | [uv](https://docs.astral.sh/uv/getting-started/installation/) をインストールし、`uvx` が `PATH` から実行できるようにしてください。 |
| ログに `FORGE_TRACE_PROJECT is not set` と表示される | `agy` を起動する環境でこの変数を設定してから、新しいセッションを開始してください。 |
| ログに `trace export failed` と表示される | エラーの詳細はその行の続きに記載されています。APIキーが有効であること、および対象の project へのアクセス権があることを確認してください。 |
| プラグインのログが出力されない | `agy plugin list` を実行してプラグインがインストールされていることを確認し、`agy` の起動時の `PATH` に `uvx` が含まれていることを確認してください。 |
プラグインを管理する
アップグレードするには、インストールコマンドを再実行します。インストール済みのプラグインは置き換えられます。バージョンを固定する場合や別のバージョンに切り替える場合は、そのバージョンを指定してインストールします。
```bash lines theme={"system"}
uvx forge-agent-lens-for-google-antigravity@[VERSION] install
```
プラグインの無効化、再有効化、削除には [`agy plugin`](https://antigravity.google/docs/plugins?tab=cli) を使用します。
```bash lines theme={"system"}
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` を設定した場合、アップグレード後はその実行ファイルが使用されなくなります。次のコマンドで削除してください。
```bash lines theme={"system"}
uv tool uninstall forge-agent-lens-for-google-antigravity
```