Vercel Eve 深度解析:Next.js for Agents,开源 Agent 框架的生产级实践
Vercel 发布 Eve 开源 Agent 框架,将 Agent 视为文件目录,内置持久化执行、沙箱计算、人工审批、MCP 连接等六大能力。本文深度解析其架构设计、与 Mastra/LangGraph 的对比,以及生产环境部署建议。
Vercel Eve 深度解析:Next.js for Agents,开源 Agent 框架的生产级实践
一句话总结:Vercel Eve 是首个将 Agent 视为文件目录的开源框架,内置持久化执行、沙箱计算、人工审批、MCP 连接等六大生产级能力。Vercel 内部已运行 100+ Agent,触发约 29% 的部署。
一、发布背景:Vercel 的 Agent 基础设施战略
2026 年 6 月 17 日,Vercel 在年度 Ship 大会上发布了一系列 Agent 基础设施产品,核心包括:
- Vercel Services:前后端统一部署引擎
- Agent Stack:AI SDK + AI Gateway + Sandbox + Workflow SDK + Chat SDK
- Vercel Connect:MCP 服务器 / OpenAPI 的安全连接(替代长期凭证)
- Vercel Agent:主动式 AI 运维助手(Beta)
- eve:开源 Agent 框架(Apache 2.0)
Eve 的定位非常明确:“Next.js for Agents”——就像 Next.js 简化了全栈 Web 开发,Eve 要简化 Agent 的开发、部署和运维。
二、核心架构:目录即 Agent
Eve 的哲学是文件系统优先(filesystem-first)。一个 Agent 就是一个目录:
my-agent/
├── model.md # 模型配置(一行代码指定模型)
├── instructions.md # 系统提示(Markdown 格式)
├── tools/
│ ├── search.ts # 工具:文件名即工具名
│ ├── deploy.ts # 工具:自动注册,无需额外配置
│ └── delete-data.ts # 敏感工具:可标记为需人工审批
├── skills/
│ ├── coding.md # 技能定义
│ └── analysis.md # 技能定义
└── connections/
├── slack.json # MCP 连接配置
└── github.json # API 连接配置
2.1 六大内置能力
| 能力 | 说明 | 技术实现 |
|---|---|---|
| 持久化执行 | 对话即工作流,每步检查点,可暂停/恢复 | Vercel Workflow SDK |
| 沙箱计算 | Agent 生成代码视为不可信,独立沙箱运行 | Vercel Sandbox / Docker / microsandbox |
| 人工审批 | 任何工具可标记为需人工批准 | 可配置 per-tool |
| 安全连接 | MCP 服务器 / OpenAPI 连接,模型不接触凭证 | Vercel Connect |
| 多通道 | 同一 Agent 服务多平台 | HTTP / Slack / Discord / Teams / Telegram / Twilio / GitHub / Linear |
| 追踪与评估 | OpenTelemetry 标准追踪,导出到 Braintrust / Honeycomb / Datadog | 内置 eval 框架 |
三、与竞品框架的对比
3.1 Eve vs Mastra vs LangGraph
| 维度 | Eve | Mastra | LangGraph |
|---|---|---|---|
| 语言 | TypeScript | TypeScript | Python-first |
| 部署 | Vercel 原生(其他平台”即将支持”) | 任何平台 | 任何平台 |
| 持久化 | ✅ 内置(Workflow SDK) | ✅ 内置 | ✅ 内置 |
| 沙箱 | ✅ 内置(Vercel Sandbox) | ⚠️ 需配置 | ⚠️ 需配置 |
| 人工审批 | ✅ 内置 | ⚠️ 需配置 | ⚠️ 需配置 |
| MCP 支持 | ✅ 内置(Vercel Connect) | ✅ 支持 | ✅ 支持 |
| 多通道 | ✅ 内置 8+ 通道 | ⚠️ 需配置 | ⚠️ 需配置 |
| 追踪 | ✅ OpenTelemetry 内置 | ⚠️ 需配置 | ⚠️ 需配置 |
| 许可证 | Apache 2.0 | MIT | MIT |
| 生产验证 | Vercel 内部 100+ Agent | YC 支持,v1.0 已发布 | LangChain 生态,最成熟 |
3.2 关键差异
Eve 的优势:
- 开箱即用:6 大生产级能力零配置启用
- Vercel 生态深度整合:部署、沙箱、连接、追踪一键搞定
- 真实生产验证:Vercel 内部 100+ Agent,29% 部署由 Agent 触发
Eve 的局限:
- 平台锁定(目前):默认仅支持 Vercel,其他平台”coming soon”
- 生态早期:刚发布,社区插件和第三方集成较少
- TypeScript 限定:非 TS 团队需要适配
四、快速开始
4.1 初始化项目
npx eve@latest init my-agent
cd my-agent
4.2 定义模型
# model.md
gpt-4o
支持通过 Vercel AI Gateway 的 provider fallback:
# model.md
anthropic/claude-sonnet-4
# fallback: openai/gpt-4o
4.3 定义工具
// tools/search.ts
export default async function search({ query }: { query: string }) {
const results = await fetch(`https://api.example.com/search?q=${query}`);
return results.json();
}
文件名即工具名,自动注册,无需装饰器或配置。
4.4 部署
vercel deploy
# 同一 Agent 目录,零改动部署到生产
五、生产级特性详解
5.1 持久化执行:对话即工作流
// Agent 会话自动持久化
// 崩溃后可恢复,部署后可恢复
// 人工审批后可恢复
每个对话是 Vercel Workflow SDK 的一个 durable workflow:
- 每步自动检查点(checkpoint)
- 支持暂停、恢复、重试
- 跨部署保持状态
5.2 沙箱计算:安全执行 Agent 代码
// tools/run-code.ts
// 标记为需要沙箱
export const config = { sandbox: true };
export default async function runCode({ code }: { code: string }) {
// 在隔离沙箱中执行,无法访问主机文件系统
return executeInSandbox(code);
}
- 本地:Docker / microsandbox / bash
- 生产:Vercel Sandbox(自动切换,零配置)
5.3 人工审批:敏感操作可控
// tools/delete-database.ts
export const config = { requireApproval: true };
export default async function deleteDatabase({ confirm }: { confirm: boolean }) {
// 执行前会暂停,等待人工在 Vercel Dashboard 批准
if (!confirm) throw new Error("Approval required");
return db.delete();
}
5.4 MCP 连接:安全集成外部服务
// connections/slack.json
{
"type": "mcp",
"server": "https://mcp-slack.example.com",
"auth": "vercel-connect"
}
- 模型永远看不到 URL 或凭证
- Vercel Connect 自动处理 OAuth 和 token 刷新
- 支持 Slack、GitHub、Snowflake、Salesforce、Notion、Linear
六、NixAPI 视角:统一 API 层与 Agent 框架的协同
对于使用 NixAPI 的开发者,Eve 的 MCP 连接能力意味着:
// 通过 NixAPI MCP 服务器,将统一 API 接入 Eve Agent
// connections/nixapi.json
{
"type": "mcp",
"server": "https://mcp.nixapi.com",
"auth": "vercel-connect"
}
协同价值:
- 模型路由:Eve 的 AI Gateway fallback + NixAPI 的统一路由 = 双重可靠性
- 成本优化:NixAPI 自动选择最低成本模型,Eve 的追踪提供透明计费
- 多模型 Agent:一个 Eve Agent 可以通过 NixAPI 同时调用 Claude、GPT、M3 等不同模型
- 数据主权:NixAPI 的私有化部署 + Eve 的自托管沙箱 = 完整数据控制
七、总结与展望
| 维度 | 评分 | 说明 |
|---|---|---|
| 易用性 | ⭐⭐⭐⭐⭐ | 目录即 Agent,零配置生产级能力 |
| 生产就绪 | ⭐⭐⭐⭐⭐ | Vercel 内部 100+ Agent 验证 |
| 生态开放 | ⭐⭐⭐ | 目前 Vercel 锁定,其他平台支持待发布 |
| NixAPI 相关性 | ⭐⭐⭐⭐⭐ | MCP 连接 + 统一 API 层天然契合 |
Vercel Eve 代表了 Agent 框架的范式转移:从”需要大量配置的工具链”到”开箱即用的基础设施”。对于已经在 Vercel 生态中的团队,Eve 是目前最理性的 Agent 开发选择。
对于非 Vercel 用户,建议:
- 关注进展:Vercel 承诺”其他平台支持即将到来”
- 评估 Mastra:如果需要跨平台部署,Mastra v1.0 是更成熟的 TypeScript 选项
- 试用验证:通过
npx eve@latest init快速体验目录即 Agent 的开发模式
本文基于 2026 年 6 月 17-18 日的公开信息整理。Eve 目前处于 public preview 阶段,API 和功能可能持续迭代。