文档首页/ 智果（AgentArts）智能体平台/ API参考/ API/ 记忆库/ 记忆策略管理/ 更新自定义记忆策略 - UpdateCoreSpaceCustomizedStrategy
更新时间：2026-06-10 GMT+08:00
查看PDF
分享

更新自定义记忆策略 - UpdateCoreSpaceCustomizedStrategy

功能介绍

更新指定Space下的自定义记忆策略配置。

调用方法

请参见如何调用API。

URI

PUT /v1/core/spaces/{space_id}/strategies/customized/{strategy_id}

表1 路径参数

参数

是否必选

参数类型

描述

space_id

是

String

参数解释：

记忆空间 ID，唯一标识一个记忆空间，可通过"创建Space"接口获取。

约束限制：

仅支持字母、数字和中划线。

取值范围：

长度1-48字符。

默认取值：

不涉及。

strategy_id

是

String

参数解释：

记忆策略 ID，唯一标识一个记忆策略，可通过"创建自定义策略"或"列出策略"接口获取。

约束限制：

仅支持字母、数字和中划线。

取值范围：

长度1-48字符。

默认取值：

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

name

否

String

参数解释：

策略名称，用于标识和区分不同的记忆策略。

约束限制：

仅支持字母、数字和中划线。

取值范围：

长度1-48字符。

默认取值：

不涉及。

steps

是

Array of CoreSpaceMemoryStrategyStepRequestBody objects

参数解释：

更新已有步骤。

约束限制：

数组长度0-20个。

取值范围：

不涉及。

默认取值：

不涉及。
表3 CoreSpaceMemoryStrategyStepRequestBody

参数

是否必选

参数类型

描述

step_order

是

Integer

参数解释：

步骤执行顺序，从 1 开始。

约束限制：

不涉及。

取值范围：

1-20

默认取值：

不涉及。

instruction

否

String

参数解释：

步骤指令（Prompt 模板）。

约束限制：

长度不超过50000字符。

取值范围：

长度0-50000字符。

默认取值：

不传使用默认模板。

响应参数

状态码：200

策略更新成功

状态码：400

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

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

取值范围：

不涉及。

error_msg

String

参数解释：

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

取值范围：

不涉及。

状态码：401

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

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

取值范围：

不涉及。

error_msg

String

参数解释：

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

取值范围：

不涉及。

状态码：403

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

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

取值范围：

不涉及。

error_msg

String

参数解释：

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

取值范围：

不涉及。

encoded_authorization_message

String

参数解释：

编码后的授权失败信息。

取值范围：

不涉及。

details

Array of CoreSpaceCommonError objects

参数解释：

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

取值范围：

不涉及。
表7 CoreSpaceCommonError

参数

参数类型

描述

error_code

String

参数解释：

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

取值范围：

不涉及。

error_msg

String

参数解释：

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

取值范围：

不涉及。

状态码：404

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

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

取值范围：

不涉及。

error_msg

String

参数解释：

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

取值范围：

不涉及。

状态码：429

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

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

取值范围：

不涉及。

error_msg

String

参数解释：

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

取值范围：

不涉及。

状态码：500

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

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

取值范围：

不涉及。

error_msg

String

参数解释：

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

取值范围：

不涉及。

请求示例

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

{
  "steps" : [ {
    "step_order" : 1,
    "instruction" : "Extract user preferences from the following conversation..."
  } ],
  "name" : "custom-semantic-memory-strategy"
}

响应示例

状态码：200

策略更新成功

{
  "id" : "456e7890-e89b-12d3-a456-426614174000",
  "name" : "user_preference_strategy",
  "type" : "user_preference",
  "origin_type" : "user",
  "steps" : [ {
    "id" : "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "step_order" : 1,
    "step_type" : "extraction",
    "isolation_level" : "actor",
    "instruction" : "string",
    "output_schema" : "string",
    "enabled" : true,
    "created_at" : "2025-01-18T10:00:00.000Z",
    "updated_at" : "2025-01-18T10:00:00.000Z"
  } ],
  "created_at" : "2025-01-18T10:00:00.000Z",
  "updated_at" : "2025-01-18T10:00:00.000Z"
}

状态码：400

请求参数错误

{
  "error_code" : "AgentArts.01010001",
  "error_msg" : "Invalid request parameter format"
}

状态码：401

认证失败

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

状态码：403

内置策略不允许修改

{
  "error_code" : "AgentArts.01010003",
  "error_msg" : "Built-in strategy cannot be modified"
}

状态码：404

Space或策略不存在

{
  "error_code" : "AgentArts.01010006",
  "error_msg" : "Specified strategy does not exist"
}

状态码：429

请求过于频繁

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

状态码：500

内部服务错误

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

状态码

状态码

描述

200

策略更新成功

400

请求参数错误

401

认证失败

403

内置策略不允许修改

404

Space或策略不存在

429

请求过于频繁

500

内部服务错误

错误码

请参见错误码。

父主题： 记忆策略管理

相关文档