通过自定义筛选条件批量查询记忆库详情。

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：ListMemoryCollections

要执行的操作，取值：ListMemoryCollections。

Version string 必选示例值：2025-10-30

API的版本，取值：2025-10-30。

CreateTimeAfter string 可选示例值：2025-09-17T10:00:00+8:00

筛选该时间点后创建的记忆库。（RFC3339格式）

CreateTimeBefore string 可选示例值：2025-09-17T10:00:00+8:00

筛选该时间点前创建的记忆库。（RFC3339格式）

Filters.N.Name string[] 可选示例值：name

精确过滤的字段名。

参数 - N：表示过滤条件的序号，取值范围：1～10。

多个字段名之间用&分隔，为“或”的关系。

取值：

collection_id：记忆库ID。

name：记忆库名称。

description：记忆库描述。

status：记忆库状态。

provider_type：导入的知识库平台类型。

说明

当Filters.N.Name和Filters.N.NameContains同时传入时，仅Filters.N.Name生效。

Filters.N.NameContains string[] 可选示例值：name

模糊过滤的字段名。

参数 - N：表示过滤条件的序号，取值范围：1～10。

多个字段名之间用&分隔，为“或”的关系。

取值：

collection_id：记忆库ID。

name：记忆库名称。

description：记忆库描述。

status：记忆库状态。

provider_type：导入的知识库平台类型。

说明

当Filters.N.Name和Filters.N.NameContains同时传入时，仅Filters.N.Name生效。

Filters.N.Values.N string[] 可选示例值：my_memory

过滤字段的值。

参数 - N：表示过滤条件的序号，取值范围：1～10。

多个字段名之间用&分隔。

当过滤条件为status时，取值：

Creating：创建中。

CreateFailed：创建失败。

Ready：可用。

Deleting：删除中。

DeleteFailed：删除失败。

Deleted：资源失效。

Error：错误。

当过滤条件为provider_type时，取值：

MEM0：Mem0记忆库。

VIKINGDB_MEMORY：Viking长期记忆。

MaxResults integer 可选示例值：10

分页查询时设置的每页行数。

最小值：1。

最大值：100。

默认值：10。

NextToken string 可选示例值：unique-token

分页查询凭证，用于标记分页的位置，初次调用该接口时无需设置。下次查询时，取值为上一次API调用返回的NextToken参数值。

UpdateTimeAfter string 可选示例值：2025-09-17T10:00:00+8:00

筛选该时间点后更新的记忆库。（RFC3339格式）

UpdateTimeBefore string 可选示例值：2025-09-17T10:00:00+8:00

筛选该时间点前更新的记忆库。（RFC3339格式）

ProjectName string 可选示例值：default

所属项目名称。

TagFilters.N.Key string[] 可选示例值：TagFilters.1.Key=k1

根据标签查询资源时指定的标签键，不允许重复。

参数 - N：表示标签键的序号，取值范围：1～10。

多个标签键之间用&分隔。

TagFilters.N.Values.N string[] 可选示例值：TagFilters.1.Values.1=v1

根据标签查询资源时指定的标签值。

第一个N：表示标签键的序号，取值范围：1～10。

第二个N：表示标签值的序号，取值范围：1～3，即同一标签键最多支持同时查询3个标签值。

多个标签值之间用&分隔。

说明

如果传入该参数，则必须先传入TagFilters.N.Key。

不传则表示查询同一标签键下的所有标签值。

传入空字符串时，表示查询标签值为空的标签。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

Memories object[] 示例值：--

符合条件的记忆库信息。

AssociatedRuntimes object[] 示例值：--

关联的运行时列表。

Id string 示例值：r-ye9tu7****

运行时ID。

Name string 示例值：runtime-01

运行时名称。

CreateTime string 示例值：2025-09-17T10:00:00+8:00

记忆库的创建时间。

Description string 示例值：memory-test

记忆库的描述。

LastUpdateTime string 示例值：2025-09-17T10:00:00+8:00

记忆库的更新时间。

Managed boolean 示例值：true

记忆库是否由Agentkit平台管理，取值：

true：表示由Agentkit平台创建，删除时会同时删除对应平台的资源。

false：表示由提供商平台导入，删除时保留对应平台的资源。

MemoryId string 示例值：mem-17616225****

记忆库ID。

Name string 示例值：my_memory

记忆库名称。

NetworkConfiguration object 示例值：--

网络配置。

EnablePrivateNetwork boolean 示例值：false

是否开启运行时的私网访问能力，取值：

true：开启。

false：不开启。

EnablePublicNetwork boolean 示例值：true

是否开启运行时的公网访问能力，取值：

true：开启。

false：不开启。

VpcConfiguration object 示例值：--

VPC私网配置。

SecurityGroupIds string[] 示例值：["sg-w08tvkc3e****"]

安全组ID列表。

SubnetIds string[] 示例值：["subnet-1234567890"]

子网ID列表。

VpcId string 示例值：vpc-257gqcdfvx6n****

VPC ID。

ProjectName string 示例值：default

所属项目名称。

ProviderCollectionId string 示例值：mem-294775****

已导入的记忆库ID。

ProviderType string 示例值：MEM0

记忆库类型，取值：

MEM0：Mem0记忆库。

VIKINGDB_MEMORY：Viking长期记忆。

Region string 示例值：cn-beijing

所属区域。

Status string 示例值：Ready

记忆库状态，取值：

Creating：创建中。

CreateFailed：创建失败。

Ready：可用。

Deleting：删除中。

DeleteFailed：删除失败。

Deleted：已删除。

Error：错误。

StrategiesCount integer 示例值：3

记忆库的策略总数量。

Tags object[] 示例值：--

记忆库标签。

Type string 示例值：custom

标签类型。

system：系统标签。

custom：用户标签。

Key string 示例值：k1

标签键。

Value string 示例值：v1

标签值。

NextToken string 示例值：bHpwdXJja2RxemU1eG5sb3NzdGcW1-RCEq******

本次调用返回的查询凭证值，返回为空表示该页为末页。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidProjectName.Malformed	The specified ProjectName is malformed.	指定的ProjectName不合法。
400	LimitExceeded.MaximumFilters	The number of specified Filters exceeds the maximum limit.	指定的Filters超过最大限制。
400	LimitExceeded.MaximumMaxResults	The number of specified MaxResults exceeds the maximum limit.	指定的MaxResults超过最大限制。
400	LimitExceeded.MaximumPageSize	The number of specified PageSize exceeds the maximum limit.	指定的PageSize超过最大限制。

AgentKit