Skip to main content
事实记忆

列出记忆

分页查看用户的所有事实记忆

分页列出指定子用户的记忆节点,可按记忆库和项目筛选。

请求方法与路径

GET https://dashscope.aliyuncs.com/api/v2/apps/memory/memory_nodes

请求参数

参数类型必填位置说明
user_idstring是Query子用户 ID,用于隔离记忆
memory_library_idstring否Query记忆库 ID
project_idstring否Query项目 ID
page_numinteger否Query页码,默认值为 1
page_sizeinteger否Query每页数量,默认值为 10

返回结果

字段类型说明
request_idstring请求 ID
memory_nodesarray记忆节点列表
memory_nodes[].memory_node_idstring记忆节点 ID
memory_nodes[].contentstring记忆内容
memory_nodes[].timestampinteger消息时间戳
memory_nodes[].created_atinteger创建时间
memory_nodes[].updated_atinteger更新时间
memory_nodes[].media_descstring多模态信息描述
memory_nodes[].meta_dataobject自定义元信息
memory_nodes[].project_idstring添加或更新时指定的项目 ID,可能为空
memory_nodes[].memory_typestring记忆节点类型
memory_nodes[].statusstring记忆节点状态
memory_nodes[].multimodal_mediasarray多模态资源,存在时返回
page_numinteger当前页码
page_sizeinteger每页数量
totalinteger记忆节点总数

请求示例

curl --location 'https://dashscope.aliyuncs.com/api/v2/apps/memory/memory_nodes?user_id=user_001&memory_library_id=memory_library_001&project_id=project_001&page_size=10&page_num=1' \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY"

响应示例

{
  "request_id": "c04d36e2-8fe8-9aad-b7ae-be40d5852c35",
  "memory_nodes": [
    {
      "memory_node_id": "4fe7ea3b791a4453b5e1d117da6b7483",
      "content": "用户后天要坐汽车去上海出差,记得带身份证",
      "timestamp": 1781765684,
      "created_at": 1781765715,
      "updated_at": 1781765715,
      "media_desc": "",
      "meta_data": {},
      "project_id": "project_001",
      "memory_type": "observation",
      "status": "valid",
      "multimodal_medias": []
    }
  ],
  "page_num": 1,
  "page_size": 10,
  "total": 1
}
修改记忆使用 UpdateMemory。
Managed Agents
Sandbox
Security
RAG
应用调用
ParseX
框架