인증
- 경로:
/agents/otel/v1/traces - 방법:
POST - 콘텐츠 유형:
application/x-protobuf - 기본 URL: Multi-tenant Cloud의 경우
https://trace.wandb.ai
opentelemetry-exporter-otlp-proto-http (Python) 또는 @opentelemetry/exporter-trace-otlp-proto (TypeScript)와 같은 protobuf HTTP 익스포터를 사용하세요. 이 엔드포인트는 gzip 및 deflate 콘텐츠 인코딩도 허용합니다.
엔드포인트에 인증하려면 다음 값 중 하나를 사용해 OTLPSpanExporter 설정에 W&B API 키를 설정하세요:
wandb-api-key: 값으로 W&B API 키를 지정합니다.Authorization: 사용자 이름으로api를, 비밀번호로 W&B API 키를 사용하는 HTTP Basic 인증입니다. 이 형식은 익스포터 또는 collector가 표준 authorization 헤더만 지원하는 경우에 유용합니다.
프로젝트 라우팅
- 리소스 속성(권장):
TracerProvider리소스에서wandb.entity는 담당 W&B 팀 또는 사용자 이름으로,wandb.project는 프로젝트 이름으로 설정하세요. project_id헤더: 값을[YOUR-TEAM]/[YOUR-PROJECT]로 설정하세요.
Agents 뷰용 span 구성하기
gen_ai.operation.name을 설정하여 Weave에 해당 span이 무엇을 나타내는지 알려 주세요.
그룹화는 다음 두 속성으로 제어됩니다.
gen_ai.conversation.id: 여러 턴을 하나의 대화로 그룹화합니다. 대화가 유지되는 동안에는 안정적인 ID를 사용하세요.gen_ai.agent.name: Agents 탭에서 대화를 이름 있는 에이전트 아래로 그룹화합니다.
gen_ai.request.model, gen_ai.usage.input_tokens, gen_ai.usage.output_tokens와 같은 다른 GenAI semantic-convention 속성은 모델 이름과 token 수를 표시해 렌더링 정보를 더 풍부하게 해 주지만, 선택 사항입니다. 이러한 span이 매핑되는 에이전트 데이터 모델은 Trace your agents에서 확인하세요.
환경 변수만 사용해 구성하기
예시: Weave SDK 없이 에이전트 spans 내보내기
invoke_agent span, LLM Call용 chat span, 도구 Call용 execute_tool span을 내보낸 다음, 이를 Weave Agents 엔드포인트로 익스포트합니다.
먼저, 필요한 의존성을 설치하세요:
WANDB_API_KEY, ENTITY, PROJECT 값을 설정한 후 실행하세요:
gen_ai.conversation.id를 사용해 invoke_agent span을 더 emit하세요. 각 턴은 자체 트레이스의 루트 span이므로 턴끼리 부모 span을 공유할 필요가 없습니다.
애플리케이션이 span을 내보낸 후 Weave 프로젝트의 Agents 탭을 여세요.