엔터프라이즈 Eve 에이전트 개발
Vercel Eve 0.11.4 코드베이스를 기준으로 파일시스템 우선 에이전트의 핵심 기술, 보안 경계, 고급 운영 패턴을 정리한 실전 가이드
최근 수정된 챕터
defineAgent 설정을 모델 라우팅, 출력 스키마, 컴팩션, experimental flag 관점에서 운영 기준으로 해석한다.
Eve channel이 세션 생성, continuation token, route auth, NDJSON stream을 어떻게 책임지는지 분석한다.
Eve가 source manifest를 compiled manifest와 runtime agent graph로 바꾸는 과정을 분석한다.
Eve의 컨텍스트 제어 원칙과 skills, dynamic tools, dynamic instructions를 활용한 고급 에이전트 설계를 정리한다.
Eve로 고객지원, 내부 리서치, 코드 작업, 백오피스 자동화, 데이터 분석 에이전트를 설계하는 패턴을 정리한다.
Eve는 Vercel이 공개한 filesystem-first durable backend AI agent framework입니다.
에이전트를 거대한 설정 객체로 만드는 대신 agent/ 아래에 파일을 배치해 작성하면, Eve가 이를 discovery → compiler → runtime graph → durable workflow → channel/client/eval 표면으로 변환합니다.
이 책은 기본 튜토리얼이 아닙니다. 이미 AI 에이전트를 만들고 운영해 본 고급 사용자, 플랫폼 엔지니어, AgentOps 담당자, 사내 자동화/코딩 에이전트 운영자를 위한 책입니다. “작동하는 데모”가 아니라 권한 경계, 내구성, 평가, 관측성, 승인, 샌드박스 격리, 멀티에이전트 운영에 초점을 둡니다.
분석 기준
기준 소스는 비공개 로컬 Eve 소스 체크아웃이며, packages/eve/package.json 기준 Eve 버전은
0.11.4입니다. 2026-06-18에는 Eve 공식 문서와
공식 sitemap의 /docs/* 67개 문서를 전수 대조해 표현과 누락 범위를 보정했습니다.
Beta 기준
공식 사이트는 Eve를 Beta로 표시합니다. 엔터프라이즈 도입 시 API 안정성, Vercel beta terms, provider 약관, telemetry/export 경로, approval 정책을 별도 릴리스 게이트로 관리해야 합니다.
Eve를 엔터프라이즈 관점에서 보는 이유
Eve의 강점은 단순한 defineTool() 문법이 아니라 다음 네 가지 경계에 있습니다.
| 경계 | Eve의 설계 | 엔터프라이즈 의미 |
|---|---|---|
| 작성 경계 | agent/ 파일 슬롯 | 코드 리뷰와 권한 검토가 쉬운 에이전트 표면 |
| 실행 경계 | app runtime vs sandbox | 비밀값과 모델 주도 셸 실행의 분리 |
| 내구성 경계 | session → turn → step | 재시작/재배포 이후에도 이어지는 장기 작업 |
| 운영 경계 | hooks, evals, OTel, Agent Runs | 품질·비용·보안 회귀를 운영 루프로 관리 |
핵심 아키텍처
운영 원칙
| 원칙 | 실무 기준 |
|---|---|
| 파일 슬롯은 API다 | tools/, skills/, connections/, subagents/를 권한·리뷰 단위로 관리합니다. |
| 모델에는 최소 정보만 보인다 | toModelOutput, skills progressive disclosure, sandbox workspace로 컨텍스트를 분리합니다. |
| 부작용은 재실행 가능해야 한다 | step 중단 후 재실행될 수 있으므로 idempotency key 또는 HITL approval을 둡니다. |
| 채널이 세션 소유권을 책임진다 | continuation token은 큐가 아니며, 사용자/테넌트 소유권은 route auth 위에 직접 설계합니다. |
| 평가와 관측성이 배포 조건이다 | eve eval --strict, hook 감사 로그, OTel, $eve.* workflow tags를 게이트로 둡니다. |
책 구성
Part 1. 기초 아키텍처
Ch1. Eve 멘탈 모델
Eve를 파일시스템, 내구성, 채널, 하네스 네 계층으로 이해합니다.
Ch2. 소스 코드 지도
packages/eve/src 디렉터리를 구현 책임별로 해부합니다.
Ch3. 프로젝트 레이아웃과 Discovery
agent/ 슬롯이 어떻게 source manifest로 변환되는지 분석합니다.
Part 2. 에이전트 품질 설계
Ch5. agent.ts, 모델, 컴팩션
모델 라우팅, output schema, context compaction을 운영 기준으로 설정합니다.
Ch6. Context, Skills, Dynamic Capabilities
고품질 응답을 위한 컨텍스트 제어와 멀티테넌트 동적 기능을 설계합니다.
Ch7. Tools, Approval, Connections
도구 실행, OAuth, MCP/OpenAPI 연결, 승인 게이트를 안전하게 조합합니다.
Part 3. 운영 런타임
Ch9. Channels, Auth, Streaming
route auth, continuation token, NDJSON stream, custom channel을 설계합니다.
Ch10. Subagents, Workflows, Remote Agents
로컬/원격 하위 에이전트와 experimental Workflow orchestration을 다룹니다.
Ch11. Schedules, State, Hooks
cron, durable state, event hook을 운영 자동화에 연결합니다.