创建自定义记忆策略 - CreateCoreSpaceCustomizedStrategy
功能介绍
为指定 Space 创建自定义记忆策略。
需指定策略名称、类型及步骤列表。
调用方法
请参见如何调用API。
URI
POST /v1/core/spaces/{space_id}/strategies/customized
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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}$。 默认取值: 不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| name | 是 | String | 参数解释: 策略名。 约束限制: 不涉及。 取值范围: 只能由字母、数字和中划线组成,长度1-48字符。 默认取值: 不涉及。 |
| type | 是 | String | 参数解释: 策略类型,决定记忆的存储和使用方式。 约束限制: 不涉及。 取值范围: semantic: 语义记忆 summary: 摘要记忆 user_preference: 用户偏好 episodic: 情景记忆 默认取值: 不涉及。 |
| steps | 是 | Array of CoreSpaceMemoryStrategyStepRequestBody objects | 参数解释: 策略步骤列表,每个元素为CoreSpaceMemoryStrategyStepRequestBody对象,包含步骤执行顺序和步骤指令,按 step_order 顺序执行。 约束限制: 数组长度0-20个。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| step_order | 是 | Integer | 参数解释: 步骤执行顺序,从 1 开始。 约束限制: semantic: 2步, summary: 1步, user_preference: 2步, episodic: 3步。 取值范围: 1-20 默认取值: 不涉及。 |
| instruction | 否 | String | 参数解释: 步骤指令(Prompt 模板)。 约束限制: 不涉及。 取值范围: 支持中文字符、英文字母、数字及常用标点符号,长度0-50000字符。 默认取值: 不传使用默认模板,可通过获取内置记忆策略列表接口查看默认模板内容。 |
响应参数
状态码:201
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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)。 取值范围: 不涉及。 |
状态码: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/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 | 内部服务器错误 |
错误码
请参见错误码。