app-platform-memory
模块概述
app-platform-memory 是一个记忆管理模块，为 AI Agent 提供短期、长期和工作记忆的管理能力。
功能特性
-
多类型记忆支持：
- 短期记忆 (short_term): 用于临时存储对话上下文
- 长期记忆 (long_term): 持久化存储重要信息
- 工作记忆 (working): 当前任务相关的活跃记忆
-
记忆管理功能：
- 创建、更新、删除记忆
- 记忆搜索和检索
- 自动归档过期记忆
- 重要性评分机制
- 访问频率统计
-
API 支持：
- RESTful API 接口
- Web 管理界面
- SDK 集成
子模块说明
app-platform-memory-spec: 规范定义和常量app-platform-memory-sdk: SDK 和 DTO 定义app-platform-memory-domain: 领域模型和仓储接口app-platform-memory-application: 应用服务层app-platform-memory-infra: 基础设施实现app-platform-memory-api: RESTful API 接口app-platform-memory-web: Web 管理界面
使用方式
添加依赖
在需要使用记忆功能的模块中添加依赖：
<dependency>
<groupId>com.xspaceagi</groupId>
<artifactId>app-platform-memory-sdk</artifactId>
<version>1.0.0-SNAPSHOT</version>
</dependency>
API 调用示例
创建记忆
POST /api/memory
Content-Type: application/json
{
"memoryType": "short_term",
"content": "用户偏好设置",
"metadata": {
"userId": "user123",
"sessionId": "session456"
}
}
查询记忆
GET /api/memory/user/{userId}/type/{memoryType}
搜索记忆
GET /api/memory/search?userId={userId}&keyword={keyword}
配置说明
默认配置
- 短期记忆最大容量: 100 条
- 工作记忆最大容量: 50 条
- 长期记忆转换阈值: 7 天
自定义配置
可以在配置文件中覆盖默认值：
memory:
short-term:
max-size: 200
working:
max-size: 100
long-term:
threshold-days: 14
技术栈
- Java 17
- Spring Boot
- Lombok
- Maven
开发指南
构建项目
mvn clean install
运行测试
mvn test
版本历史
- v1.0.0-SNAPSHOT: 初始版本，提供基础记忆管理功能