Vercel Eve 是一个面向持久化后端智能体的文件系统优先框架。它把 agent/ 目录视为应用边界，并把部署视为由可独立替换的 HTTP、工作流、沙箱、模型、凭证和可观测性等层组合而成。
用途
Eve 用于构建、开发、部署、自托管、加固和排障持久化后端 AI 智能体。它适合需要长期运行、带副作用、需要持久会话与恢复能力的后端智能体场景。
项目模型
Eve 采用约定式目录结构：常驻行为放在 agent/instructions.md；模型与运行时选项放在 agent/agent.ts；类型化动作放在 agent/tools/*.ts；按需加载的过程放在 agent/skills/；更窄的子智能体放在 agent/subagents/；HTTP、Slack 等入口放在 agent/channels/；类型化外部集成放在 agent/connections/；隔离计算放在 agent/sandbox/；OpenTelemetry 配置放在 agent/instrumentation.ts；周期性工作放在 agent/schedules/。
主要能力
工具是模型推理与外部动作之间的类型化边界，声明类型化输入、输出与副作用，但不持有凭证或授予权限；集成凭证应放在 connections 中，授权应在副作用发生前于服务端强制执行。技能用于仅在相关时加载的较大过程；子智能体用于需要全新历史、更窄工具集或隔离中间状态的工作。连接用于类型化服务集成，沙箱用于生成代码或 shell 工作。
使用方式
快速开始命令为：
npx eve@latest init my-agent cd my-agent npm run dev
最小运行时配置示例：
import { defineAgent } from "eve";
export default defineAgent({ model: "anthropic/claude-opus-4.8", });
在 Vercel 上，字符串模型 ID 会经由 AI Gateway 路由，并可使用项目 OIDC。在 Vercel 之外，需要配置 AI_GATEWAY_API_KEY，或使用带常规凭证的 AI SDK provider 对象。
部署
Vercel 部署可使用 Git 连接的项目或 vercel deploy。Eve 会输出 Vercel Build Output，使用 Vercel Workflows 处理持久会话，通常选择 Vercel Sandbox。面向浏览器的路由在暴露前必须替换脚手架占位认证。
自托管 Node 服务：
eve build PORT=3000 eve start --host 0.0.0.0
该方式使用 .output/ 下的常规 Nitro Node 输出。生产流量前需显式验证持久工作流存储、沙箱后端、模型凭证路径、认证、/eve/ 与 /.well-known/workflow/ 代理前缀、调度执行和遥测。
安全与可观测性
任何生产浏览器请求前，必须用真实策略替换占位认证。在 Vercel 之外，不应将 vercelOidc() 作为唯一认证器。沙箱应仅授予所需的最小网络与凭证访问；沙箱不能保护被刻意注入其中的机密。Vercel Agent Runs 便捷，但应将 OpenTelemetry 视为可移植的运维证据路径；当追踪会包含敏感数据时，将 recordInputs 或 recordOutputs 设为 false。对于个人、敏感或受监管数据，需评估模型输入、工具参数、输出和追踪的保留情况，并在需要时披露收集行为。
验证门
构建部署产物；确认健康端点 GET /eve/v1/health；启动一个已认证会话 POST /eve/v1/session；附加到其流并验证真实回合完成；自托管时需演练持久工作流回调或恢复路径，而不仅是无状态回复；检查追踪并确保机密与敏感载荷不存在或被有意脱敏。
适用场景与限制
Eve 适用于持久化后端智能体的构建与运维。它不适用于独立 ai 包的 ToolLoopAgent、WorkflowAgent 或 HarnessAgent API，也不适用于没有 Eve 智能体的通用 Next.js 部署。若需要厂商中立的工作流编排，应使用相关工作流或智能体框架技能。遇到此类请求时，应说明 Eve 不适用，并转向当前 AI SDK 文档或 AI SDK 专用技能，不应从本技能编写 AI SDK API 代码、模型配置或部署指导。