Files SDK - 모든 blob 스토리지를 위한 단일 API

29종의 blob 스토리지를 통합 관리하며 AI 에이전트용 파일 도구 기능을 제공하는 SDK입니다.

S3, R2, GCS, Azure 등 29종의 객체/blob 스토리지를 하나의 통합 인터페이스로 처리할 수 있는 SDK입니다. 40개 이상의 어댑터를 지원하여 어댑터 교체만으로 모든 호출 코드를 유지하며 스토리지 환경을 전환할 수 있습니다.

특히 AI 에이전트용 파일 도구로서 Vercel AI SDK, OpenAI Agents, Claude, MCP(Model Context Protocol) 등에 파일 처리 기능을 제공하는 데 특화되어 있습니다.

주요 특징은 다음과 같습니다:

통합 인터페이스: upload, download, copy, move, list, delete 등 주요 작업을 모든 어댑터에서 동일한 방식으로 호출하며, 필요 시 네이티브 클라이언트를 사용할 수 있는 escape hatch를 제공합니다.
고성능 처리: 배열 기반의 제한된 동시성 배치 처리와 병렬 multipart 업로드를 지원합니다.
실시간 모니터링 및 제어: 콜백을 통한 실시간 업로드 진행률 표시와 HTTP 206 매핑을 통한 ranged read(비디오 시크, 다운로드 재개 등)가 가능합니다.
데이터 동기화: sync() 메서드로 한 백엔드에서 다른 백엔드로 데이터를 미러링할 수 있으며, 변경 사항만 반영하는 기능을 지원합니다.
라이프사이클 관리: onAction, onRetry, onError 훅을 통해 모든 작업의 생명주기를 통합 관리할 수 있습니다.