Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
以编程方式访问与管理 Agent 记忆。
GET /api/memory?type=semantic&page=1&page_size=20&sort_by=created_at&sort_order=desc&tag=python
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
type | string | 全部 | 记忆类型过滤: semantic, episodic, procedural, conversation, task_digest |
page | int | 1 | 页码（从 1 开始） |
page_size | int | 20 | 每页条数（最大 100） |
sort_by | string | created_at | 排序字段: created_at, updated_at, importance |
sort_order | string | desc | 排序方向: asc 或 desc |
tag | string | — | 按标签过滤（不区分大小写） |
search | string | — | 语义搜索查询（使用向量相似度） |
{
"items": [...],
"total": 91,
"page": 1,
"page_size": 20,
"has_next": true,
"has_prev": false
}
GET /api/memory/tags?limit=20
POST /api/memory/search
{
"query": "user preferences for coding style",
"limit": 10,
"expand_conversation_id": "chat-xxx",
"expand_message_id": "msg-yyy",
"expand_window": 5
}
expand_* 时以 700 字符高密度摘要快速定位；传入 expand_conversation_id、expand_message_id 与 expand_window（1-20，默认 5）后动态放宽至 4000 字符长文本多轮上下文。
POST /api/memory
{
"type": "semantic",
"content": "User prefers TypeScript with strict mode",
"importance": 0.8
}
DELETE /api/memory/:id
GET /api/v1/memory/command-center?project_id=<可选>
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
project_id | string | — | 可选的项目 ID，用于将快照范围限定为单个项目的记忆空间 |
project_id 时，spaces、governance 和 timeline 部分仅显示与该项目 SharedContext 绑定相关的数据。空字符串会被自动归一化为全局视图。
GET /api/v1/statistics/learning-timeline?kind=all&limit=30&before_timestamp=1724150400000
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
kind | string | all | 节点类型筛选：all, memory, skill, user_rule |
limit | int | 30 | 单次拉取数量（1-100） |
before_timestamp | int | — | 游标时间戳（毫秒），用于向前分页 |
{
"items": [
{
"id": "mem_123",
"kind": "fact",
"title": "TypeScript 编码偏好",
"content": "用户偏好使用严格的 TypeScript 类型检查与纯函数",
"timestamp": 1724150400000,
"source": "memory",
"importance": 0.9,
"is_user_locked": true,
"confidence": 0.95
}
],
"has_more": true,
"next_cursor": 1724140000000,
"total_count": 42
}
PUT /api/v1/statistics/learning-timeline/memory/:type/:id
{
"content": "修改后的规则正文",
"importance": 0.9,
"reasoning": "用户在时间线编辑器中显式纠错",
"is_user_locked": true
}
DELETE /api/v1/statistics/learning-timeline/memory/:id?memory_type=semantic
POST /api/v1/statistics/learning-timeline/skill/:id/archive
{
"archived": true
}