eve

用 TypeScript+Markdown 快速搭出可上线的 AI Agent

开源 freemium 开发框架

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 5535

维护状态活跃

是否开源是

定价模式 freemium

项目预览

项目数据

分类开发框架

开发团队vercel

所属国家

官网地址https://eve.dev

GitHubhttps://github.com/vercel/eve

定价模式freemium

价格说明开源框架免费，托管云服务可能付费，定价待确认

访问状态

是否开源是

开源协议Apache-2.0

主要语言TypeScript

技术栈/模型agent,framework,harness,javascript,markdown,sandbox,typescript,vercel,workflows

GitHub 星标★ 5535

30天Star增速

HF 下载量

上线时间2026-06-16 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-13

浏览次数0

项目介绍

eve 是一个用 TypeScript 编写的开源 Agent 开发框架，定位为「构建智能体的开放框架」。它把 Agent 运行所需的核心要素抽象成可组合的模块：工作流编排、工具调用、沙箱执行、以及用 Markdown 定义的提示词与技能文件。开发者不必从零搭建循环调度、上下文管理和执行隔离，只需按框架约定编写 TypeScript 逻辑和 Markdown 配置，就能快速得到一个可运行、可扩展的 Agent。项目强调开放与可移植，与 Vercel 生态有较深集成，适合在 Serverless 或边缘环境部署。它解决的是 Agent 开发中「重复造轮子」和「缺乏统一抽象」的问题，让提示词、工具、工作流和沙箱各司其职，降低从原型到生产的迁移成本。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 5 分钟部署方式：命令行工具 5 步

环境要求

已安装 Node.js（需包含 npx / npm 命令）
可访问 npm 源以拉取 eve 包
一个用于存放 Agent 项目的本地目录

安装与启动步骤

1初始化新 Agent

在任意目录执行，会自动创建 my-agent 目录、安装依赖、初始化 Git，并启动交互式终端 UI。
```
npx eve@latest init my-agent
```
2指定其他模型

默认使用 openai/gpt-6-luna-fast 且开启高推理；换模型只需传模型 ID。
```
npx eve@latest init my-agent --model openai/gpt-5.6-terra
```
3接入已有项目

先进入自己的项目目录，再用点号把 eve 初始化到当前目录，而不是新建文件夹。
```
cd myapp
npx eve@latest init .
```
4查看本地文档

eve 包内置完整文档，编码类 Agent 可直接从该目录本地读取，无需联网查资料。
```
ls node_modules/eve/docs
```
5编写提示词与工具

按约定在 agent/ 下放置 instructions.md（必需）、agent.ts、tools/ 与 skills/。

关键配置

配置项	必填	说明	示例
`--model`	否	指定 AI Gateway 模型 ID，不传则用默认模型	`openai/gpt-5.6-terra`
`--reasoning`	否	显式设置推理档位；不传则用提供方默认值	`high`
`agent/agent.ts`	否	可选文件，用于配置模型与运行时参数	`agent/agent.ts`
`agent/instructions.md`	是	必需文件，常驻的系统提示词	`agent/instructions.md`
`agent/tools/`	否	可选目录，存放模型可调用的类型化函数	`agent/tools/get_weather.ts`
`agent/skills/`	否	可选目录，存放 Markdown 定义的技能文件	`agent/skills/`

如何确认成功

init 命令执行完毕后会自动拉起交互式终端 UI，终端出现该界面即表示初始化并启动成功。

常见问题

Q：想换成别的模型怎么办？

A：在 init 时追加 --model 并传入 AI Gateway 的模型 ID，例如 npx eve@latest init my-agent --model openai/gpt-5.6-terra；不加 --reasoning 时使用提供方默认推理档位。

Q：能加到现有项目里而不是新建目录吗？

A：可以。先 cd 进入你的项目目录，再执行 npx eve@latest init .，eve 会初始化到当前目录。

Q：eve 的文档在哪看？

A：eve 包自带完整文档，安装在项目的 node_modules/eve/docs 下，可直接本地阅读，也方便编码 Agent 读取。

Q：Agent 目录里哪些文件是必须的？

A：只有 agent/instructions.md 是必需的常驻系统提示词；agent.ts、tools/、skills/ 都是可选的。

注意事项

init 会自动创建目录、安装依赖并初始化 Git，请在有写权限的路径下执行。
默认 Agent 使用 openai/gpt-6-luna-fast 并开启高推理，可通过 --model 更换。
项目采用「文件系统即编写界面」的设计，提示词与技能以 Markdown 文件形式维护。
eve 与 Vercel 生态集成较深，适合在 Serverless 或边缘环境部署。

核心亮点

用 Markdown 定义提示词与技能，非工程同学也能参与迭代
内置工作流编排与沙箱执行，省去自建调度和隔离层
TypeScript 全栈类型支持，与 Vercel 部署链路衔接顺畅

不足之处

项目较新，API 和文档可能仍在快速变动
生态与周边工具相比成熟框架仍显单薄

适用场景

快速搭建带工具调用的客服或问答 Agent
在 Serverless 环境部署轻量级自动化工作流
团队用 Markdown 协作维护提示词与技能库

替代项目

LangChain、Mastra

上一篇：openai-agents-js

下一篇：ms-agent

eve