Python SDK - CoreWeave Docs

CoreWeave Forge Python SDK(coreweave)는 에이전트 대화, 턴, LLM Call, 도구 Call, 하위 에이전트를 OpenTelemetry span으로 기록하여 Agent Lens로 내보냅니다. 이 레퍼런스는 SDK 버전 0.1.0b0을 기준으로 합니다.

설치

SDK를 사용하려면 Python 3.10 이상이 필요합니다.

pip install coreweave

공급자 SDK를 자동으로 트레이스하려면 해당 extra를 설치하세요:

pip install "coreweave[openai]"
pip install "coreweave[anthropic]"
pip install "coreweave[google-genai]"

임포트 및 초기화

트레이싱 모듈을 임포트한 다음, 프로젝트를 entity/project 형식으로 지정해 init을 호출하세요. api_key를 전달하지 않으면 init은 WANDB_API_KEY 환경 변수에서 API 키를 읽어옵니다.

from coreweave.forge.agentlens import tracing

tracing.init("[ENTITY]/[PROJECT]")

레퍼런스 페이지

설정

페이지	다루는 내용
설정 및 종료	`init`, `force_flush`, `shutdown`, `TracingSession`

Span

페이지	다루는 내용
Conversation	`Conversation`
Turn	`Turn`
LLM	`LLM`
Tool	`Tool`
SubAgent	`SubAgent`
Span 함수	`start_conversation`, `start_turn`, `start_llm`, `start_tool`, `start_subagent`, `end_conversation`, `end_turn`, `end_llm`, `get_current_conversation`, `get_current_turn`, `get_current_llm`

배치 로깅

페이지	다루는 내용
배치 로깅	`log_turn`, `log_conversation`, `LogResult`

메시지

페이지	다루는 내용
메시지 유형	`Message`, `MessagePart`, `TextPart`, `ReasoningPart`, `ToolCallPart`, `ToolCallResponsePart`, `BlobPart`, `UriPart`, `FilePart`, `Usage`, `Reasoning`, `MediaAttachment`

공급자 인테그레이션

페이지	내용
인테그레이션	`autopatch`, `disable_autopatch`, `patch_openai`, `unpatch_openai`, `patch_anthropic`, `unpatch_anthropic`, `patch_google_genai`, `unpatch_google_genai`, `unpatch_all`

​설치

​임포트 및 초기화

​레퍼런스 페이지

​설정

​Span

​배치 로깅

​메시지

​공급자 인테그레이션

설치

임포트 및 초기화

레퍼런스 페이지

설정

Span

배치 로깅

메시지

공급자 인테그레이션