记忆库 Mem0
记忆库 Mem0
文档指南
请输入
- 文档首页
记忆库 Mem0数据面 API 参考记忆管理获取全部记忆
复制全文
下载 pdf获取全部记忆
文档反馈
问问助手GET https://<your_mem0_host>/v1/memories/
用于根据用户、智能体或运行 ID，查询并返回所有相关记忆。
鉴权
请求参数
Query 参数
user_id String 条件必选 示例值：user-12345
用户标识符。
注意
user_id、agent_id、run_id 至少需要提供一个。
agent_id String 条件必选 示例值：agent-001
智能体标识符。
注意
user_id、agent_id、run_id 至少需要提供一个。
run_id String 条件必选 示例值：run-abc123
单次运行标识符。
注意
user_id、agent_id、run_id 至少需要提供一个。
project_id String 可选 示例值：mp-shwobtu3ljcundz1si9d98jmvho8
项目 ID。
说明
如果提供，将与 API Key 所属的项目 ID 进行校验。
page Integer 可选 示例值：1
页码，从 1 开始。
说明
- 需将 page 与 page_size 配合使用以分页拉取数据。例如：请求 page=1&page_size=100 获取前 100 条数据；请求 page=2&page_size=100 获取第 101~200 条数据。
- 如果某次返回的数据条数少于 page_size，或者没有返回任何数据，说明数据已全部拉取完毕，请停止翻页。
page_size Integer 可选 示例值：10
每页返回条数。默认值：1000；最大值：1000。
说明
- 需将 page 与 page_size 配合使用以分页拉取数据。例如：请求 page=1&page_size=100 获取前 100 条数据；请求 page=2&page_size=100 获取第 101~200 条数据。
- 如果某次返回的数据条数少于 page_size，或者没有返回任何数据，说明数据已全部拉取完毕，请停止翻页。
返回参数
results Array[FullMemoryItem]
记忆项列表。
id String 示例值：mem_0987654321fedcba
记忆 ID。
memory String 示例值：用户计划下周去北京出差，需要推荐烤鸭店。
记忆内容。
hash String 示例值：abcde12345...
记忆内容哈希值。
metadata Object 示例值：{"source": "trip_planner_chat"}
记忆元数据。
created_at String 示例值：2026-01-07T10:00:00Z
创建时间，ISO 8601 格式。
updated_at String 示例值：2026-01-07T10:00:00Z
最后更新时间，ISO 8601 格式。
user_id String 示例值：user-12345
关联用户 ID。
agent_id String 示例值：agent-001
关联智能体 ID。
run_id String 示例值：run-abc123
关联运行 ID。
relations Array[GraphItem]
记忆之间的关系图谱列表（如有）。
source String 示例值：用户
关系图中源节点。
relationship String 示例值：计划前往
节点间的关系描述。
destination String 示例值：北京
关系图中目标节点。
输入示例 1
输入示例
curl -X GET 'https://<your_mem0_host>/v1/memories/?user_id=user-1xxxx' \
-H 'Authorization: Token <YOUR_PERSONAL_API_KEY>'输出示例
{
"results": [
{
"id": "mem_0987654321fexxxx",
"memory": "用户计划下周去北京出差，需要推荐烤鸭店。",
"hash": "abcde12345...",
"metadata": {
"source": "trip_planner_chat"
},
"created_at": "2026-01-07T10:00:00Z",
"updated_at": "2026-01-07T10:00:00Z",
"user_id": "user-1xxxx",
"run_id": null,
"agent_id": null
}
],
"relations": []
}最近更新时间：2026.11.05 17:43:02
这个页面对您有帮助吗？
有用
有用
无用
无用