사전 요구 사항
- CoreWeave Forge 계정 및
WANDB_API_KEY환경 변수로 설정한 API 키 ANTHROPIC_API_KEY환경 변수로 설정한 Anthropic API 키- Python: Python 3.10 이상 및
anthropic0.18.0 이상 - TypeScript: Node.js 18.19 이상(또는 20.6 이상) 및
@anthropic-ai/sdk0.52.0 이상
패키지 설치
Anthropic 대화 트레이싱
Forge 팀 이름과 프로젝트 이름을 지정해tracing.init()을 호출하세요. Python에서는 Anthropic SDK를 호출 전에 임포트하든 후에 임포트하든 tracing.init()이 SDK를 패치합니다. TypeScript에서는 TypeScript 탭에 나와 있는 계측 플래그를 사용해 Node를 시작하세요.
Agent Lens에는 대화 안에서 실행된 Call만 표시됩니다. 대화 밖에서 실행된 Call에는 대화 ID가 없으므로 Agent Lens에 나타나지 않습니다. 에이전트 세션마다 대화를 하나씩 생성하고, 사용자 메시지마다 턴을 시작하세요. 모든 턴이 대화 ID를 공유하므로 Agent Lens는 이 턴들을 하나의 대화로 묶어 표시하며, 각 Call은 자신이 실행된 턴의 LLM span이 됩니다.
- Python
- TypeScript
conversation_id(Python) 또는 conversationId(TypeScript)를 전달하세요.
대화, 턴 및 기타 span 유형에 대한 자세한 내용은 에이전트 트레이싱을 참조하세요.
자동 패치 끄기
Python에서는tracing.init()에 autopatch_integrations=False를 전달하세요. 그러면 tracing.integrations.patch_anthropic() 및 tracing.integrations.unpatch_anthropic()으로 Anthropic SDK를 직접 패치하거나 패치를 해제할 수 있습니다.
TypeScript에서는 --import=@coreweave/forge-sdk/instrument 플래그 없이 실행한 다음, 트레이스하려는 클라이언트만 integrations.wrapAnthropic()으로 래핑하세요.