에이전트 span을 사용하여 자체 버킷(BYOB)의 미디어 참조하기

• 비디오 파이프라인에서 추출한 프레임
• 브라우저 에이전트가 캡처한 스크린샷
• 모델이 S3에 저장한 이미지

​

작동 방식

1. 미디어 객체를 버킷에 저장합니다. 예: s3://[YOUR-BUCKET]/frames/000123.png
2. 해당 URI를 트레이스 내 원하는 위치에 문자열 값으로 로깅합니다. Op의 입력이나 출력, 에이전트의 도구 결과 어디든 가능하며, 필드 이름은 상관없습니다.
3. 트레이스를 열면 Weave가 URI를 유효 기간이 짧은 사전 서명된 URL로 변환한 뒤 인라인으로 렌더링합니다. 렌더링 방식은 파일 확장자에 따라 달라집니다. 일반적인 이미지 형식(예: .png, .jpg, .gif)과 비디오 형식(예: .mp4, .mov, .webm)은 인라인으로 렌더링되고, 그 밖의 형식은 다운로드 링크로 표시됩니다.

​

사전 요구 사항

• 이 기능은 W&B Multi-tenant Cloud에서 지원되며, Dedicated Cloud 및 Self-Managed v0.84.0 이상에서는 프리뷰로 제공됩니다.
• CoreWeave Forge 계정과 API 키가 필요합니다.
• 직접 관리하는 클라우드 저장소 버킷(S3 또는 GCS)이 필요하며, 버킷에 객체가 하나 이상 있어야 합니다.
• 조직 관리자 권한이 필요합니다. 레퍼런스 버킷을 추가하려면 조직에서 팀을 생성하는 것과 동일한 권한이 있어야 합니다.

​

버킷 설정하기

​

레퍼런스 버킷 등록

1. 팀 설정 페이지(https://forge.coreweave.com/wandb/[YOUR-TEAM]/settings)로 이동하세요.
2. Reference buckets 섹션에서 Add bucket을 선택하세요.
3. 클라우드 제공업체(AWS 또는 Google Cloud)를 선택하세요.
4. 버킷 이름에는 s3:// 또는 gs:// 접두사 없이 [YOUR-BUCKET]만 입력하세요.
5. 객체 키에는 버킷에 있는 기존 객체의 키를 입력하세요(예: photos/cat.png). 전체 URL이 아닌 객체 키만 입력해야 합니다. W&B는 이 객체 하나를 조회하여 읽기 액세스 권한이 있는지, CORS가 올바르게 설정되었는지 확인합니다. 이 단계는 액세스 권한만 확인하며, 확인이 끝나면 버킷의 모든 객체에 대해 사전 서명을 사용할 수 있습니다.
6. 저장하지 않고 설정을 검증하려면 Test connection을 선택하세요(선택 사항).
7. Add bucket을 선택하여 저장하세요.

​

에이전트 span을 사용해 미디어 레퍼런스 로깅하기

import weave

weave.init("[YOUR-TEAM]/[YOUR-PROJECT]")

# 버킷에 이미 저장된 객체를 반환하는 도구입니다.
def get_frame(frame_id: int) -> str:
    return f"s3://[YOUR-BUCKET]/frames/{frame_id:06d}.png"

with weave.start_conversation(agent_name="frame-labeler") as conversation:
    with weave.start_turn(user_message="Show me frame 123", model="gpt-4o-mini"):
        with weave.start_tool(
            name="get_frame",
            arguments='{"frame_id": 123}',
            tool_call_id="call_1",
        ) as tool:
            # 결과는 버킷 URI 문자열이며, Agents 뷰에 인라인으로 렌더링됩니다.
            tool.result = get_frame(123)

import * as weave from 'weave';

await weave.init('[YOUR-TEAM]/[YOUR-PROJECT]');

// 버킷에 이미 저장된 객체를 반환하는 도구입니다.
function getFrame(frameId: number): string {
  return `s3://[YOUR-BUCKET]/frames/${String(frameId).padStart(6, '0')}.png`;
}

const conversation = weave.startConversation({agentName: 'frame-labeler'});
const turn = weave.startTurn({model: 'gpt-4o-mini'});
const tool = weave.startTool({
  name: 'getFrame',
  args: JSON.stringify({frameId: 123}),
  toolCallId: 'call_1',
});
// 결과는 버킷 URI 문자열이며, Agents 뷰에 인라인으로 렌더링됩니다.
tool.result = getFrame(123);
tool.end();
turn.end();
conversation.end();

​

Weave Agents에서 레퍼런스 확인하기