작성자: @41five
Box Mount가 프라이빗 프리뷰로 공개되었습니다.
샌드박스 안에서 실행되는 AI 에이전트를 구축할 때, 모델이 유용한 작업을 수행하도록 만드는 것은 전체 작업의 일부에 불과합니다. 에이전트는 여전히 작업할 문서, 해당 문서를 처리할 도구, 그리고 생성한 파일을 저장할 공간이 필요합니다.
처음에는 이러한 문서를 이동시키는 작업이 몇 번의 API 호출로 끝날 것처럼 보입니다. 입력값을 다운로드하고, 에이전트를 실행한 뒤, 결과물을 업로드하면 되니까요. 하지만 워크플로우 중간에 파일이 변경되거나, 사람이 결과물을 검토해야 하거나, 여러 에이전트가 동일한 콘텐츠를 공유해야 하는 상황이 되면 이 계층은 훨씬 복잡해집니다. 이제 동기화, 버전 관리, 충돌 해결, 재시도까지 처리해야 합니다.
Box Mount는 바로 워크플로우의 이런 부분을 위해 만들어졌습니다. 에이전트 샌드박스에 POSIX 호환 Box 워크스페이스를 제공하여, 샌드박스 내부의 코드와 도구가 익숙한 파일 경로를 통해 Box 콘텐츠와 연동될 수 있게 해줍니다. Box Mount는 양방향 데이터 이동을 모두 처리하며, Box는 거버넌스가 적용된 기록 시스템(system of record)으로 남습니다.
Box Mount가 적합한 경우
Box Mount는 모든 Box API나 MCP 호출을 대체하기 위한 것이 아닙니다. 에이전트가 단순히 문서를 가져와 프롬프트에 추가하기만 하면 된다면, 기존 인터페이스로도 충분히 필요한 모든 것을 얻을 수 있습니다.
차이점은 문서가 단순한 컨텍스트인지, 아니면 에이전트 작업 환경의 일부인지에 있습니다.
계약서 폴더를 검토하고, 문서 처리 도구를 실행하고, 검토 메모를 작성한 다음 변호사가 수정할 때까지 대기하는 에이전트를 상상해 보세요. 또는 승인된 답변 라이브러리에서 내용을 가져와 초안을 작성하고, 법무 및 보안 검토를 위해 다시 전송하는 RFP 워크플로우를 떠올려 보세요.
이러한 경우 에이전트는 콘텐츠를 한 번 가져오는 데 그치지 않습니다. 외부 런타임 내에서 파일 모음을 직접 다루며 작업하게 됩니다.
바로 이것이 Box Mount가 목표로 하는 패턴입니다. 개발자가 에이전트 샌드박스를 프로비저닝하고, Box 콘텐츠를 해당 환경으로 가져온 뒤, 에이전트의 작업 결과를 다시 Box로 반환하는 구조입니다.
Box Mount 작동 방식 살펴보기
이 짧은 데모에서는 계약 검토 앱이 Box Mount를 사용해 Box 콘텐츠를 E2B 샌드박스로 가져오고, 해당 워크스페이스에서 에이전트를 실행한 뒤, 완료된 검토 내용을 다시 Box로 동기화하여 사람이 검토할 수 있도록 하는 과정을 보여줍니다.
이 영상은 Box Mount를 활용한 멀티 에이전트 딜룸(diligence room) 검토를 보여줍니다. 엔터프라이즈 콘텐츠를 OpenAI Agents API 샌드박스로 가져와, 리드 에이전트 1개와 전문 에이전트 3개가 5개의 소스 파일을 대상으로 병렬 작업을 수행하고, 기본 MSA가 수정되면 4개의 보고서를 자동으로 Box에 동기화합니다.
이 데모는 Box Mount를 사용한 보안 설문지 검토를 보여줍니다. 승인된 정책 문서를 Vercel Sandbox 마이크로 VM으로 가져와, 에이전트가 12개 항목을 검토하여 10개 통과 답변에 대한 근거를 제시하고 2개 항목은 사람 검토 대상으로 표시한 뒤, 완성된 Excel 통합 문서를 자동으로 Box에 동기화합니다.
이 데모는 Box Mount를 활용한 딜룸 실사 메모 작성을 보여줍니다. DigitalOcean 샌드박스 에이전트에게 Box 클라우드 콘텐츠에 접근할 수 있는 일반 파일 경로를 제공하고, 딜룸 문서를 로컬에서 읽은 뒤, 별도의 다운로드나 업로드 로직을 구축하지 않고도 완성된 메모를 Box에 다시 기록합니다.
샌드박스 안의 익숙한 워크스페이스
Box 폴더가 마운트되면, 에이전트는 이를 일반적인 디렉터리로 인식합니다.
1/mnt/box2├── Incoming/3│ └── Acme-MSA.docx4├── Playbook/5│ └── approved-contract-playbook.md6└── Reviewed/
이제부터는 기존 라이브러리와 명령줄 도구를 활용해 콘텐츠를 다룰 수 있으며, 모든 작업마다 Box 전용 도구가 필요하지 않습니다. 예를 들어 Node 애플리케이션은 로컬 파일에 사용하는 것과 동일한 파일 시스템 API를 사용할 수 있습니다.
1import { readFile, writeFile } from "node:fs/promises";23const playbook = await readFile(4 "/mnt/box/Playbook/approved-contract-playbook.md",5 "utf8",6);78const review = await reviewContract({9 contractPath: "/mnt/box/Incoming/Acme-MSA.docx",10 playbook,11});1213await writeFile(14 "/mnt/box/Reviewed/Acme-MSA-review.md",15 review,16);
애플리케이션 관점에서 마지막 쓰기 작업은 그저 일반적인 파일 작업일 뿐입니다. Box Mount는 새로운 검토 내용을 Box로 동기화하며, 사용자는 Box에서 해당 파일을 열거나 편집하고, 작업을 할당하거나 새 버전을 만들 수 있습니다.
샌드박스가 실행 중인 상태에서 누군가 Box의 파일을 업데이트하면, 해당 변경 사항이 마운트된 워크스페이스로 다시 전달되어 에이전트의 다음 단계에 반영될 수 있습니다. 이는 개발자가 모든 파일에 대해 커스텀 이동 및 동기화 로직을 구축할 필요 없이, 에이전트와 사람을 위한 공유 작업 환경을 만들어 줍니다.
또한 워크플로우가 특정 모델이나 에이전트 프레임워크에 종속되는 정도를 줄여줍니다. 샌드박스에서는 OpenAI 에이전트, Anthropic 에이전트, LangGraph, CrewAI, Python 스크립트, LibreOffice CLI 또는 여러 도구의 조합을 실행할 수 있습니다. 해당 도구가 파일을 다루는 방법만 알고 있다면, 마운트된 워크스페이스에서도 문제없이 작동합니다.
구성 요소들의 연결 방식
제품이나 오케스트레이터는 샌드박스 프로비저닝과 에이전트 실행을 담당합니다. Box Mount는 해당 샌드박스 내에서 헤드리스(headless) 동기화 컴포넌트로 실행되며, 파일 시스템 인터페이스를 제공하고 Box API를 통해 Box와 통신합니다.
에이전트는 모든 문서 작업마다 Box를 호출하는 대신 마운트된 경로를 통해 작업합니다. Box Mount는 폴더를 최신 상태로 유지하고, 변경 사항을 업로드하며, 충돌하는 업데이트를 감지하고, 워크스페이스가 마운트 해제될 때 최종 동기화를 완료합니다.
Box는 권한, 버전, 분류, 보존 기간, Shield 보호 기능, 감사 내역을 포함한 콘텐츠 레이어를 계속 제공합니다. 샌드박스에는 동기화된 작업 사본이 포함되므로, 개발자는 여전히 자체 보안 요구 사항에 따라 해당 환경과 로컬 데이터를 관리해야 합니다.
고객의 제품이 샌드박스를 프로비저닝하고 에이전트를 실행합니다. Box Mount는 Box API를 통해 에이전트의 파일 시스템 워크스페이스를 Box에 연결합니다.
Box Mount 사용하기
기본적인 Box Mount 워크플로우는 단 몇 개의 명령어로 이루어집니다. 먼저 Box 자격 증명을 구성합니다.
1box-mount config
Box 폴더를 에이전트의 샌드박스에 마운트합니다.
1mkdir -p /mnt/box2box-mount mount "/mnt/box" "<box-folder-id>"
마운트가 완료되면 에이전트는 일반적인 파일 시스템 도구를 사용할 수 있습니다.
1find /mnt/box -type f2cat /mnt/box/Playbook/approved-contract-playbook.md3cp generated-review.md /mnt/box/Reviewed/
에이전트가 실행되는 동안 활성 마운트 상태를 확인할 수 있습니다.
1box-mount status
실행이 끝나면 워크스페이스를 마운트 해제하고 최종 동기화를 완료합니다.
1box-mount unmount "/mnt/box"
인증 및 프로비저닝 방식은 애플리케이션이 샌드박스를 시작하는 방법에 따라 달라집니다. 바이너리에 포함된 프라이빗 프리뷰 문서에서 사용 가능한 구성 옵션을 확인할 수 있습니다.
무엇을 구축할 수 있을까요?
계약 검토가 하나의 예입니다. 에이전트는 수신된 계약서를 승인된 플레이북과 비교하고, 결과를 Box에 기록한 뒤 변호사에게 전달할 수 있습니다. 변호사가 Box에서 검토 내용을 수정하면, 에이전트는 자신의 작업 환경에서 업데이트된 파일을 즉시 확인할 수 있습니다.
동일한 패턴으로 제안서 및 RFP 초안 작성, 딜룸 분석, 경영진 브리핑 생성, 연구 자료 종합, 규정 준수 검토 등 문서 중심의 다양한 워크플로우를 지원할 수 있습니다. 여러 에이전트가 공유 Box 폴더를 통해 협업할 수도 있습니다. 예를 들어 한 에이전트가 초안을 작성하고, 다른 에이전트가 검토하며, 사람이 최종 결정을 내리는 식입니다.
모델과 워크플로우는 바뀔 수 있지만, 근본적인 패턴은 동일합니다. Box 콘텐츠가 외부 샌드박스로 들어가 에이전트 작업 환경의 일부가 되고, 그 결과물이 다시 Box로 돌아옵니다.
예제 앱 살펴보기
Box Mount 계약 검토 예제는 E2B를 사용한 전체 워크플로우를 보여줍니다.
이 앱은 샌드박스를 생성하고, Box Mount를 설치하고, Box 계약 워크스페이스를 마운트한 뒤, Box AI 또는 OpenAI 에이전트를 실행합니다. 그런 다음 생성된 검토 내용을 Box로 다시 동기화하고, 선택적으로 사람 검토자에게 할당한 뒤, 개발자가 결과를 확인하고 종료할 수 있도록 샌드박스를 계속 실행 상태로 둡니다.
현재 이 리포지토리는 비공개이며 Box Mount 바이너리를 포함하고 있지 않습니다. 프라이빗 프리뷰 참가자는 리포지토리 접근 권한이 필요하며, 예제를 실행하기 전에 제공받은 바이너리를 프로젝트의 private/ 디렉터리에 배치해야 합니다.
프라이빗 프리뷰 참여하기
Box Mount는 아직 초기 단계이며, 샌드박스에서 실행되고 Box 콘텐츠를 다루는 에이전트 워크플로우를 구축 중이거나 탐색을 시작한 개발자를 찾고 있습니다.
이것이 여러분의 아키텍처와 비슷하다면, 현재 콘텐츠를 어떻게 이동시키고 있는지, 샌드박스 내에서 무엇을 실행하는지, 그리고 기존 방식의 어떤 부분에서 어려움을 겪고 있는지 듣고 싶습니다. 프라이빗 프리뷰 참가자에게는 Box Mount 바이너리와 설정 가이드가 제공되어, 자신의 워크플로우에 직접 적용해 볼 수 있습니다.
https://bit.ly/box-mount-preview
Box 콘텐츠를 에이전트 작업 환경의 일부로 활용해야 한다면, 여러분이 무엇을 구축하실지 기대하겠습니다.
