Skip to main content
Google Antigravity용 CoreWeave Forge 플러그인은 에이전트 턴, 모델 호출, 도구 Call, 서브에이전트를 트레이싱합니다. 턴이 종료되면 플러그인의 Stop 훅이 대화 전사본을 읽고 해당 턴을 하나의 트레이스로 Agent Lens에 전송합니다. 같은 Antigravity 대화에 속한 턴은 대화 ID를 공유하므로 Agent Lens에서 하나의 대화로 표시됩니다. 이 가이드에서는 플러그인을 설치하고 설정하는 방법, 생성된 트레이스를 확인하는 방법, 일반적인 문제를 해결하는 방법을 안내합니다.
이 플러그인은 Antigravity 세션 데이터를 Agent Lens로 전송합니다. 이 데이터에는 프롬프트, 모델의 응답과 추론, 도구 인수와 결과(도구가 출력하는 모든 내용 포함)가 포함될 수 있습니다.PII 제거 및 민감한 데이터 마스킹 기능은 구현되어 있지 않습니다. 플러그인은 캡처된 콘텐츠에서 시크릿이나 개인정보를 제거하지 않습니다. 프롬프트, 응답, 추론, 도구 인수와 결과를 제외하려면 FORGE_ANTIGRAVITY_INCLUDE_CONTENT=false로 설정하세요. 이 경우에도 span에는 이름, 타이밍, 워크스페이스 경로가 포함됩니다. 자세한 내용은 콘텐츠 캡처를 참조하세요. 보안 또는 규정 준수 요구 사항으로 인해 이 데이터를 Agent Lens로 전송할 수 없다면 이 플러그인을 설치하지 마세요.

​
사전 요구 사항

플러그인을 설치하기 전에 다음 항목을 준비하세요.
  • Antigravity CLI (agy) 1.1.10 이상
  • uv(훅을 실행하는 uvx 명령어 제공)
  • Python 3.10 이상
  • CoreWeave Forge 계정 및 API 키
  • 트레이스를 수신할 Agent Lens 프로젝트([YOUR-TEAM]/[YOUR-PROJECT])

​
플러그인 설치

다음 단계에 따라 플러그인을 설치하고 첫 번째 트레이스를 Agent Lens로 전송하세요.
1

프로젝트 및 API 키 설정

[YOUR-TEAM]/[YOUR-PROJECT]를 Agent Lens 프로젝트로, [YOUR-API-KEY]를 API 키로 바꾼 다음 export하세요.
훅은 agy를 시작한 환경에서 실행됩니다. 셸 프로필이나 agy를 시작하는 위치에서 FORGE_TRACE_PROJECT와 API 키를 설정하고, 해당 PATH에 uvx가 포함되어 있는지 확인하세요. 훅은 WANDB_API_KEY 대신 ~/.netrc의 Weights & Biases 호스트 항목에서 키를 읽을 수도 있습니다.
2

설치 프로그램 실행

설치 프로그램은 agy plugin install로 플러그인을 등록하고, 훅에 필요한 설정을 확인한 뒤 트레이스가 표시될 위치를 출력합니다.
설치 프로그램에 ✗ Hook command가 표시되면 문제 해결을 참조하세요.
3

새 세션 시작

새 agy 세션을 시작하세요. 완료된 턴은 모두 Agent Lens에 표시됩니다.

​
Agent Lens에서 Antigravity 트레이스 보기

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

​
트레이스 대상

각 턴은 하나의 트레이스로 기록됩니다.
span은 OpenTelemetry (OTel) GenAI 시맨틱 규칙(gen_ai.* 속성)을 따르며, span의 시간은 Antigravity 전사본에 기록된 각 단계의 타임스탬프를 기준으로 측정됩니다.

​
제한 사항

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

​
구성 참조

agy를 시작하는 환경에 환경 변수를 지정하여 플러그인을 설정하세요.

​
콘텐츠 캡처

FORGE_ANTIGRAVITY_INCLUDE_CONTENT=false로 설정해도 span에는 다음 정보가 계속 포함됩니다.
  • 모델, 도구, 서브에이전트의 이름 및 서브에이전트 역할
  • 소요 시간
  • 워크스페이스 경로
  • Stop 훅의 실행 번호 및 종료 사유
또한 Forge SDK는 모든 span에 운영 체제 버전과 Python 버전을 추가합니다.

​
문제 해결

트레이스가 Agent Lens에 전달되지 않으면 먼저 grep 명령어로 플러그인 메시지를 찾으세요. Antigravity는 훅 출력을 터미널 UI나 agy -p 출력에 표시하지 않습니다. 대신 트레이스를 확인할 수 있는 링크와 내보내기 오류 등 훅 메시지를 CLI 로그에 기록합니다:
그런 다음 확인한 내용을 다음 표와 비교해 보세요.

​
플러그인 관리

업그레이드하려면 설치 명령어를 다시 실행하세요. 기존에 설치된 플러그인이 새 플러그인으로 교체됩니다. 특정 버전으로 고정하거나 전환하려면 해당 버전을 지정해 설치하세요.
agy plugin으로 플러그인을 비활성화하거나 다시 활성화하거나 제거할 수 있습니다.
uv tool install로 버전 0.1.0 또는 0.1.1을 설정했다면, 업그레이드 후에는 해당 실행 파일이 더 이상 사용되지 않습니다. 다음 명령으로 제거하세요.
마지막 수정일 2026년 10월 15일