Open Agents는 Vercel Labs가 공개한 오픈소스 레퍼런스 앱으로, 백그라운드 코딩 에이전트를 Vercel 위에서 구축하고 운영하는 데 필요한 웹 UI, 에이전트 런타임, 샌드박스 오케스트레이션, GitHub 통합을 모두 포함한다. 프롬프트에서 코드 변경까지 노트북을 켜두지 않아도 처리한다.

블랙박스로 쓰는 대신 포크해서 자신의 요구에 맞게 확장하는 것을 전제로 설계됐다.

3계층 아키텍처

Web → Agent Workflow → Sandbox VM

핵심 설계 결정: 에이전트와 샌드박스 분리

에이전트는 VM 안이 아닌 외부에서 실행되며, 파일 읽기·편집·검색·셸 명령 도구로 샌드박스와 상호작용한다. 이 분리로 얻는 이점:

• 에이전트 실행이 단일 요청 수명주기에 묶이지 않음
• 샌드박스가 독립적으로 하이버네이트·재개 가능
• 모델/프로바이더 선택과 샌드박스 구현을 독립적으로 변경 가능
• VM이 제어 플레인이 되지 않고 순수 실행 환경으로 유지

주요 기능

• 채팅 기반 코딩 에이전트: 파일·검색·셸·태스크·스킬·웹 도구 지원
• 지속성 멀티스텝 실행: Workflow SDK 기반, 스트리밍·취소 지원
• 격리 Vercel 샌드박스: 스냅샷 기반 재개(resume)
• repo 클론 & 브랜치 작업: 샌드박스 내 git 작업
• 자동 커밋·PR 생성: 성공적인 실행 후 선택적 자동화
• 세션 공유: 읽기 전용 링크로 공유
• 음성 입력: ElevenLabs 트랜스크립션 연동 (선택)

런타임 동작

• 채팅 요청이 인라인 실행 대신 워크플로우 런을 시작
• 에이전트 각 턴이 여러 영속 워크플로우 스텝에 걸쳐 진행 가능
• 활성 런은 기존 워크플로우 스트림에 재연결해 재개
• 샌드박스: 기본 스냅샷, 포트 3000/5173/4321/8000 노출, 비활성 후 하이버네이트

누구에게 유용한가

• 백그라운드 에이전트 제품을 만드는 개발자: 처음부터 구축하지 않고 레퍼런스 아키텍처를 기반으로 시작
• AI 코딩 플랫폼 실험자: 에이전트-샌드박스 분리 아키텍처를 실제 코드로 탐구
• Vercel 인프라 사용자: Neon·Upstash 스토리지와 함께 즉시 배포 가능

빠른 시작

# Vercel에 배포
vercel deploy

# 또는 Clone 후 로컬 실행
git clone https://github.com/vercel-labs/open-agents
cd open-agents
# .env.example 참고해 환경 변수 설정

필수 환경 변수:

POSTGRES_URL=              # Neon 자동 제공
BETTER_AUTH_SECRET=        # 직접 생성
NEXT_PUBLIC_VERCEL_APP_CLIENT_ID=
VERCEL_APP_CLIENT_SECRET=
GITHUB_APP_ID=             # GitHub 저장소 접근·PR 생성용
GITHUB_APP_PRIVATE_KEY=

관련 도구

• cloudflare-agents — Durable Objects 기반 영속 상태 AI 에이전트 SDK
• claude-agent-sdk — .claude/ 폴더를 프로덕션 에이전트 런타임으로 활용

참고 자료

• Open Agents — Vercel Templates — Vercel