eve 是 Vercel 推出的 TypeScript AI Agent 开发框架,定位为“filesystem-first”的持久化智能体框架。它通过约定式目录结构组织 Agent 的系统提示词、工具、技能、消息渠道和定时任务,使开发者可以像维护普通工程项目一样开发、审查和运维 AI Agent。项目目前处于 beta 阶段,采用 Apache-2.0 许可证,适合希望用 Node.js/TypeScript 快速构建生产级或原型级 AI Agent 的团队。
适用领域
AI Agent 开发框架 / 大模型应用开发 / 工作流自动化 / 智能助手 / 工具调用与函数调用 / 人机协作系统 / 定时任务与自动化代理 / Slack/Discord/HTTP 等渠道集成 / TypeScript 后端开发
配置难度
中等。对于熟悉 TypeScript、Node.js 和大模型 API 的开发者,上手难度较低;但如果要构建生产级 Agent,需要理解工具调用、Prompt 设计、权限控制、错误处理、状态管理、渠道接入和部署运维,整体复杂度会提升。
商业价值
eve 的商业价值在于帮助团队以标准化、工程化的方式构建 AI Agent。它适合企业将内部流程、知识库、运维任务、客户支持和协作工具接入大模型,快速形成自动化助手或智能工作流。对中国开发团队而言,它可以作为 AI Agent 原型开发和工程结构参考,尤其适合 TypeScript 技术栈团队。不过由于项目仍处 beta,若用于核心生产系统,应先进行小范围试点,并重点评估稳定性、安全性、模型成本和国内网络可用性。
01
技术亮点
- 文件系统优先:Agent 的核心能力按约定目录组织,例如 instructions、tools、skills、channels、schedules,便于理解和维护。
- 结构清晰:系统提示词、工具函数、技能文档、渠道集成和定时任务分离,适合团队协作。
- TypeScript 原生:工具通过 TypeScript 编写,并可结合 zod 定义输入 Schema,提升类型安全和参数校验能力。
- 由 Vercel 维护:背靠知名云平台和前端基础设施团队,生态关注度较高。
- 快速启动:使用 `npx eve@latest init` 可快速生成项目脚手架。
- 支持本地文档:npm 包内包含完整文档,方便编码 Agent 或离线查阅。
- 适合 Agent 工程化:相比单文件 Prompt Demo,更强调可检查、可扩展、可运维的 Agent 项目结构。
- 支持多种扩展点:包括工具调用、按需技能、消息渠道、定时任务、人机协作和子 Agent 等能力。
02
目标用户
- 使用 TypeScript/Node.js 构建 AI 应用的开发者
- 希望快速搭建 AI Agent 原型的创业团队
- 需要将 LLM 接入内部工具、工作流或业务系统的企业开发团队
- 熟悉 Vercel 生态的前端/全栈工程师
- 希望用文件目录管理 Prompt、工具和 Agent 能力的 AI 工程师
- 构建 Slack、Discord、HTTP 机器人或自动化助手的开发者
- 希望研究 Agent 框架设计的技术负责人或架构师
03
配置要求
- 需要 Node.js/npm 开发环境。
- 项目主要使用 TypeScript,开发者需要具备基本 TypeScript 能力。
- 需要在 `agent/instructions.md` 中提供必需的系统提示词。
- 如使用外部大模型,需要配置相应模型服务的 API Key,具体变量名需参考 eve 文档或所选模型提供商要求。
- 如使用 Anthropic、OpenAI 或其他模型,需要确保账户、额度和网络访问可用。
- 如接入 Slack、Discord、HTTP 等渠道,需要配置对应平台的 Token、Webhook、回调地址或权限。
- 如使用 schedules,需要确认运行环境支持长期运行或定时任务执行。
- 如果部署到 Vercel 或其他云平台,需要结合平台的环境变量、运行时限制和持久化能力进行配置。
04
适用场景
- 构建带工具调用能力的 AI 助手,例如天气查询、数据检索、内部系统操作
- 构建 Slack、Discord 或 HTTP 接入的企业内部机器人
- 通过 schedules 实现定时总结、日报、周报、监控提醒等自动化任务
- 将业务流程封装为 skills,让 Agent 按需加载流程说明并执行任务
- 构建人机协同流程,例如在关键操作前请求人工确认
- 开发可维护的 Prompt 工程项目,将 instructions.md 作为系统提示词入口
- 为产品原型快速搭建 AI Agent 后端
- 在团队中标准化 Agent 项目结构,便于代码审查、扩展和运维
05
部署与配置
- 确保本地已安装 Node.js 和 npm,建议使用较新的 LTS 版本。
- 创建新 Agent 项目:运行 `npx eve@latest init my-agent`。
- 进入生成的项目目录:`cd my-agent`。
- 初始化过程会自动安装依赖、初始化 Git,并启动交互式终端 UI。
- 如需在已有项目中集成 eve,可进入项目目录后运行:`npx eve@latest init .`。
- 编辑 `agent/instructions.md`,编写 Agent 的系统提示词。
- 如需添加工具,在 `agent/tools/` 下创建 TypeScript 文件,并使用 `defineTool` 定义工具。
- 如需指定模型,在 `agent/agent.ts` 中使用 `defineAgent` 配置模型,例如 `anthropic/claude-sonnet-4.6`。
- 启动开发环境:运行 `npm run dev`。
- 更多文档可访问 `https://eve.dev/docs`,也可在安装后查看本地 `node_modules/eve/docs`。
06
风险与注意事项
- 项目目前处于 beta 阶段,API、文档和行为可能在正式版前发生变化。
- Agent 框架生态竞争激烈,如 LangChain、LlamaIndex、Mastra、CrewAI 等,长期生态地位仍需观察。
- README 中展示的信息有限,复杂生产部署、状态持久化、权限控制、观测性等细节需要进一步阅读官方文档。
- 依赖外部大模型服务,可能受到 API 成本、响应延迟、模型稳定性和数据合规要求影响。
- Agent 具备工具调用能力后,如果权限边界设计不当,可能带来误操作、越权访问或安全风险。
- 在中国大陆环境中,部分模型服务、Vercel 服务或 GitHub/npm 访问可能受到网络影响,需要准备代理或替代模型提供商。
- 作为新框架,社区经验、第三方插件和中文资料可能相对不足。
- 长期运行的 schedules、channels 等能力在不同部署平台上的可靠性需要实际验证。
2026-06-23
第1名
新收录 · github_search
2026-06-22
第1名
新收录 · github_search
2026-06-21
第2名
新收录 · github_search
2026-06-20
第2名
新收录 · github_search
2026-06-19
第4名
新收录 · github_search