[GeekNews 요약] Open Agents — Vercel에서 코딩 에이전트를 구축하고 실행하는 오픈소스 레퍼런스 앱
63
설명
Open Agents는 Vercel에서 백그라운드 코딩 에이전트를 구축하고 실행하기 위한 오픈소스 레퍼런스 앱입니다. 개발자는 이 템플릿을 활용하여 프롬프트부터 코드 변경까지 노트북 개입 없이 자동화된 개발 워크플로우를 구현할 수 있습니다. 에이전트와 샌드박스의 분리된 아키텍처를 통해 유연하고 확장 가능한 시스템을 제공하며, AI 기반 개발 자동화에 관심 있는 개발자에게 유용한 시작점이 될 것입니다.
### 1. 무엇인가요?
Open Agents는 Vercel에서 백그라운드 코딩 에이전트를 구축하고 실행하기 위한 오픈소스 레퍼런스 앱입니다. 웹 UI, 에이전트 런타임, 샌드박스 오케스트레이션, GitHub 통합을 포함하여 프롬프트에서 코드 변경까지 노트북 개입 없이 진행할 수 있도록 설계되었습니다. 이 저장소는 블랙박스처럼 사용하기보다는 포크하여 목적에 맞게 수정하고 적용하도록 의도되었습니다.
### 2. 핵심 아키텍처
Open Agents는 웹(Web), 에이전트 워크플로우(Agent workflow), 샌드박스 VM(Sandbox VM)의 세 가지 계층 시스템으로 구성됩니다. 웹 앱은 인증, 세션, 채팅 및 스트리밍 UI를 처리하고, 에이전트는 Vercel에서 지속 가능한 워크플로우로 실행됩니다. 샌드박스는 파일 시스템, 셸, Git, 개발 서버 및 미리보기 포트를 포함하는 실행 환경입니다. 여기서 핵심적인 아키텍처 결정은 '에이전트가 샌드박스 내에서 실행되지 않는다'는 점입니다. 에이전트는 샌드박스 외부에서 실행되며 파일 읽기, 편집, 검색, 셸 명령과 같은 도구를 통해 샌드박스와 상호작용합니다. 이러한 분리는 에이전트 실행이 단일 요청 수명 주기에 묶이지 않고, 샌드박스 수명 주기가 독립적으로 휴면 및 재개될 수 있으며, 모델/프로바이더 선택 및 샌드박스 구현이 독립적으로 발전할 수 있도록 합니다.
### 3. 주요 기능
Open Agents는 다음과 같은 주요 기능을 제공합니다:
* 파일, 검색, 셸, 작업, 스킬, 웹 도구를 갖춘 채팅 기반 코딩 에이전트
* Workflow SDK 기반의 실행, 스트리밍 및 취소를 통한 지속 가능한 다단계 실행
* 스냅샷 기반 재개를 지원하는 격리된 Vercel 샌드박스
* 샌드박스 내에서 저장소 복제 및 브랜치 작업
* 성공적인 실행 후 선택적 자동 커밋, 푸시 및 PR 생성
* 읽기 전용 링크를 통한 세션 공유
* ElevenLabs 전사를 통한 선택적 음성 입력
### 4. 배포 및 설정
Open Agents는 Vercel에 쉽게 배포할 수 있도록 설계되었습니다. 저장소를 포크하고 PostgreSQL 데이터베이스를 생성한 후, 필요한 환경 변수(JWE_SECRET, ENCRYPTION_KEY 등)를 설정하여 Vercel에 배포할 수 있습니다. Vercel OAuth 앱 및 GitHub 앱 통합을 통해 사용자 인증, 저장소 접근, 푸시 및 PR 생성 기능을 활성화할 수 있습니다. 로컬 개발 환경 설정 또한 `bun install` 및 `bun run web` 명령으로 간편하게 시작할 수 있습니다.
### 5. 프로젝트 레이아웃
저장소는 다음과 같은 주요 디렉토리로 구성됩니다:
* `apps/web`: Next.js 앱, 워크플로우, 인증, 채팅 UI
* `packages/agent`: 에이전트 구현, 도구, 서브 에이전트, 스킬
* `packages/sandbox`: 샌드박스 추상화 및 Vercel 샌드박스 통합
* `packages/shared`: 공유 유틸리티
### 가치와 인사이트
Open Agents는 AI 기반 코딩 에이전트 개발의 복잡성을 줄이고 실질적인 자동화 워크플로우를 구축할 수 있는 강력한 기반을 제공합니다. 특히 에이전트와 샌드박스를 분리한 아키텍처는 에이전트의 실행 환경과 코드 실행 환경을 독립적으로 관리할 수 있게 하여, 안정성과 유연성을 크게 향상시킵니다. 이는 에이전트가 단일 요청에 묶이지 않고 장기 실행 작업을 수행하며, 다양한 모델과 샌드박스 구현을 쉽게 교체할 수 있음을 의미합니다. 개발자는 이를 통해 반복적인 개발 작업을 자동화하고, CI/CD 파이프라인에 AI 에이전트를 통합하여 생산성을 높일 수 있습니다. 예를 들어, 특정 이슈에 대한 코드 변경을 자동으로 제안하고 PR을 생성하는 등의 시나리오에 활용될 수 있습니다.
### 기술·메타
* **프레임워크/런타임**: Next.js, Bun
* **데이터베이스**: PostgreSQL
* **클라우드 플랫폼**: Vercel
* **통합**: GitHub App, Vercel OAuth, ElevenLabs (음성 입력)
* **언어**: TypeScript
* **라이선스**: MIT License
📝 원문 및 참고
- 원문: [링크 열기](https://github.com/vercel-labs/open-agents)
- GeekNews 토픽: [보기](https://news.hada.io/topic?id=28601)
---
출처: GeekNews ([원문 링크](https://github.com/vercel-labs/open-agents))
신고 · 불법·유해·아동 안전(CSAE) 관련 콘텐츠
댓글 0
아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.