文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 记忆库/ 记忆策略管理/ 获取内置记忆策略列表 - ListCoreSpaceBuiltinStrategies
更新时间:2026-06-10 GMT+08:00
分享

获取内置记忆策略列表 - ListCoreSpaceBuiltinStrategies

功能介绍

返回系统预置的内置记忆策略及其步骤详情,内置策略全局共享。

内置策略不可修改,用户可根据内置策略创建自定义策略。

当前包含 4 种内置策略:

  • Semantic Memory:语义记忆提取(extraction → consolidation)

  • User Preference:用户偏好提取(extraction → consolidation)

  • Summary:会话摘要生成(consolidation)

  • Episodic Memory:情景记忆提取(extraction → consolidation → reflection)

调用方法

请参见如何调用API

URI

GET /v1/core/space-builtin-strategies

表1 Query参数

参数

是否必选

参数类型

描述

limit

Integer

参数解释:

每页返回的最大结果数量(条),用于分页查询。

约束限制:

不涉及。

取值范围:

1-100。

默认取值:

50。

offset

Integer

参数解释:

返回结果偏移量(条),用于分页查询时指定起始位置,从0开始。

约束限制:

不涉及。

取值范围:

0-100000。

默认取值:

0。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

strategies

Array of CoreSpaceBuiltinMemoryStrategy objects

参数解释:

内置策略列表。

取值范围:

不涉及。

total

Integer

参数解释:

内置策略总数(个)。

取值范围:

不涉及。

表3 CoreSpaceBuiltinMemoryStrategy

参数

参数类型

描述

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

取值范围:

不涉及。

表4 CoreSpaceBuiltinMemoryStrategyStep

参数

参数类型

描述

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.XXXXXXXX。

取值范围:

不涉及。

error_msg

String

参数解释:

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

取值范围:

不涉及。

状态码:403

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

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

取值范围:

不涉及。

error_msg

String

参数解释:

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

取值范围:

不涉及。

encoded_authorization_message

String

参数解释:

编码后的授权失败信息。

取值范围:

不涉及。

details

Array of CoreSpaceCommonError objects

参数解释:

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

取值范围:

不涉及。

表7 CoreSpaceCommonError

参数

参数类型

描述

error_code

String

参数解释:

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

取值范围:

不涉及。

error_msg

String

参数解释:

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

取值范围:

不涉及。

状态码:429

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

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

取值范围:

不涉及。

error_msg

String

参数解释:

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

取值范围:

不涉及。

状态码:500

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

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

取值范围:

不涉及。

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
}

状态码:401

认证失败

{
  "error_code" : "AgentArts.01020002",
  "error_msg" : "Authentication failed"
}

状态码:403

权限不足

{
  "error_code" : "AgentArts.01010002",
  "error_msg" : "Insufficient permissions"
}

状态码:429

请求过于频繁

{
  "error_code" : "AgentArts.01020008",
  "error_msg" : "Too many requests"
}

状态码:500

内部服务错误

{
  "error_code" : "AgentArts.01010008",
  "error_msg" : "Internal service error"
}

状态码

状态码

描述

200

成功获取内置策略列表

401

认证失败

403

权限不足

429

请求过于频繁

500

内部服务错误

错误码

请参见错误码

相关文档