# 更新记忆空间相关配置 - UpdateCoreSpace
#### 功能介绍
更新记忆空间相关配置，涉及名称、策略等。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-agentarts/agentarts_07_0003.html)。
#### URI
PUT /v1/core/spaces/{space_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}$。 **默认取值：** 不涉及。 |
#### 请求参数
表2请求Body参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|:---|:---|:---|:---|
| name | 否 | String | **参数解释：** 记忆空间名称。 **约束限制：** 支持字母、数字和中划线。 **取值范围：** 长度1-48字符。 **默认取值：** 不涉及。 |
| description | 否 | String | **参数解释：** 记忆空间描述。 **约束限制：** 不涉及。 **取值范围：** 长度1-1000字符。 **默认取值：** 不涉及。 |
| message_ttl_hours | 否 | Integer | **参数解释：** 消息过期时间（小时）。 **约束限制：** 不涉及。 **取值范围：** 1-8760 **默认取值：** 不涉及。 |
| memory_extract_enabled | 否 | Boolean | **参数解释：** 是否开启记忆抽取。 **约束限制：** 不涉及。 **取值范围：** - true: 开启记忆抽取 - false: 关闭记忆抽取 **默认取值：** 不涉及。 |
| memory_extract_idle_seconds | 否 | Integer | **参数解释：** 触发记忆抽取空闲时间（秒）。 **约束限制：** 不涉及。 **取值范围：** 10-86400（24小时） **默认取值：** 不涉及。 |
| memory_extract_max_tokens | 否 | Integer | **参数解释：** 触发记忆抽取最大累计 token 数。 **约束限制：** 不涉及。 **取值范围：** 1000-1073741824 **默认取值：** 不涉及。 |
| memory_extract_max_messages | 否 | Integer | **参数解释：** 触发记忆抽取最大累计消息数。 **约束限制：** 不涉及。 **取值范围：** 3-10000 **默认取值：** 不涉及。 |
| tags | 否 | Array of [CoreSpaceTag] objects | **参数解释：** 库标签列表，用于对记忆空间进行分类和标识，每个标签由key和value组成。 **约束限制：** 数组长度0-20个；键最大长度36字符，不允许为空；值最大长度43字符，可以为空。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
| memory_strategies_builtin | 否 | Array of strings | **参数解释：** 内置策略类型列表。 **约束限制：** 数组长度0-10个。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
表3CoreSpaceTag
| 参数 | 是否必选 | 参数类型 | 描述 |
|:---|:---|:---|:---|
| key | 是 | String | **参数解释：** 标签键，用于标识标签的名称，最大长度128字符，不允许为空。 **约束限制：** 不允许为空；不能以空格开头或结尾；不能以"*sys*"开头。可用 UTF-8 格式表示的字母（包含中文、西班牙语、葡语等）、数字和空格，以及以下字符： _ . : / = + - @。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
| value | 是 | String | **参数解释：** 标签值，用于配合标签键标识标签的具体内容，最大长度255字符，可以为空。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
#### 响应参数
**状态码：200**
表4响应Body参数
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| id | String | **参数解释：** 记忆空间 ID，唯一标识一个记忆空间，可通过"创建Space"接口获取。 **取值范围：** 不涉及。 |
| name | String | **参数解释：** 记忆空间名称。 **取值范围：** 不涉及。 |
| description | String | **参数解释：** 记忆空间描述。 **取值范围：** 不涉及。 |
| message_ttl_hours | Integer | **参数解释：** 短期记忆过期时间（小时）。 **取值范围：** 不涉及。 |
| memory_extract_enabled | Boolean | **参数解释：** 是否开启长期记忆抽取。 **取值范围：** - true: 已开启 - false: 未开启 |
| memory_extract_idle_seconds | Integer | **参数解释：** 长期记忆抽取空闲时间（秒）。 **取值范围：** 不涉及。 |
| memory_extract_max_tokens | Integer | **参数解释：** 长期记忆抽取最大累计 token 数。 **取值范围：** 不涉及。 |
| memory_extract_max_messages | Integer | **参数解释：** 长期记忆抽取最大累计 message 数。 **取值范围：** 不涉及。 |
| memory_strategies_builtin | Array of [CoreSpaceBuiltinMemoryStrategy] objects | **参数解释：** 内置策略列表。 **取值范围：** 不涉及。 |
| memory_strategies_customized | Array of [CoreSpaceMemoryStrategy] objects | **参数解释：** 该记忆空间关联的用户自定义记忆策略列表（完整数据）。 **取值范围：** 不涉及。 |
| vpc_id | String | **参数解释：** 租户 VPC ID，获取方式：[查询VPC列表](https://support.huaweicloud.com/api-vpc/vpc_apiv3_0003.html)。 **取值范围：** 不涉及。 |
| subnet_id | String | **参数解释：** 租户子网 ID，获取方式：[查询子网列表](https://support.huaweicloud.com/api-vpc/vpc_subnet01_0003.html)。 **取值范围：** 不涉及。 |
| private_access | [CoreSpaceNetwork] object | **参数解释：** 网络访问信息（公网或内网）。 **取值范围：** 不涉及。 |
| public_access | [CoreSpaceNetwork] object | **参数解释：** 网络访问信息（公网或内网）。 **取值范围：** 不涉及。 |
| api_key | [ShowCoreSpaceApiKeyResponseBody] object | **参数解释：** Space 关联的 API Key 脱敏信息。 **取值范围：** 不涉及。 |
| encryption_config | [EncryptionConfig] object | **参数解释：** Space 加密配置，使用KMS密钥对Space数据进行加密。 **取值范围：** KMS 密钥ID。 |
| tags | Array of [CoreSpaceTag] objects | **参数解释：** 库标签列表。 **取值范围：** 不涉及。 |
| status | String | **参数解释：** Space 状态。 **取值范围：** - creating: 创建中 - running: 运行中 - deleted: 已删除 - create_failed: 创建失败 |
| created_at | String | **参数解释：** 记录的创建时间，由系统自动生成，格式为 ISO 8601（YYYY-MM-DDTHH:mm:ssZ）。 **取值范围：** 不涉及。 |
| updated_at | String | **参数解释：** 记录的最近更新时间，由系统自动更新，格式为 ISO 8601（YYYY-MM-DDTHH:mm:ssZ）。 **取值范围：** 不涉及。 |
表5CoreSpaceBuiltinMemoryStrategy
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| id | String | **参数解释：** 策略 ID，唯一标识一个记忆策略。 **取值范围：** 不涉及。 |
| name | String | **参数解释：** 策略名称，用于标识和区分不同的记忆策略。 **取值范围：** 不涉及。 |
| type | String | **参数解释：** 策略类型，决定记忆策略的处理方式和执行流程。 - **semantic**：语义记忆提取（extraction → consolidation） - **user_preference**：用户偏好提取（extraction → consolidation） - **summary**：会话摘要生成（consolidation） - **episodic**：情景记忆提取（extraction → consolidation → reflection） **取值范围：** 不涉及。 |
| steps | Array of [CoreSpaceBuiltinMemoryStrategyStep] objects | **参数解释：** 策略步骤列表，按 step_order 顺序执行。 **取值范围：** 不涉及。 |
表6CoreSpaceBuiltinMemoryStrategyStep
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| step_order | Integer | **参数解释：** 步骤执行顺序（从 1 开始）。 **取值范围：** 不涉及。 |
| step_type | String | **参数解释：** 步骤类型，决定记忆策略中该步骤的执行逻辑。 **取值范围：** - extraction: 提取 - consolidation: 合并 - reflection: 反思 |
| isolation_level | String | **参数解释：** 隔离级别。 **取值范围：** - actor: 按用户隔离记忆 - session: 按会话隔离 - null: step_type=extraction时，isolation_level=null |
| instruction | String | **参数解释：** 步骤指令（Prompt 模板）。 **取值范围：** 不涉及。 |
| output_schema | String | **参数解释：** 输出格式模板。 **取值范围：** 不涉及。 |
表7CoreSpaceMemoryStrategy
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| 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）。 **取值范围：** 不涉及。 |
表8CoreSpaceMemoryStrategyStep
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| 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）。 **取值范围：** 不涉及。 |
表9CoreSpaceNetwork
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| domain_name | String | **参数解释：** 访问域名。 **取值范围：** 不涉及。 |
| ip | String | **参数解释：** IP 地址。 **取值范围：** 不涉及。 |
表10ShowCoreSpaceApiKeyResponseBody
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| id | String | **参数解释：** API Key ID。 **取值范围：** 不涉及。 |
| masked_key | String | **参数解释：** 脱敏后的 API Key。 **取值范围：** 不涉及。 |
表11EncryptionConfig
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| key_id | String | **参数解释：** KMS 密钥 ID，获取方式：通过KMS服务控制台或查询密钥列表接口获取。 **取值范围：** 不涉及。 |
表12CoreSpaceTag
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| key | String | **参数解释：** 标签键，用于标识标签的名称，最大长度128字符，不允许为空。 **取值范围：** 不涉及。 |
| value | String | **参数解释：** 标签值，用于配合标签键标识标签的具体内容，最大长度255字符，可以为空。 **取值范围：** 不涉及。 |
**状态码：400**
表13响应Body参数
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 |
| error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 |
**状态码：401**
表14响应Body参数
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 |
| error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 |
**状态码：403**
表15响应Body参数
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.XXXXXXXX。 **取值范围：** 不涉及。 |
| error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 |
| encoded_authorization_message | String | **参数解释：** 编码后的授权失败信息。 **取值范围：** 不涉及。 |
| details | Array of [CoreSpaceCommonError] objects | **参数解释：** 依赖的下游服务错误信息列表，包含导致当前请求失败的下游服务错误详情。 **取值范围：** 不涉及。 |
表16CoreSpaceCommonError
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 |
| error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 |
**状态码：404**
表17响应Body参数
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 |
| error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 |
**状态码：429**
表18响应Body参数
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 |
| error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 |
**状态码：500**
表19响应Body参数
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 |
| error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 |
#### 请求示例
```
/v1/core/spaces/123e4567-e89b-12d3-a456-426614174000
{
"name" : "string",
"description" : "string",
"message_ttl_hours" : 1,
"memory_extract_enabled" : false,
"memory_extract_idle_seconds" : 10,
"memory_extract_max_tokens" : 1000,
"memory_extract_max_messages" : 3,
"tags" : [ {
"key" : "Environment",
"value" : "production"
} ],
"memory_strategies_builtin" : [ "semantic", "user_preference" ]
}
```
#### 响应示例
**状态码：200**
更新成功
```
{
"id" : "123e4567-e89b-12d3-a456-426614174000",
"name" : "space-01",
"description" : "test-environment",
"message_ttl_hours" : 168,
"memory_extract_enabled" : true,
"memory_extract_idle_seconds" : 60,
"memory_extract_max_tokens" : 10000,
"memory_extract_max_messages" : 100,
"memory_strategies_builtin" : [ {
"name" : "semantic-memory",
"type" : "semantic",
"steps" : [ {
"step_order" : 1,
"step_type" : "extraction",
"isolation_level" : null,
"instruction" : "You are a long-term memory extraction agent supporting a lifelong learning system. Your task is to identify and extract meaningful information about the users from a given list of messages. ...(truncated)",
"output_schema" : "{...SemanticMemory schema...}\n\n{messages}\n"
}, {
"step_order" : 2,
"step_type" : "consolidation",
"isolation_level" : "actor",
"instruction" : "You are a conservative memory manager that preserves existing information while carefully integrating new facts. Operations: AddMemory, UpdateMemory, SkipMemory. ...(truncated)",
"output_schema" : "\n{new_content}\n\n\n{historical_memories}\n"
} ]
} ],
"memory_strategies_customized" : [ {
"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"
} ],
"vpc_id" : "string",
"subnet_id" : "string",
"private_access" : {
"domain_name" : "123e4567-e89b-12d3-a456-426614174000.cn-north-4.memory.agentarts.myhuawei.com",
"ip" : "120.46.xxx.xxx"
},
"public_access" : {
"domain_name" : "123e4567-e89b-12d3-a456-426614174000.cn-north-4.memory.agentarts.myhuawei.com",
"ip" : "120.46.xxx.xxx"
},
"api_key" : {
"id" : "key-uuid",
"masked_key" : "sk-***1234"
},
"tags" : [ {
"key" : "Environment",
"value" : "production"
} ],
"status" : "creating",
"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)。