AI Sparkup

최신 AI 쉽게 깊게 따라잡기⚡

Eve – 파일 시스템 구조로 프로덕션 에이전트를 만드는 Vercel 오픈소스 프레임워크

Eve는 Vercel이 공개한 오픈소스 에이전트 프레임워크다. 에이전트를 디렉터리 안의 파일들로 정의하고, durable execution, sandboxed compute, human-in-the-loop approval, subagents, evals, channels, schedules 같은 프로덕션 기능을 기본 구성요소로 제공한다.

핵심 아이디어

Eve에서 에이전트는 특별한 서버 코드 덩어리가 아니라 파일 시스템 구조다.

agent/
  agent.ts
  instructions.md
  tools/
  skills/
  subagents/
  channels/
  schedules/

agent.ts는 모델과 설정을 정의하고, instructions.md는 에이전트의 정체성과 상시 규칙을 담는다. 도구, 스킬, 채널, 스케줄은 파일을 추가하면 빌드 시점에 Eve가 감지해 연결한다.

Agent Stack과의 관계

Vercel은 에이전트가 공통적으로 필요한 세 가지 계층을 “Agent Stack”으로 정리한다.

계층Vercel 구성요소역할
모델 연결AI SDK, AI Gateway여러 모델 호출, 라우팅, 스트리밍
장기 실행Workflow SDK, Vercel Sandboxdurable workflow, 격리 실행 환경
도구·채널 연결Vercel Connect, Chat SDKscoped access, 사용자 접점

Eve는 이 스택 위에서 에이전트를 파일 중심으로 정의하고 운영하는 프레임워크다. open-agents가 백그라운드 코딩 에이전트 레퍼런스 앱이라면, Eve는 다양한 도메인의 에이전트를 만들기 위한 범용 프레임워크에 가깝다.

빠른 시작

npx eve@latest init my-agent

가장 작은 Eve 에이전트는 모델 설정과 instructions 파일만으로 실행된다. 이후 agent/tools/get_weather.ts처럼 typed tool을 추가하거나, Slack·Discord·GitHub 같은 channel 파일을 붙여 배포 대상을 확장할 수 있다.

Vercel 프로젝트이므로 로컬에서 실행한 구조를 vercel deploy로 그대로 배포하는 흐름을 전제로 한다.

어디에 적합한가

  • TypeScript 기반으로 프로덕션 에이전트를 만들고 싶은 팀
  • 에이전트 파일 구조, 스킬, 서브에이전트, 스케줄을 명시적으로 관리하려는 개발자
  • Vercel AI SDK, AI Gateway, Workflow SDK, Sandbox를 이미 쓰는 조직
  • agent-skillsmcp를 프로덕션 런타임에 자연스럽게 얹고 싶은 팀

관련 문서

  • open-agents — Vercel의 백그라운드 코딩 에이전트 레퍼런스 앱
  • Vercel AI SDK — 모델 호출·스트리밍·도구 호출을 통합하는 Vercel AI 앱 SDK
  • mcp — 외부 도구와 에이전트를 연결하는 표준 프로토콜
  • agent-skills — 에이전트 능력을 파일 기반 지식으로 확장하는 시스템

참고 자료



AI Sparkup 구독하기

최신 게시물 요약과 더 심층적인 정보를 이메일로 받아 보세요! (무료)