vesta 是做什么的?
一个为长时间运行的智能体设计的Agent宿主,支持记忆、延续以及从实际工作中学习。
概述
Vesta 是一个轻量级的 Agent 宿主框架,旨在解决 AI Agent 在长期任务中面临的关键挑战——上下文丢失、任务中断以及缺乏学习能力。通过 Vesta,Agent 可以无缝地在多个会话中保持状态,从上次中断的地方继续,并从历史交互中提取教训以改进未来表现。
核心特性
- 持久化记忆:自动保存 Agent 的会话状态、决策记录和中间结果到本地存储或数据库。
- 工作延续:支持 Agent 在重启后自动恢复上次的工作上下文,无需重复相同的对话或配置。
- 经验学习:记录成功和失败的案例,Agent 可以在后续任务中参考这些经验,优化策略。
- 平台无关:兼容 Claude Code、Cursor、Codex 等主流 Agent 环境,通过适配器轻松集成。
- 可扩展插件:提供插件 API,允许开发者自定义记忆存储后端、日志格式和重放策略。
快速开始
安装
npm install @kong-lh-rgb/vesta
基本用法
在你的 Agent 工作流中引入 Vesta:
import { Vesta } from '@kong-lh-rgb/vesta';
const agent = new Vesta({
name: 'my-agent',
storage: 'filesystem', // 可选: 'filesystem', 'sqlite', 'memory'
memoryPath: './vesta-memory'
});
await agent.start();
恢复工作
在后续的会话中,Agent 会自动检查之前的记忆:
const agent = new Vesta({ name: 'my-agent' });
const previousSession = await agent.load();
if (previousSession) {
console.log('已恢复上次的工作上下文:', previousSession.context);
}
配置选项
| 参数 | 类型 | 默认值 | 描述 |
|---|---|---|---|
name | string | 必填 | Agent 的唯一标识,用于区分不同的工作流 |
storage | string | 'filesystem' | 记忆存储后端,支持 filesystem、sqlite、memory |
memoryPath | string | './vesta-memory' | 持久化记忆的存储路径 |
autoSave | boolean | true | 是否在每个步骤后自动保存状态 |
learning | boolean | false | 是否启用经验学习功能 |
经验学习
启用 learning 后,Vesta 会记录每次交互的结果,并在下一次任务中提供上下文建议:
const agent = new Vesta({ name: 'my-agent', learning: true });
const lessons = await agent.getLessons();
console.log('从历史任务中学到的经验:', lessons);
平台支持
Vesta 通过适配器模式支持以下 AI Agent 平台:
- Claude Code:通过
ClaudeCodeAdapter适配 Claude 的对话 API。 - Cursor:通过
CursorAdapter适配 Cursor 的编辑和生成 API。 - Codex:通过
CodexAdapter适配 OpenAI Codex 的补全 API。 - 自定义平台:实现
Adapter接口即可集成到任何 Agent 环境。
架构概览
Vesta 采用三层架构:
- 适配层:负责与不同 Agent 平台通信。
- 核心层:管理记忆存储、状态恢复和经验学习。
- 存储层:提供可插拔的持久化后端。
贡献指南
欢迎贡献!请阅读 CONTRIBUTING.md 了解如何开始。所有 PR 必须包含测试和文档更新。
许可
MIT License