Vercel Open Agents
Vercel에서 만든 오픈소스 백그라운드 코딩 에이전트 참조 구현. Web → Agent Workflow → Sandbox VM 3계층 아키텍처
개요
Open Agents는 Vercel 인프라 위에서 동작하는 백그라운드 코딩 에이전트의 오픈소스 참조 앱이다. Web UI, 에이전트 런타임, 샌드박스 오케스트레이션, GitHub 연동까지 포함하며, 포크해서 커스터마이징하도록 설계되었다.
공식 설명 기준으로는 단순 데모보다는 “포크해서 자기 환경에 맞게 바꾸는 레퍼런스 앱” 성격이 강하다. 웹 UI, durable workflow, sandbox VM, GitHub 연동을 한 저장소 안에서 함께 보여주며, 노트북을 켜두지 않고도 프롬프트에서 코드 변경까지 이어지는 백그라운드 코딩 에이전트의 기본 골격을 제시한다.
핵심 아키텍처
Web (Next.js) → Agent Workflow (Vercel Workflow SDK) → Sandbox VM (Vercel Sandbox)
핵심 설계 결정: 에이전트는 샌드박스 밖에서 실행된다.
에이전트가 VM 내부가 아닌 외부에서 실행되며, 파일 읽기/편집/검색/셸 명령 등의 도구로 샌드박스와 상호작용한다. 이 분리가 핵심:
- 에이전트 실행이 단일 요청 라이프사이클에 종속되지 않음
- 샌드박스는 독립적으로 최대절전/재개 가능
- 모델/프로바이더 선택과 샌드박스 구현이 독립적으로 진화
- VM은 순수 실행 환경으로 유지
현재 기능
- 채팅 기반 코딩 에이전트 (file, search, shell, task, skill, web 도구)
- durable multi-step 실행 (Workflow SDK 기반, 스트리밍, 취소)
- 격리된 Vercel 샌드박스 (스냅샷 기반 재개)
- 리포지토리 클론 및 브랜치 작업
- 자동 커밋, 푸시, PR 생성 (선택적)
- 세션 공유 (읽기 전용 링크)
- ElevenLabs 음성 입력 (선택적)
- 샌드박스 포트 노출 (
3000,5173,4321,8000) 및 inactivity 후 hibernate/resume
기술 스택
| 구성요소 | 기술 |
|---|---|
| Web UI | Next.js |
| Agent Runtime | Vercel Workflow SDK |
| Sandbox | Vercel Sandbox (snapshot-based) |
| DB | PostgreSQL |
| Auth | Vercel OAuth |
| GitHub 연동 | GitHub App |
필요 환경변수
최소 실행
POSTGRES_URL=
JWE_SECRET=
실제 사용 (인증 포함)
ENCRYPTION_KEY=
NEXT_PUBLIC_VERCEL_APP_CLIENT_ID=
VERCEL_APP_CLIENT_SECRET=
GitHub 연동 (풀 기능)
NEXT_PUBLIC_GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=
GITHUB_APP_ID=
GITHUB_APP_PRIVATE_KEY=
NEXT_PUBLIC_GITHUB_APP_SLUG=
GITHUB_WEBHOOK_SECRET=
배포 방법
- 리포지토리 포크
- PostgreSQL DB 생성
- 시크릿 생성 후 Vercel에 배포
- Vercel OAuth App 생성
- (선택) GitHub App 생성
관련 생태계
- vercel-labs/skills (13.9K★) — 오픈 에이전트 스킬 CLI. Claude Code, Codex, Cursor 등 41개 에이전트 지원
- vercel-labs/agent-skills (24.9K★) — Vercel 공식 스킬 컬렉션. React/Next.js 베스트 프랙티스 등
관련 노트
- 2026-04-14-superconductor-multi-agent-ide — 다중 코딩 에이전트 관리 IDE
- 2026-04-14-claude-code-profile-managers — Claude Code 프로필 관리 도구