# 获取内置记忆策略列表 - ListCoreSpaceBuiltinStrategies
#### 功能介绍
返回系统预置的内置记忆策略及其步骤详情，内置策略全局共享。
内置策略不可修改，用户可根据内置策略创建自定义策略。
当前包含 4 种内置策略：
- **Semantic Memory**：语义记忆提取（extraction → consolidation）
  
- **User Preference**：用户偏好提取（extraction → consolidation）
  
- **Summary**：会话摘要生成（consolidation）
  
- **Episodic Memory**：情景记忆提取（extraction → consolidation → reflection）
  
 
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-agentarts/agentarts_07_0003.html)。
#### URI
GET /v1/core/space-builtin-strategies
表1Query参数 
| 参数     | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| limit  | 否    | Integer | **参数解释：** 每页返回的最大结果数量（条），用于分页查询。 **约束限制：** 不涉及。 **取值范围：** 1-100。 **默认取值：** 50。           |
| offset | 否    | Integer | **参数解释：** 返回结果偏移量（条），用于分页查询时指定起始位置，从0开始。 **约束限制：** 不涉及。 **取值范围：** 0-100000。 **默认取值：** 0。 |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数         | 参数类型                                                                                                                        | 描述                                                                                                                                                                                        |
|:---|:---|:---|
| strategies | Array of [CoreSpaceBuiltinMemoryStrategy] objects | **参数解释：** 内置策略列表。 **取值范围：** 不涉及。    |
| total      | Integer                                                                                                                     | **参数解释：** 内置策略总数（个）。 **取值范围：** 不涉及。 |
   
 表3CoreSpaceBuiltinMemoryStrategy 
| 参数    | 参数类型                                                                                                                                | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|
| 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 顺序执行。 **取值范围：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   
 表4CoreSpaceBuiltinMemoryStrategyStep 
| 参数              | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|
| 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  | **参数解释：** 输出格式模板。 **取值范围：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
   
**状态码：401**
表5响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 |
| error_msg  | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。               |
   
**状态码：403**
表6响应Body参数 
| 参数                            | 参数类型                                                                                                    | 描述                                                                                                                                                                                                                |
|:---|:---|:---|
| error_code                    | String                                                                                                  | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.XXXXXXXX。 **取值范围：** 不涉及。 |
| error_msg                     | String                                                                                                  | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。               |
| encoded_authorization_message | String                                                                                                  | **参数解释：** 编码后的授权失败信息。 **取值范围：** 不涉及。                        |
| details                       | Array of [CoreSpaceCommonError] objects | **参数解释：** 依赖的下游服务错误信息列表，包含导致当前请求失败的下游服务错误详情。 **取值范围：** 不涉及。 |
   
 表7CoreSpaceCommonError 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 |
| error_msg  | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。               |
   
**状态码：404**
表8响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 |
| error_msg  | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。               |
   
**状态码：429**
表9响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 |
| error_msg  | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。               |
   
**状态码：500**
表10响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码，标识错误类型，格式为 AgentArts.01XXXXXX。 **取值范围：** 不涉及。 |
| error_msg  | String | **参数解释：** 错误信息，描述错误详情，供问题排查使用。 **取值范围：** 不涉及。               |
   
#### 请求示例
```
/v1/core/space-builtin-strategies?limit=50&offset=0
```
#### 响应示例
**状态码：200**
成功获取内置策略列表
```
{
  "strategies" : [ {
    "id" : "456e7890-e89b-12d3-a456-426614174000",
    "name" : "Semantic_Memory",
    "type" : "semantic",
    "steps" : [ {
      "step_order" : 1,
      "step_type" : "extraction",
      "isolation_level" : "actor",
      "instruction" : "Extract user preferences from the following conversation...",
      "output_schema" : "string"
    } ]
  } ],
  "total" : 4
}
```
#### 状态码
| 状态码 | 描述         |
|:---|:---|
| 200 | 成功获取内置策略列表 |
| 401 | 认证失败。      |
| 403 | 权限不足。      |
| 404 | 记忆库未找到     |
| 429 | 请求频率超限。    |
| 500 | 内部服务器错误    |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。