创建Space - CreateCoreSpace

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。

默认取值：

无

key

是

String

参数解释：

标签键，用于标识标签的名称，最大长度128字符，不允许为空。

约束限制：

不允许为空；不能以空格开头或结尾；不能以"sys"开头。可用 UTF-8 格式表示的字母（包含中文、西班牙语、葡语等）、数字和空格，以及以下字符： _ . : / = + - @。

取值范围：

不涉及。

默认取值：

不涉及。

value

是

String

参数解释：

标签值，用于配合标签键标识标签的具体内容，最大长度255字符，可以为空。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

name

是

String

参数解释：

策略名。

约束限制：

不涉及。

取值范围：

只能由字母、数字和中划线组成，长度1-48字符。

默认取值：

不涉及。

type

是

String

参数解释：

策略类型，决定记忆的存储和使用方式。

约束限制：

不涉及。

取值范围：

semantic: 语义记忆

summary: 摘要记忆

user_preference: 用户偏好

episodic: 情景记忆

默认取值：

不涉及。

steps

是

Array of CoreSpaceMemoryStrategyStepRequestBody objects

参数解释：

策略步骤列表，每个元素为CoreSpaceMemoryStrategyStepRequestBody对象，包含步骤执行顺序和步骤指令，按 step_order 顺序执行。

约束限制：

数组长度0-20个。

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

默认取值：

不传使用默认模板，可通过获取内置记忆策略列表接口查看默认模板内容。

public_access_enable

否

Boolean

参数解释：

是否开启公网访问。

约束限制：

不涉及。

取值范围：

• true: 开启公网访问

• false: 关闭公网访问

默认取值：

false

private_access_config

否

CoreSpacePrivateNetworkRequestBody object

参数解释：

内网访问配置，传入此对象表示配置内网访问，是否开启由enable字段决定。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

enable

是

Boolean

参数解释：

是否开启内网访问。

约束限制：

true 或 false。

取值范围：

• true: 开启内网访问

• false: 关闭内网访问

默认取值：

false

vpc_id

是

String

参数解释：

租户 VPC ID，获取方式：查询VPC列表。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

subnet_id

是

String

参数解释：

租户子网 ID，获取方式：查询子网列表。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

key_id

是

String

参数解释：

KMS 密钥 ID，获取方式：通过KMS服务控制台或查询密钥列表接口获取。

取值范围：

不涉及。

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列表。

取值范围：

不涉及。

subnet_id

String

参数解释：

租户子网 ID，获取方式：查询子网列表。

取值范围：

不涉及。

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）。

取值范围：

不涉及。

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 顺序执行。

取值范围：

不涉及。

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

参数解释：

输出格式模板。

取值范围：

不涉及。

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）。

取值范围：

不涉及。

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）。

取值范围：

不涉及。

domain_name

String

参数解释：

访问域名。

取值范围：

不涉及。

ip

String

参数解释：

IP 地址。

取值范围：

不涉及。

id

String

参数解释：

API Key ID。

取值范围：

不涉及。

masked_key

String

参数解释：

脱敏后的 API Key。

取值范围：

不涉及。

key_id

String

参数解释：

KMS 密钥 ID，获取方式：通过KMS服务控制台或查询密钥列表接口获取。

取值范围：

不涉及。

key

String

参数解释：

标签键，用于标识标签的名称，最大长度128字符，不允许为空。

取值范围：

不涉及。

value

String

参数解释：

标签值，用于配合标签键标识标签的具体内容，最大长度255字符，可以为空。

取值范围：

不涉及。

error_code

String

参数解释：

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

取值范围：

不涉及。

error_msg

String

参数解释：

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

取值范围：

不涉及。

error_code

String

参数解释：

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

取值范围：

不涉及。

error_msg

String

参数解释：

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

取值范围：

不涉及。

error_code

String

参数解释：

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

取值范围：

不涉及。

error_msg

String

参数解释：

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

取值范围：

不涉及。

encoded_authorization_message

String

参数解释：

编码后的授权失败信息。

取值范围：

不涉及。

details

Array of CoreSpaceCommonError objects

参数解释：

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

取值范围：

不涉及。

error_code

String

参数解释：

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

取值范围：

不涉及。

error_msg

String

参数解释：

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

取值范围：

不涉及。

error_code

String

参数解释：

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

取值范围：

不涉及。

error_msg

String

参数解释：

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

取值范围：

不涉及。

error_code

String

参数解释：

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

取值范围：

不涉及。

error_msg

String

参数解释：

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

取值范围：

不涉及。

error_code

String

参数解释：

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

取值范围：

不涉及。

error_msg

String

参数解释：

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

取值范围：

不涉及。

201

Space创建成功

400

请求参数错误。

401

认证失败。

403

权限不足。

404

记忆库未找到

429

请求频率超限。

500

内部服务器错误