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

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

​

작동 방식

1. 버킷에 미디어 객체를 저장합니다(예: s3://[YOUR-BUCKET]/frames/000123.png).
2. 해당 URI를 도구 결과 등의 span에 문자열 값으로 로깅합니다.
3. 대화를 열면 Agent Lens가 URI를 유효 기간이 짧은 사전 서명된 URL로 변환한 뒤 인라인으로 렌더링합니다. 렌더링 방식은 파일 확장자에 따라 결정됩니다. 일반적인 이미지 형식(예: .png, .jpg, .gif)과 비디오 형식(예: .mp4, .mov, .webm)은 인라인으로 렌더링되며, 그 외 형식은 다운로드 링크로 표시됩니다.

​

사전 요구 사항

• CoreWeave Forge 계정 및 API 키
• 직접 관리하는 클라우드 저장소 버킷(S3 또는 GCS). 버킷에는 객체가 하나 이상 있어야 합니다.
• 조직 관리자 권한. 레퍼런스 버킷을 추가하려면 조직에서 팀을 생성할 때와 동일한 권한이 필요합니다.

​

버킷 설정하기

​

레퍼런스 버킷 등록

1. CoreWeave Forge의 제품 메뉴에서 Weights & Biases를 선택하세요.
2. 사이드 메뉴의 Teams에서 팀을 선택한 다음 Settings 탭을 선택하세요. 팀 설정 페이지 주소는 https://forge.coreweave.com/wandb/[YOUR-TEAM]/settings입니다.
3. Reference buckets 섹션에서 Add bucket을 선택하세요.
4. 클라우드 제공업체(AWS 또는 Google Cloud)를 선택하세요.
5. 버킷 이름에는 s3:// 또는 gs:// 접두사를 빼고 [YOUR-BUCKET]만 입력하세요.
6. 객체 키에는 버킷에 있는 기존 객체의 키(예: photos/cat.png)를 입력하세요. 전체 URL이 아니라 객체 키만 입력해야 합니다. Forge는 이 객체 하나를 조회하여 읽기 액세스 권한이 있는지, CORS가 올바르게 설정되었는지 확인합니다. 버킷 확인이 완료되면 버킷 내 모든 객체를 사전 서명할 수 있습니다.
7. 필요한 경우 Test connection을 선택하면 저장하지 않고 설정을 검증할 수 있습니다.
8. Add bucket을 선택하여 저장하세요.

​

에이전트 span을 사용해 미디어 참조 로깅하기

from coreweave.forge.agentlens import tracing

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

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

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

tracing.shutdown()

import { tracing } from '@coreweave/forge-sdk/agentlens';

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

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

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

await tracing.shutdown();

​

Agent Lens에서 레퍼런스 보기