更新时间:2026-11-09 GMT+08:00
分享

查询记忆详情 - ShowCoreSpaceMemory

功能介绍

该接口用于根据记忆 ID 获取指定长期记忆的详细信息,在需要查看某条记忆的内容、来源策略、隔离级别等完整属性时使用。

调用方法

请参见如何调用API。

授权信息

账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts:memorySpace:showCoreSpaceMemory

Read

memorySpace *

g:ResourceTag/<tag-key>

-

-

-

  • agentarts:MemoryActorId

  • agentarts:MemorySessionId

URI

GET /v1/core/spaces/{space_id}/memories/{memory_id}

表1 路径参数

参数

是否必选

参数类型

描述

space_id

是

String

参数解释:

Space ID是记忆空间的唯一标识,可通过"创建Space"获取。

约束限制:

不涉及。

取值范围:

UUID格式。示例:123e4567-e89b-12d3-a456-426614174001。

默认取值:

不涉及。

memory_id

是

String

参数解释:

Memory ID,用于唯一标识一条记忆记录,可通过"创建记忆"接口获取。

约束限制:

不涉及。

取值范围:

长度36-36字符。

默认取值:

不涉及。

请求参数

无

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

id

String

参数解释:

记忆记录 ID,唯一标识一条记忆记录,可通过"创建记忆"接口获取。

取值范围:

长度36-36字符。

space_id

String

参数解释:

所属 Space ID,标识该记录所属的记忆空间,可通过"创建Space"接口获取。

取值范围:

长度36-36字符。

strategy_id

String

参数解释:

来源策略 ID,标识该记忆记录由哪个策略生成,可通过"查询策略详情"接口获取。

取值范围:

长度36-36字符。

strategy_type

String

参数解释:

策略类型,决定记忆的存储和使用方式。

取值范围:

  • semantic: 语义记忆,用于存储语义化的信息

  • summary: 摘要记忆,用于对话总结

  • user_preference: 用户偏好,用于存储用户偏好设置

  • episodic: 事件记忆,用于存储特定事件

  • event: 事件记忆,与episodic相同,用于存储特定事件

  • custom: 自定义记忆,用于用户自定义的记忆类型

actor_id

String

参数解释:

归属 Actor ID,标识该记忆记录所属的 Actor,实现 Actor 级记忆隔离。

取值范围:

长度1-64字符。

assistant_id

String

参数解释:

归属 Assistant ID,标识该记录所属的 AI 助手。

取值范围:

长度1-64字符。

session_id

String

参数解释:

来源会话 ID,标识该记忆记录关联的会话,可通过"创建Session"接口获取,实现 Session 级记忆隔离。

取值范围:

长度1-64字符。

content

String

参数解释:

记忆内容,存储具体的记忆信息文本,如用户偏好、重要事实等。

取值范围:

长度1-16000字符。

memory_type

String

参数解释:

记忆类型,标识该记忆的分类。

取值范围:

  • memory: 一般记忆,用于存储一般的记忆信息

  • episode: 事件记忆,用于存储特定事件

  • reflection: 反思记忆,用于存储反思和总结

isolation_level

String

参数解释:

记忆隔离级别,决定记忆的共享范围。

取值范围:

  • actor: Actor 隔离,记忆只能在 Actor 内部共享

  • session: Session 隔离,记忆只能在 Session 内部共享

created_at

String

参数解释:

记录的创建时间,由系统自动生成。

取值范围:

格式为 ISO 8601(YYYY-MM-DDTHH:mm:ssZ)。

updated_at

String

参数解释:

记录的最近更新时间,由系统自动更新。

取值范围:

格式为 ISO 8601(YYYY-MM-DDTHH:mm:ssZ)。

meta

Object

参数解释:

用户自定义元数据。

取值范围:

长度0-4096字符。

状态码:401

表3 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.XXXXXXXX。

取值范围:

长度18-18字符。

error_msg

String

参数解释:

错误消息,描述错误详情,供问题排查使用。

取值范围:

长度1-256字符。

状态码:403

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.XXXXXXXX。

取值范围:

长度18-18字符。

error_msg

String

参数解释:

错误消息,描述错误详情,供问题排查使用。

取值范围:

长度1-256字符。

encoded_authorization_message

String

参数解释:

编码后的授权失败信息。

取值范围:

长度1-4096字符。

details

Array of Error objects

参数解释:

依赖的下游服务错误信息列表,包含导致当前请求失败的下游服务错误详情。

取值范围:

不涉及。

表5 Error

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.XXXXXXXX。

取值范围:

长度18-18字符。

error_msg

String

参数解释:

错误消息,描述错误详情,供问题排查使用。

取值范围:

长度1-256字符。

状态码:404

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.XXXXXXXX。

取值范围:

长度18-18字符。

error_msg

String

参数解释:

错误消息,描述错误详情,供问题排查使用。

取值范围:

长度1-256字符。

状态码:429

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.XXXXXXXX。

取值范围:

长度18-18字符。

error_msg

String

参数解释:

错误消息,描述错误详情,供问题排查使用。

取值范围:

长度1-256字符。

encoded_authorization_message

String

参数解释:

编码后的授权失败信息。

取值范围:

长度1-4096字符。

details

Array of Error objects

参数解释:

依赖的下游服务错误信息列表,包含导致当前请求失败的下游服务错误详情。

取值范围:

不涉及。

表8 Error

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.XXXXXXXX。

取值范围:

长度18-18字符。

error_msg

String

参数解释:

错误消息,描述错误详情,供问题排查使用。

取值范围:

长度1-256字符。

状态码:500

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.XXXXXXXX。

取值范围:

长度18-18字符。

error_msg

String

参数解释:

错误消息,描述错误详情,供问题排查使用。

取值范围:

长度1-256字符。

请求示例

/v1/core/spaces/123e4567-e89b-12d3-a456-426614174000/memories/456e7890-e89b-12d3-a456-426614174000

响应示例

状态码:200

无

状态码:401

{
  "error_code" : "AgentArts.01020002",
  "error_msg" : "Authentication failed"
}

状态码:403

{
  "error_code" : "AgentArts.01020003",
  "error_msg" : "Insufficient permissions"
}

状态码:404

{
  "error_code" : "AgentArts.01020005",
  "error_msg" : "Not found"
}

状态码:429

{
  "error_code" : "AgentArts.01020008",
  "error_msg" : "Too many requests"
}

状态码:500

{
  "error_code" : "AgentArts.01020004",
  "error_msg" : "Internal service error"
}

状态码

状态码

描述

200

成功获取记忆信息

401

认证失败

403

权限不足

404

记忆不存在

429

请求过于频繁

500

内部服务错误

错误码

请参见错误码。

相关文档