TypeScript · 项目报告

vercel/eve

The Framework for Building Agents

已完成 打开 GitHub
V
2,231星标
161Fork
78Issue
Apache-2.0许可证

分析结果

项目分析

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