获取Space详情 - ShowCoreSpace
功能介绍
根据记忆空间ID获取记忆空间详细信息,包含完整配置和记忆策略。
调用方法
请参见如何调用API。
URI
GET /v1/core/spaces/{space_id}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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}$。 默认取值: 不涉及。 |
请求参数
无
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: 记忆空间 ID,唯一标识一个记忆空间,可通过"创建Space"接口获取。 取值范围: 不涉及。 |
| name | String | 参数解释: 记忆空间名称。 取值范围: 不涉及。 |
| description | String | 参数解释: 记忆空间描述。 取值范围: 不涉及。 |
| message_ttl_hours | Integer | 参数解释: 短期记忆过期时间(小时)。 取值范围: 不涉及。 |
| memory_extract_enabled | Boolean | 参数解释: 是否开启长期记忆抽取。 取值范围: |
| 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 | 参数解释: Space 关联的 API Key 脱敏信息。 取值范围: 不涉及。 | |
| encryption_config | EncryptionConfig object | 参数解释: Space 加密配置,使用KMS密钥对Space数据进行加密。 取值范围: KMS 密钥ID。 |
| tags | Array of CoreSpaceTag objects | 参数解释: 库标签列表。 取值范围: 不涉及。 |
| status | String | 参数解释: Space 状态。 取值范围: |
| 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 | 参数解释: 策略类型,决定记忆策略的处理方式和执行流程。 取值范围: 不涉及。 |
| steps | Array of CoreSpaceBuiltinMemoryStrategyStep objects | 参数解释: 策略步骤列表,按 step_order 顺序执行。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| step_order | Integer | 参数解释: 步骤执行顺序(从 1 开始)。 取值范围: 不涉及。 |
| step_type | String | 参数解释: 步骤类型,决定记忆策略中该步骤的执行逻辑。 取值范围: |
| isolation_level | String | 参数解释: 隔离级别。 取值范围: |
| instruction | String | 参数解释: 步骤指令(Prompt 模板)。 取值范围: 不涉及。 |
| output_schema | String | 参数解释: 输出格式模板。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: 策略 ID。 取值范围: 不涉及。 |
| name | String | 参数解释: 策略名称。 取值范围: 不涉及。 |
| type | String | 参数解释: 策略类型。 当前包含 4 种内置策略: 取值范围: 不涉及。 |
| origin_type | String | 参数解释: 策略来源类型。 取值范围: |
| 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 | 参数解释: 步骤类型。 取值范围: |
| isolation_level | String | 参数解释: 隔离级别。 取值范围: |
| 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 | String | 参数解释: 标签键,用于标识标签的名称,最大长度128字符,不允许为空。 取值范围: 不涉及。 |
| value | String | 参数解释: 标签值,用于配合标签键标识标签的具体内容,最大长度255字符,可以为空。 取值范围: 不涉及。 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码,标识错误类型,格式为 AgentArts.01XXXXXX。 取值范围: 不涉及。 |
| error_msg | String | 参数解释: 错误信息,描述错误详情,供问题排查使用。 取值范围: 不涉及。 |
状态码:401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码,标识错误类型,格式为 AgentArts.01XXXXXX。 取值范围: 不涉及。 |
| error_msg | String | 参数解释: 错误信息,描述错误详情,供问题排查使用。 取值范围: 不涉及。 |
状态码:403
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 | 参数解释: 错误信息,描述错误详情,供问题排查使用。 取值范围: 不涉及。 |
状态码:404
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码,标识错误类型,格式为 AgentArts.01XXXXXX。 取值范围: 不涉及。 |
| error_msg | String | 参数解释: 错误信息,描述错误详情,供问题排查使用。 取值范围: 不涉及。 |
状态码:429
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码,标识错误类型,格式为 AgentArts.01XXXXXX。 取值范围: 不涉及。 |
| error_msg | String | 参数解释: 错误信息,描述错误详情,供问题排查使用。 取值范围: 不涉及。 |
状态码:500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码,标识错误类型,格式为 AgentArts.01XXXXXX。 取值范围: 不涉及。 |
| error_msg | String | 参数解释: 错误信息,描述错误详情,供问题排查使用。 取值范围: 不涉及。 |
请求示例
/v1/core/spaces/123e4567-e89b-12d3-a456-426614174000
响应示例
状态码:200
成功获取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" : "<schema>{...SemanticMemory schema...}</schema>\n<conversation>\n{messages}\n</conversation>"
}, {
"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" : "<new_content>\n{new_content}\n</new_content>\n<existing_memories>\n{historical_memories}\n</existing_memories>"
} ]
} ],
"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"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 成功获取Space信息 |
| 400 | 请求参数错误。 |
| 401 | 认证失败。 |
| 403 | 权限不足。 |
| 404 | 记忆库未找到 |
| 429 | 请求频率超限。 |
| 500 | 内部服务器错误 |
错误码
请参见错误码。