# 更新自定义记忆策略 - UpdateCoreSpaceCustomizedStrategy #### 功能介绍 更新指定Space下的自定义记忆策略配置。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-agentarts/agentarts_07_0003.html)。 #### URI PUT /v1/core/spaces/{space_id}/strategies/customized/{strategy_id} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | space_id | 是 | String | **参数解释：** Space ID，唯一标识一个Space，可以通过AgentArts智能体记忆库控制台或者记忆库查询接口获取。 **约束限制：** 不涉及。 **取值范围：** 匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），符合正则条件\^\[0-9a-f\]{8}-\[0-9a-f\]{4}-\[0-9a-f\]{4}-\[0-9a-f\]{4}-\[0-9a-f\]{12}$。 **默认取值：** 不涉及。 | | strategy_id | 是 | String | **参数解释：** 记忆策略 ID，唯一标识一个记忆策略，可通过"创建自定义策略"或"列出策略"接口获取。 **约束限制：** 不涉及。 **取值范围：** 匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），符合正则条件\^\[0-9a-f\]{8}-\[0-9a-f\]{4}-\[0-9a-f\]{4}-\[0-9a-f\]{4}-\[0-9a-f\]{12}$。 **默认取值：** 不涉及。 | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 否 | String | **参数解释：** 策略名称，用于标识和区分不同的记忆策略。 **约束限制：** 不涉及。 **取值范围：** 只能由字母、数字和中划线组成，长度1-48字符。 **默认取值：** 不涉及。 | | steps | 是 | Array of [CoreSpaceMemoryStrategyStepRequestBody] objects | **参数解释：** 记忆策略步骤列表，用于定义策略的执行流程。每个步骤为CoreSpaceMemoryStrategyStepRequestBody对象，包含步骤执行顺序、步骤类型和执行指令等信息。更新时采用全量替换语义，传入的steps将完全替代现有步骤。 **约束限制：** 数组长度0-20个。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | 表3CoreSpaceMemoryStrategyStepRequestBody | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | step_order | 是 | Integer | **参数解释：** 步骤执行顺序，从 1 开始。 **约束限制：** - steps 数组长度必须与所选 strategy_type 的内置模板步数一致： - step_order 不可重复，且顺序须与模板一致。 - 每个 step 仅可自定义 instruction，其余属性继承自内置模板 semantic: 2步, summary: 1步, user_preference: 2步, episodic: 3步。 **取值范围：** 1-20 **默认取值：** 不涉及。 | | instruction | 否 | String | **参数解释：** 步骤指令（Prompt 模板）。 **约束限制：** 不涉及。 **取值范围：** 支持中文字符、英文字母、数字及常用标点符号，长度0-50000字符。 **默认取值：** 不传使用默认模板，可通过获取内置记忆策略列表接口查看默认模板内容。 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 策略 ID。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 策略名称。 **取值范围：** 不涉及。 | | type | String | **参数解释：** 策略类型。 当前包含 4 种内置策略： - **semantic**：语义记忆提取（extraction → consolidation） - **user_preference**：用户偏好提取（extraction → consolidation） - **summary**：会话摘要生成（consolidation） - **episodic**：情景记忆提取（extraction → consolidation → reflection） **取值范围：** 不涉及。 | | origin_type | String | **参数解释：** 策略来源类型。 **取值范围：** - builtin: 系统内置 - user: 用户自定义 | | steps | Array of [CoreSpaceMemoryStrategyStep] objects | **参数解释：** 策略步骤列表。 **取值范围：** 0-20个。 | | created_at | String | **参数解释：** 创建时间，格式为 ISO 8601（YYYY-MM-DDTHH:mm:ssZ）。 **取值范围：** 不涉及。 | | updated_at | String | **参数解释：** 更新时间，格式为 ISO 8601（YYYY-MM-DDTHH:mm:ssZ）。 **取值范围：** 不涉及。 | 表5CoreSpaceMemoryStrategyStep | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 步骤 ID。 **取值范围：** 不涉及。 | | step_order | Integer | **参数解释：** 步骤执行顺序。 **取值范围：** 不涉及。 | | step_type | String | **参数解释：** 步骤类型。 **取值范围：** - extraction: 提取 - consolidation: 合并 - reflection: 反思 | | isolation_level | String | **参数解释：** 隔离级别。 **取值范围：** - actor: 按用户隔离 - session: 按会话隔离 - null: step_type=extraction时，isolation_level=null | | instruction | String | **参数解释：** 步骤指令。 **取值范围：** 不涉及。 | | output_schema | String | **参数解释：** 输出格式模板。 **取值范围：** 不涉及。 | | enabled | Boolean | **参数解释：** 是否启用。 **取值范围：** 不涉及。 | | created_at | String | **参数解释：** 创建时间，格式为 ISO 8601（YYYY-MM-DDTHH:mm:ssZ）。 **取值范围：** 不涉及。 | | updated_at | String | **参数解释：** 更新时间，格式为 ISO 8601（YYYY-MM-DDTHH:mm:ssZ）。 **取值范围：** 不涉及。 | **状态码：400** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 | | error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 | **状态码：401** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 | | error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 | **状态码：403** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.XXXXXXXX。 **取值范围：** 不涉及。 | | error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 | | encoded_authorization_message | String | **参数解释：** 编码后的授权失败信息。 **取值范围：** 不涉及。 | | details | Array of [CoreSpaceCommonError] objects | **参数解释：** 依赖的下游服务错误信息列表，包含导致当前请求失败的下游服务错误详情。 **取值范围：** 不涉及。 | 表9CoreSpaceCommonError | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 | | error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 | **状态码：404** 表10响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 | | error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 | **状态码：429** 表11响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 | | error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 | **状态码：500** 表12响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 | | 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" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 策略更新成功 | | 400 | 请求参数错误。 | | 401 | 认证失败。 | | 403 | 权限不足。 | | 404 | 记忆库未找到 | | 429 | 请求频率超限。 | | 500 | 内部服务器错误 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。