> ## 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 플러그인 > Agent Lens에서 Google Antigravity 에이전트 턴을 추적하여 관측성을 확보하고 디버깅합니다. [Google Antigravity용 CoreWeave Forge 플러그인](https://github.com/coreweave/forge-agent-lens-for-google-antigravity)은 에이전트 턴, 모델 호출, 도구 Call, 서브에이전트를 트레이싱합니다. 턴이 종료되면 플러그인의 [Stop 훅](https://antigravity.google/docs/hooks)이 대화 전사본을 읽고 해당 턴을 하나의 트레이스로 Agent Lens에 전송합니다. 같은 Antigravity 대화에 속한 턴은 대화 ID를 공유하므로 Agent Lens에서 하나의 대화로 표시됩니다. 이 가이드에서는 플러그인을 설치하고 설정하는 방법, 생성된 트레이스를 확인하는 방법, 일반적인 문제를 해결하는 방법을 안내합니다. 이 플러그인은 Antigravity 세션 데이터를 Agent Lens로 전송합니다. 이 데이터에는 프롬프트, 모델의 응답과 추론, 도구 인수와 결과(도구가 출력하는 모든 내용 포함)가 포함될 수 있습니다. PII 제거 및 민감한 데이터 마스킹 기능은 구현되어 있지 않습니다. 플러그인은 캡처된 콘텐츠에서 시크릿이나 개인정보를 제거하지 않습니다. 프롬프트, 응답, 추론, 도구 인수와 결과를 제외하려면 `FORGE_ANTIGRAVITY_INCLUDE_CONTENT=false`로 설정하세요. 이 경우에도 span에는 이름, 타이밍, 워크스페이스 경로가 포함됩니다. 자세한 내용은 [콘텐츠 캡처](#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/)(훅을 실행하는 `uvx` 명령어 제공) * Python 3.10 이상 * CoreWeave Forge 계정 및 [API 키](https://forge.coreweave.com/settings#apikeys) * 트레이스를 수신할 Agent Lens 프로젝트(`[YOUR-TEAM]/[YOUR-PROJECT]`)

플러그인 설치

다음 단계에 따라 플러그인을 설치하고 첫 번째 트레이스를 Agent Lens로 전송하세요. `[YOUR-TEAM]/[YOUR-PROJECT]`를 Agent Lens 프로젝트로, `[YOUR-API-KEY]`를 API 키로 바꾼 다음 export하세요. ```bash lines theme={"system"} export FORGE_TRACE_PROJECT="[YOUR-TEAM]/[YOUR-PROJECT]" export WANDB_API_KEY="[YOUR-API-KEY]" ``` 훅은 `agy`를 시작한 환경에서 실행됩니다. 셸 프로필이나 `agy`를 시작하는 위치에서 `FORGE_TRACE_PROJECT`와 API 키를 설정하고, 해당 `PATH`에 `uvx`가 포함되어 있는지 확인하세요. 훅은 `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 트레이스 보기

설치 프로그램이 프로젝트 트레이스로 연결되는 링크를 출력합니다. Agent Lens UI에서 프로젝트를 직접 열 수도 있습니다. 1. [CoreWeave Forge](https://forge.coreweave.com)로 이동하여 제품 메뉴에서 Agent Lens를 선택한 다음, 사이드 메뉴 상단의 프로젝트 선택기에서 프로젝트를 선택하세요. 2. 사이드 메뉴에서 **Conversations**를 선택하세요. 3. **Conversations** 탭을 선택하면 프로젝트에 저장된 모든 에이전트 대화를 볼 수 있습니다. 4. 대화를 선택하면 전체 대화 트리를 살펴볼 수 있습니다. Conversations 탭에 대한 자세한 내용은 [에이전트 활동 보기](/ko/products/agent-lens/conversations/view-activity)를 참조하세요. 플러그인은 세션의 첫 번째 워크스페이스 폴더 이름을 각 대화의 이름으로 사용합니다. 세션에 워크스페이스 폴더가 없으면 대화 이름은 `Antigravity`가 됩니다.

트레이스 대상

각 턴은 하나의 트레이스로 기록됩니다. ```text theme={"system"} invoke_agent Antigravity 턴 전체 (요청부터 에이전트가 중지될 때까지) ├─ chat 각 모델 응답 ├─ execute_tool 각 도구 Call과 그 결과 └─ invoke_agent invoke_subagent로 시작된 각 서브에이전트 ``` span은 [OpenTelemetry (OTel) GenAI 시맨틱 규칙](https://opentelemetry.io/docs/specs/semconv/gen-ai/)(`gen_ai.*` 속성)을 따르며, span의 시간은 Antigravity 전사본에 기록된 각 단계의 타임스탬프를 기준으로 측정됩니다.

제한 사항

이 플러그인에는 다음과 같은 제한 사항이 있습니다. * Antigravity의 전사본에는 토큰 사용량, 모델 요청 설정, 응답 ID가 기록되지 않으므로 트레이스에 토큰 수나 비용이 표시되지 않습니다. * 서브에이전트의 `invoke_agent` span에는 프롬프트와 결과가 포함되지만 하위 span은 없습니다. 전사본에 서브에이전트 자체의 모델 호출과 도구 Call이 기록되지 않기 때문입니다.

구성 참조

`agy`를 시작하는 환경에 환경 변수를 지정하여 플러그인을 설정하세요. | 변수 | 기본값 | 설명 | | - | - | - | | `FORGE_TRACE_PROJECT` | 필수 | Agent Lens 프로젝트입니다. `[YOUR-TEAM]/[YOUR-PROJECT]` 형식으로 지정합니다. | | `WANDB_API_KEY` | `~/.netrc` 항목 | Forge API 키입니다. | | `FORGE_ANTIGRAVITY_INCLUDE_CONTENT` | `true` | 프롬프트, 응답, 추론, 도구 인수 및 결과를 제외하려면 `false`로 설정하세요. |

콘텐츠 캡처

`FORGE_ANTIGRAVITY_INCLUDE_CONTENT=false`로 설정해도 span에는 다음 정보가 계속 포함됩니다. * 모델, 도구, 서브에이전트의 이름 및 서브에이전트 역할 * 소요 시간 * 워크스페이스 경로 * Stop 훅의 실행 번호 및 종료 사유 또한 Forge SDK는 모든 span에 운영 체제 버전과 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`가 표시됨 | `uvx`가 `PATH`에 포함되도록 [uv](https://docs.astral.sh/uv/getting-started/installation/)를 설치하세요. | | 로그에 `FORGE_TRACE_PROJECT is not set`이 표시됨 | `agy`를 시작하는 환경에서 이 변수를 설정한 다음 새 세션을 시작하세요. | | 로그에 `trace export failed`가 표시됨 | 해당 줄의 나머지 부분에서 오류 내용을 확인할 수 있습니다. API 키가 유효한지, 해당 프로젝트에 대한 액세스 권한이 있는지 확인하세요. | | 플러그인의 로그가 출력되지 않음 | `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 ```