文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 记忆库/ 记忆策略管理/ 创建自定义记忆策略 - CreateCoreSpaceCustomizedStrategy
更新时间:2026-08-14 GMT+08:00
分享

创建自定义记忆策略 - CreateCoreSpaceCustomizedStrategy

功能介绍

为指定 Space 创建自定义记忆策略。

需指定策略名称、类型及步骤列表。

调用方法

请参见如何调用API

URI

POST /v1/core/spaces/{space_id}/strategies/customized

表1 路径参数

参数

是否必选

参数类型

描述

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}$。

默认取值:

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

name

String

参数解释:

策略名。

约束限制:

不涉及。

取值范围:

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

默认取值:

不涉及。

type

String

参数解释:

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

约束限制:

不涉及。

取值范围:

semantic: 语义记忆

summary: 摘要记忆

user_preference: 用户偏好

episodic: 情景记忆

默认取值:

不涉及。

steps

Array of CoreSpaceMemoryStrategyStepRequestBody objects

参数解释:

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

约束限制:

数组长度0-20个。

表3 CoreSpaceMemoryStrategyStepRequestBody

参数

是否必选

参数类型

描述

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

默认取值:

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

响应参数

状态码:201

表4 响应Body参数

参数

参数类型

描述

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

取值范围:

不涉及。

表5 CoreSpaceMemoryStrategyStep

参数

参数类型

描述

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

取值范围:

不涉及。

状态码:400

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

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

取值范围:

不涉及。

error_msg

String

参数解释:

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

取值范围:

不涉及。

状态码:401

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

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

取值范围:

不涉及。

error_msg

String

参数解释:

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

取值范围:

不涉及。

状态码:403

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

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

取值范围:

不涉及。

error_msg

String

参数解释:

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

取值范围:

不涉及。

encoded_authorization_message

String

参数解释:

编码后的授权失败信息。

取值范围:

不涉及。

details

Array of CoreSpaceCommonError objects

参数解释:

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

取值范围:

不涉及。

表9 CoreSpaceCommonError

参数

参数类型

描述

error_code

String

参数解释:

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

取值范围:

不涉及。

error_msg

String

参数解释:

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

取值范围:

不涉及。

状态码:404

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

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

取值范围:

不涉及。

error_msg

String

参数解释:

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

取值范围:

不涉及。

状态码:429

表11 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

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

取值范围:

不涉及。

error_msg

String

参数解释:

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

取值范围:

不涉及。

状态码:500

表12 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

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

取值范围:

不涉及。

error_msg

String

参数解释:

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

取值范围:

不涉及。

请求示例

/v1/core/spaces/123e4567-e89b-12d3-a456-426614174000/strategies/customized

{
  "name" : "summary-memory",
  "type" : "summary",
  "steps" : [ {
    "step_order" : 1,
    "instruction" : "Extract user preferences from the following conversation..."
  } ]
}

响应示例

状态码:201

自定义策略创建成功

{
  "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"
}

状态码

状态码

描述

201

自定义策略创建成功

400

请求参数错误。

401

认证失败。

403

权限不足。

404

记忆库未找到

429

请求频率超限。

500

内部服务器错误

错误码

请参见错误码

相关文档