vercel/eve

什么是 eve？

eve 是一个开源、以文件系统为优先的框架，用于构建持久化 AI 代理——即能够持续运行、保持状态并与工具、调度和聊天频道交互的软件。它由 Vercel 发布，并作为 eve npm 包分发。

它是如何工作的？

以文件系统作为创作界面 – 代理存在于一个具有规定布局的常规目录中：
- agent/instructions.md – 定义代理个性和目标的永久系统提示词。
- agent/tools/ – 暴露模型可调用的类型化函数的 TypeScript 文件（例如：天气查询）。
- agent/skills/ – 可按需加载的基于 Markdown 的程序。
- agent/channels/ – 用于 HTTP、Slack、Discord 或 Vercel Web Chat 的连接器。
- agent/schedules/ – 自动运行的 Cron 风格作业。
- 可选的 agent/agent.ts 用于配置模型（提供者、版本、推理级别）。
CLI 脚手架 – npx eve@latest init <folder> 创建整个结构、安装依赖项并启动交互式终端 UI。
模型选择 – 您可以将代理指向 Vercel AI Gateway 支持的任何模型（例如 openai/gpt-6-luna-fast）。CLI 允许您设置特定的推理层级（高、中、低）。
运行与迭代 – npm run dev 在本地启动代理。框架会监控文件系统，因此编辑工具或提示词会立即改变代理的行为。
部署与分享 – npx eve link 将项目连接到 Vercel 账户，npx eve add channel/web 添加 Web-Chat UI，而 npx eve deploy 则发布一个实时端点。

谁会使用它？

受众	适用原因
构建 AI 助手的开发者	需要一种清晰、版本控制的方式来存储提示词、工具和调度。
产品团队	需要快速发布基于聊天的 AI 功能，并将代码库保留在与应用程序其余部分相同的仓库中。
研究人员 / 爱好者	探索多工具代理，无需连接自定义的无服务器后端。
运维 / DevOps	喜欢持久化代理的概念，可以通过正常的 CI/CD 流水线进行部署、监控和更新。

成熟度如何？

Beta 版本 – README 指出 eve 处于公开测试阶段；API 和行为可能仍会变更。
Vercel 支持 – 托管于 npm，带有 Vercel 风格的徽章，并在 GitHub Discussions 上拥有专属社区。
文档 – 完整文档随包捆绑 (node_modules/eve/docs)，并发布于 https://eve.dev。
开源 – 仓库包含贡献指南、行为准则和安全政策，显示了典型的开源项目生命周期。

快速入门回顾 (来自 README)

# 初始化一个新代理
npx eve@latest init my-agent

# 编辑提示词
vim my-agent/agent/instructions.md

# 添加一个模拟工具 (README 中的示例)
# 本地运行
npm run dev

# 添加网页聊天 UI 并部署
npx eve link
npx eve add channel/web
npx eve deploy

哪里可以了解更多？

官方文档： https://eve.dev/docs – 涵盖完整的项目布局、教程和频道集成。
第一个代理教程： https://eve.dev/docs/tutorial/first-agent – 最小天气演示的分步指南。
社区： GitHub Discussions (https://github.com/vercel/eve/discussions) 用于问答和展示。

总结

eve 为您提供了一种约定的文件夹结构来编写 AI 代理的提示词、工具和调度，让您可以使用 npm run dev 在本地运行，并提供 Vercel 集成指令来添加聊天频道并将代理部署为 Web 服务。这是一个由 Vercel 支持、用于构建生产级 AI 代理的真正框架。