获取Space详情 - ShowCoreSpace

功能介绍

根据记忆空间ID获取记忆空间详细信息，包含完整配置和记忆策略。

调用方法

URI

GET /v1/core/spaces/{space_id}

表1 路径参数
参数	是否必选	参数类型	描述
space_id	是	String	参数解释：记忆库 ID，唯一标识一个记忆库，可以通过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

成功获取Space信息

状态码：400

表2 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码，标识错误类型，格式为 AgentArts.01XXXXXX。取值范围：不涉及。
error_msg	String	参数解释：错误信息，描述错误详情，供问题排查使用。取值范围：不涉及。

状态码：401

表3 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码，标识错误类型，格式为 AgentArts.01XXXXXX。取值范围：不涉及。
error_msg	String	参数解释：错误信息，描述错误详情，供问题排查使用。取值范围：不涉及。

状态码：403

表4 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码，标识错误类型，格式为 AgentArts.XXXXXXXX。取值范围：不涉及。
error_msg	String	参数解释：错误信息，描述错误详情，供问题排查使用。取值范围：不涉及。
encoded_authorization_message	String	参数解释：编码后的授权失败信息。取值范围：不涉及。
details	Array of CoreSpaceCommonError objects	参数解释：依赖的下游服务错误信息列表，包含导致当前请求失败的下游服务错误详情。取值范围：不涉及。

表5 CoreSpaceCommonError
参数	参数类型	描述
error_code	String	参数解释：错误码，标识错误类型，格式为 AgentArts.01XXXXXX。取值范围：不涉及。
error_msg	String	参数解释：错误信息，描述错误详情，供问题排查使用。取值范围：不涉及。

状态码：404

表6 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码，标识错误类型，格式为 AgentArts.01XXXXXX。取值范围：不涉及。
error_msg	String	参数解释：错误信息，描述错误详情，供问题排查使用。取值范围：不涉及。

状态码：429

表7 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码，标识错误类型，格式为 AgentArts.01XXXXXX。取值范围：不涉及。
error_msg	String	参数解释：错误信息，描述错误详情，供问题排查使用。取值范围：不涉及。

状态码：500

表8 响应Body参数
参数	参数类型	描述
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	内部服务器错误