文档中心

记忆库 Mem0

记忆管理

获取全部记忆

GET https://<your_mem0_host>/v1/memories/

用于根据用户、智能体或运行 ID，查询并返回所有相关记忆。

鉴权

本接口采用 API Key 鉴权。具体操作，请参见请求说明 - 鉴权。

请求参数

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 可选示例值：prj_a1b2c3d4e5f67890

项目 ID。

说明

如果提供，将与 API Key 所属的项目 ID 进行校验。

page Integer 可选示例值：1

页码，从 1 开始。

返回参数

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.08.04 14:48:25

这个页面对您有帮助吗？

有用

无用