Open Agents - open-source reference app for building and running coding agents
(github.com/vercel-labs)Vercel Labs가 공개한 오픈소스 레퍼런스 앱으로, 백그라운드 코딩 에이전트를 직접 구축하고 실행할 수 있는 환경을 제공합니다. Web → Agent Workflow → Sandbox VM의 3계층 구조로 설계되어 있습니다. 포크해서 수정하는 것을 전제로 만들어진 레퍼런스 앱이며, 블랙박스로 사용하도록 설계되지 않았습니다.
핵심 특징
- 에이전트 ≠ 샌드박스: 에이전트는 VM 안에서 실행되지 않습니다. 외부에서 도구(파일 읽기, 편집, 셸 명령 등)를 통해 샌드박스와 상호작용합니다
- Sandbox Workflow: 샌드박스는 스냅샷 기반으로 생성·hibernate·resume이 가능하며, 에이전트 실행과 독립적인 라이프사이클을 가집니다
- Workflow SDK 기반 내구성 실행: 채팅 요청이 워크플로우 런을 시작하고, 에이전트 턴은 여러 퍼시스트 스텝에 걸쳐 지속됩니다. 스트림 재연결로 진행 중인 실행을 이어받을 수 있습니다
- GitHub 통합: 레포 클론, 브랜치 작업, 자동 커밋·푸시·PR 생성까지 지원
- Vercel 원클릭 배포: Next.js 앱으로 Vercel에 바로 배포 가능
장점
- 에이전트와 샌드박스가 분리되어 있어 모델 교체, 샌드박스 구현 변경, 에이전트 로직 수정을 각각 독립적으로 할 수 있습니다
- 스냅샷 기반 hibernate/resume으로 비활성 시 자원을 회수하면서도 상태를 보존합니다
- 프론트엔드(채팅 UI)와 에이전트 런타임이 같은 코드베이스에 있어 통합 비용이 낮습니다
단점
- Vercel Sandbox, Workflow SDK 등 Vercel 플랫폼 기능에 강하게 결합되어 있어 다른 인프라로의 이식이 어렵습니다
- 초기 설정에 환경 변수 10개 이상(PostgreSQL, Vercel OAuth, GitHub App, 암호화 키 등)이 필요합니다
- Labs 프로젝트로, API 안정성이나 장기 유지보수에 대한 공식 보장이 없습니다
차별점
대부분의 AI 코딩 에이전트는 에이전트와 실행 환경이 하나로 묶여 있습니다. Open Agents는 에이전트를 샌드박스 밖에 두고 도구 호출로만 연결하는 구조를 명시적 설계 원칙으로 채택했습니다. VM은 순수한 실행 환경으로 남고, 에이전트 로직은 Workflow SDK 위에서 내구성 있게 동작합니다. 또한 블랙박스 SaaS가 아닌 포크 가능한 레퍼런스 구현체로 제공된다는 점이 다릅니다.
시사점
- 에이전트-샌드박스 분리 패턴은 모델·실행환경·오케스트레이션을 독립적으로 교체할 수 있는 구조를 제공합니다
- Vercel은 Sandbox·Workflow SDK·AI SDK를 하나의 스택으로 묶어 에이전트 인프라 계층을 구성하고 있습니다
- 자체 코딩 에이전트를 설계하는 팀이라면, 이 3계층 분리 구조는 아키텍처 참고 자료로 활용할 수 있습니다