# 创建Space - CreateCoreSpace
#### 功能介绍
创建新的记忆空间，用于存放某一类业务的短长期记忆数据，包括访问方式、抽取策略、密钥绑定等相关配置。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-agentarts/agentarts_07_0003.html)。
#### URI
POST /v1/core/spaces
#### 请求参数
表1请求Body参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|:---|:---|:---|:---|
| name | 是 | String | **参数解释：** 空间名称。 **约束限制：** 仅支持字母、数字和中划线。 **取值范围：** 长度1-48字符。 **默认取值：** 不涉及。 |
| description | 否 | String | **参数解释：** 空间描述。 **约束限制：** 不涉及。 **取值范围：** 支持中文字符、英文字母、数字及常用标点符号，长度1-1000字符。 **默认取值：** 不涉及。 |
| api_key_id | 是 | String | **参数解释：** 空间访问Key，获取方式：通过创建API Key的接口返回获取。 **约束限制：** 不涉及。 **取值范围：** 由英文字母、数字和中划线组成，长度1-2048字符。 **默认取值：** 不涉及。 |
| message_ttl_hours | 是 | Integer | **参数解释：** 过期时间（小时）。 **约束限制：** 不涉及。 **取值范围：** 1-8760 h。 **默认取值：** 168。 |
| memory_extract_idle_seconds | 否 | Integer | **参数解释：** 触发记忆抽取的空闲时间（秒)。 **约束限制：** 不涉及。 **取值范围：** 10-86400 s。 **默认取值：** 不涉及。 |
| memory_extract_max_tokens | 否 | Integer | **参数解释：** 触发记忆抽取最大累计token数。 **约束限制：** 不涉及。 **取值范围：** 1000-1073741824 tokens。 **默认取值：** 不涉及。 |
| memory_extract_max_messages | 否 | Integer | **参数解释：** 触发记忆抽取最大累计message数。 **约束限制：** 不涉及。 **取值范围：** 3-10000 条。 **默认取值：** 不涉及。 |
| tags | 否 | Array of [CoreSpaceTag] objects | **参数解释：** 库标签列表。 **约束限制：** 数组长度0-20个；键最大长度36字符，不允许为空；值最大长度43字符，可以为空。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
| memory_strategies_builtin | 否 | Array of strings | **参数解释：** 内置策略类型列表，与memory_strategies_customized至少选填一项。 当前包含 4 种内置策略： - **semantic**：语义记忆提取（extraction → consolidation） - **user_preference**：用户偏好提取（extraction → consolidation） - **summary**：会话摘要生成（consolidation） - **episodic**：情景记忆提取（extraction → consolidation → reflection） **约束限制：** 与memory_strategies_customized至少选填一项，数组长度0-10个。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
| memory_strategies_customized | 否 | Array of [CreateCoreSpaceMemoryStrategyRequestBody] objects | **参数解释：** 长期记忆自定义策略。 **约束限制：** 与memory_strategies_builtin至少选填一项；单个记忆空间最多配置10个。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
| network_access | 否 | [CreateCoreSpaceNetworkRequestBody] object | **参数解释：** Space 网络访问配置，公网和私网至少填写一个。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
| encryption_config | 否 | [EncryptionConfig] object | **参数解释：** Space 加密配置，使用KMS密钥对Space数据进行加密。 **约束限制：** 仅支持对称密钥。 **取值范围：** KMS 密钥ID。 **默认取值：** 无 |
表2CoreSpaceTag
| 参数 | 是否必选 | 参数类型 | 描述 |
|:---|:---|:---|:---|
| key | 是 | String | **参数解释：** 标签键，用于标识标签的名称，最大长度128字符，不允许为空。 **约束限制：** 不允许为空；不能以空格开头或结尾；不能以"*sys*"开头。可用 UTF-8 格式表示的字母（包含中文、西班牙语、葡语等）、数字和空格，以及以下字符： _ . : / = + - @。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
| value | 是 | String | **参数解释：** 标签值，用于配合标签键标识标签的具体内容，最大长度255字符，可以为空。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
表3CreateCoreSpaceMemoryStrategyRequestBody
| 参数 | 是否必选 | 参数类型 | 描述 |
|:---|:---|:---|:---|
| name | 是 | String | **参数解释：** 策略名。 **约束限制：** 不涉及。 **取值范围：** 只能由字母、数字和中划线组成，长度1-48字符。 **默认取值：** 不涉及。 |
| type | 是 | String | **参数解释：** 策略类型，决定记忆的存储和使用方式。 **约束限制：** 不涉及。 **取值范围：** *semantic*: 语义记忆 *summary*: 摘要记忆 *user_preference*: 用户偏好 *episodic*: 情景记忆 **默认取值：** 不涉及。 |
| steps | 是 | Array of [CoreSpaceMemoryStrategyStepRequestBody] objects | **参数解释：** 策略步骤列表，每个元素为CoreSpaceMemoryStrategyStepRequestBody对象，包含步骤执行顺序和步骤指令，按 step_order 顺序执行。 **约束限制：** 数组长度0-20个。 |
表4CoreSpaceMemoryStrategyStepRequestBody
| 参数 | 是否必选 | 参数类型 | 描述 |
|:---|:---|:---|:---|
| 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字符。 **默认取值：** 不传使用默认模板，可通过获取内置记忆策略列表接口查看默认模板内容。 |
表5CreateCoreSpaceNetworkRequestBody
| 参数 | 是否必选 | 参数类型 | 描述 |
|:---|:---|:---|:---|
| public_access_enable | 否 | Boolean | **参数解释：** 是否开启公网访问。 **约束限制：** 不涉及。 **取值范围：** - true: 开启公网访问 - false: 关闭公网访问 **默认取值：** false |
| private_access_config | 否 | [CoreSpacePrivateNetworkRequestBody] object | **参数解释：** 内网访问配置，传入此对象表示配置内网访问，是否开启由enable字段决定。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
表6CoreSpacePrivateNetworkRequestBody
| 参数 | 是否必选 | 参数类型 | 描述 |
|:---|:---|:---|:---|
| enable | 是 | Boolean | **参数解释：** 是否开启内网访问。 **约束限制：** true 或 false。 **取值范围：** - true: 开启内网访问 - false: 关闭内网访问 **默认取值：** false |
| 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)。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
表7EncryptionConfig
| 参数 | 是否必选 | 参数类型 | 描述 |
|:---|:---|:---|:---|
| key_id | 是 | String | **参数解释：** KMS 密钥 ID，获取方式：通过KMS服务控制台或查询密钥列表接口获取。 **取值范围：** 不涉及。 |
#### 响应参数
**状态码：201**
表8响应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）。 **取值范围：** 不涉及。 |
表9CoreSpaceBuiltinMemoryStrategy
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| 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 顺序执行。 **取值范围：** 不涉及。 |
表10CoreSpaceBuiltinMemoryStrategyStep
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| 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 | **参数解释：** 输出格式模板。 **取值范围：** 不涉及。 |
表11CoreSpaceMemoryStrategy
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| 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）。 **取值范围：** 不涉及。 |
表12CoreSpaceMemoryStrategyStep
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| 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）。 **取值范围：** 不涉及。 |
表13CoreSpaceNetwork
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| domain_name | String | **参数解释：** 访问域名。 **取值范围：** 不涉及。 |
| ip | String | **参数解释：** IP 地址。 **取值范围：** 不涉及。 |
表14ShowCoreSpaceApiKeyResponseBody
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| id | String | **参数解释：** API Key ID。 **取值范围：** 不涉及。 |
| masked_key | String | **参数解释：** 脱敏后的 API Key。 **取值范围：** 不涉及。 |
表15EncryptionConfig
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| key_id | String | **参数解释：** KMS 密钥 ID，获取方式：通过KMS服务控制台或查询密钥列表接口获取。 **取值范围：** 不涉及。 |
表16CoreSpaceTag
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| key | String | **参数解释：** 标签键，用于标识标签的名称，最大长度128字符，不允许为空。 **取值范围：** 不涉及。 |
| value | String | **参数解释：** 标签值，用于配合标签键标识标签的具体内容，最大长度255字符，可以为空。 **取值范围：** 不涉及。 |
**状态码：400**
表17响应Body参数
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 |
| error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 |
**状态码：401**
表18响应Body参数
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 |
| error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 |
**状态码：403**
表19响应Body参数
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.XXXXXXXX。 **取值范围：** 不涉及。 |
| error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 |
| encoded_authorization_message | String | **参数解释：** 编码后的授权失败信息。 **取值范围：** 不涉及。 |
| details | Array of [CoreSpaceCommonError] objects | **参数解释：** 依赖的下游服务错误信息列表，包含导致当前请求失败的下游服务错误详情。 **取值范围：** 不涉及。 |
表20CoreSpaceCommonError
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 |
| error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 |
**状态码：404**
表21响应Body参数
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 |
| error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 |
**状态码：429**
表22响应Body参数
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 |
| error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 |
**状态码：500**
表23响应Body参数
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 |
| error_msg | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。 |
#### 请求示例
```
/v1/core/spaces
{
"name" : "space-01",
"message_ttl_hours" : 168,
"api_key_id" : "8ed3e306-0211-4e4d-af24-a9931b0e11d5",
"description" : "test-environment",
"memory_extract_idle_seconds" : 60,
"memory_extract_max_tokens" : 10000,
"memory_extract_max_messages" : 100,
"tags" : [ {
"key" : "Environment",
"value" : "production"
} ],
"memory_strategies_builtin" : [ "semantic", "user_preference" ],
"memory_strategies_customized" : [ {
"name" : "summary-memory",
"type" : "summary",
"steps" : [ ]
} ],
"network_access" : {
"public_access_enable" : true,
"private_access_config" : {
"enable" : true,
"vpc_id" : "32176dd1-a44a-4c40-99de-5f4359b46d93",
"subnet_id" : "5d1c6d00-cfbe-42b9-8c9d-1e2c2cea7e19"
}
}
}
```
#### 响应示例
**状态码：201**
Space创建成功
```
{
"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"
},
"encryption_config" : {
"key_id" : "cae83c1c-08d8-4565-9b69-dacca1d7757f"
},
"tags" : [ {
"key" : "Environment",
"value" : "production"
} ],
"status" : "creating",
"created_at" : "2025-01-18T10:00:00.000Z",
"updated_at" : "2025-01-18T10:00:00.000Z"
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 201 | Space创建成功 |
| 400 | 请求参数错误。 |
| 401 | 认证失败。 |
| 403 | 权限不足。 |
| 404 | 记忆库未找到 |
| 429 | 请求频率超限。 |
| 500 | 内部服务器错误 |
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。