文档首页/ 智果（AgentArts）智能体平台/ API参考/ API/ 记忆库/ 长期记忆管理/ 更新记忆 - UpdateCoreSpaceMemory
更新时间：2026-11-09 GMT+08:00
查看PDF
分享

更新记忆 - UpdateCoreSpaceMemory

功能介绍

该接口用于更新指定记忆记录的内容或元数据，在需要修正已有记忆的内容、更新抽取元数据或自定义元数据时使用。

注意：

  • strategy_id、strategy_type 不可更新

  • 更新后会自动重新生成向量嵌入

调用方法

请参见如何调用API。

授权信息

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

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

agentarts:memorySpace:updateCoreSpaceMemory

Write

memorySpace *

g:ResourceTag/<tag-key>

-

-

-

  • agentarts:MemoryActorId

  • agentarts:MemorySessionId

URI

PUT /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字符。

默认取值：

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

content

否

String

参数解释：

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

约束限制：

不涉及。

取值范围：

长度1-16000字符。

默认取值：

不涉及。

meta

否

Object

参数解释：

用户自定义元数据。

约束限制：

不涉及。

取值范围：

长度0-4096字符。

默认取值：

不涉及。

响应参数

状态码：200

表3 响应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字符。

状态码：400

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

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

取值范围：

长度18-18字符。

error_msg

String

参数解释：

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

取值范围：

长度1-256字符。

状态码：401

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

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

取值范围：

长度18-18字符。

error_msg

String

参数解释：

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

取值范围：

长度1-256字符。

状态码：403

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

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

取值范围：

长度18-18字符。

error_msg

String

参数解释：

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

取值范围：

长度1-256字符。

encoded_authorization_message

String

参数解释：

编码后的授权失败信息。

取值范围：

长度1-4096字符。

details

Array of Error objects

参数解释：

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

取值范围：

不涉及。
表7 Error

参数

参数类型

描述

error_code

String

参数解释：

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

取值范围：

长度18-18字符。

error_msg

String

参数解释：

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

取值范围：

长度1-256字符。

状态码：404

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

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

取值范围：

长度18-18字符。

error_msg

String

参数解释：

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

取值范围：

长度1-256字符。

状态码：429

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

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

取值范围：

长度18-18字符。

error_msg

String

参数解释：

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

取值范围：

长度1-256字符。

encoded_authorization_message

String

参数解释：

编码后的授权失败信息。

取值范围：

长度1-4096字符。

details

Array of Error objects

参数解释：

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

取值范围：

不涉及。
表10 Error

参数

参数类型

描述

error_code

String

参数解释：

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

取值范围：

长度18-18字符。

error_msg

String

参数解释：

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

取值范围：

长度1-256字符。

状态码：500

表11 响应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

{
  "content" : "User prefers using Java for backend development",
  "meta" : {
    "fact" : "programming-language-preference-updated",
    "category" : "skills"
  }
}

响应示例

状态码：200

无

状态码：400

{
  "error_code" : "AgentArts.01020001",
  "error_msg" : "Invalid request parameters"
}

状态码：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" : "Record not found"
}

状态码：429

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

状态码：500

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

状态码

状态码

描述

200

更新成功

400

请求参数错误

401

认证失败

403

权限不足

404

记忆不存在

429

请求过于频繁

500

内部服务错误

错误码

请参见错误码。

父主题： 长期记忆管理

相关文档