获取内置记忆策略列表 - ListCoreSpaceBuiltinStrategies
功能介绍
返回系统预置的内置记忆策略及其步骤详情,内置策略全局共享。
内置策略不可修改,用户可根据内置策略创建自定义策略。
当前包含 4 种内置策略:
调用方法
请参见如何调用API。
URI
GET /v1/core/space-builtin-strategies
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| limit | 否 | Integer | 参数解释: 每页返回的最大结果数量(条),用于分页查询。 约束限制: 不涉及。 取值范围: 1-100。 默认取值: 50。 |
| offset | 否 | Integer | 参数解释: 返回结果偏移量(条),用于分页查询时指定起始位置,从0开始。 约束限制: 不涉及。 取值范围: 0-100000。 默认取值: 0。 |
请求参数
无
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| strategies | Array of CoreSpaceBuiltinMemoryStrategy objects | 参数解释: 内置策略列表。 取值范围: 不涉及。 |
| total | Integer | 参数解释: 内置策略总数(个)。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: 策略 ID,唯一标识一个记忆策略。 取值范围: 不涉及。 |
| name | String | 参数解释: 策略名称,用于标识和区分不同的记忆策略。 取值范围: 不涉及。 |
| type | String | 参数解释: 策略名称,用于标识和区分不同的记忆策略。 取值范围: 不涉及。 |
| steps | Array of CoreSpaceBuiltinMemoryStrategyStep objects | 参数解释: 策略步骤列表,按 step_order 顺序执行。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| step_order | Integer | 参数解释: 步骤执行顺序(从 1 开始)。 取值范围: 不涉及。 |
| step_type | String | 参数解释: 步骤类型,决定记忆策略中该步骤的执行逻辑。 取值范围: |
| isolation_level | String | 参数解释: 隔离级别。 取值范围: |
| instruction | String | 参数解释: 步骤指令(Prompt 模板)。 取值范围: 不涉及。 |
| output_schema | String | 参数解释: 输出格式模板。 取值范围: 不涉及。 |
状态码:401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码,标识错误类型,格式为 AgentArts.XXXXXXXX。 取值范围: 不涉及。 |
| 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.XXXXXXXX。 取值范围: 不涉及。 |
| error_msg | String | 参数解释: 错误信息,描述错误详情,供问题排查使用。 取值范围: 不涉及。 |
状态码:429
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码,标识错误类型,格式为 AgentArts.XXXXXXXX。 取值范围: 不涉及。 |
| error_msg | String | 参数解释: 错误信息,描述错误详情,供问题排查使用。 取值范围: 不涉及。 |
状态码:500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 | 内部服务错误 |
错误码
请参见错误码。