AgentKit
AgentKit
文档指南
请输入
- 文档首页
AgentKitAgentKit开发者指南API参考MemoryGetMemoryCollection - 查询记忆库详情
复制全文
下载 pdfGetMemoryCollection - 查询记忆库详情
文档反馈
问问助手查询记忆库详情。
请求参数
Action string 必选 示例值：GetMemoryCollection
要执行的操作，取值：GetMemoryCollection。
Version string 必选 示例值：2025-10-30
API的版本，取值：2025-10-30。
MemoryId string 必选 示例值：mem-17616225****
记忆库ID。
返回参数
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
记忆库更新时间。
LongTermConfiguration object 示例值：--
长期记忆提取策略信息。
Strategies object[] 示例值：--
长期记忆提取策略列表。
CustomExtractionInstructions string 示例值：Summarize facts.
自定义策略的系统提示词（Prompt）。
Name string 示例值：s_1
长期记忆提取策略的名称。
Type string 示例值：Summary
长期记忆提取策略的类型，取值：
- Summary：会话摘要（会话级别）。
- Semantic：语义记忆（用户级别）。
- UserPreference：用户偏好（用户级别）。
Managed boolean 示例值：true
记忆库是否由Agentkit平台管理，取值：
- true：表示由Agentkit平台创建，删除时会同时删除对应平台的资源。
- false：表示由提供商平台导入，删除时保留对应平台的资源。
MemoryId string 示例值：mem-17616225****
记忆库ID。
Name string 示例值：my_collection
记忆库名称。
ProjectName string 示例值：default
记忆库所属项目名称。
ProviderCollectionId string 示例值：mem-294775****
Viking或者Mem0的记忆库ID。
ProviderType string 示例值：MEM0
记忆库类型，取值：
- MEM0：Mem0记忆库。
- VIKINGDB_MEMORY：Viking长期记忆。
Region string 示例值：cn-beijing
记忆库所属区域。
Status string 示例值：Ready
记忆库状态，取值：
- Creating：创建中。
- CreateFailed：创建失败。
- Ready：可用。
- Deleting：删除中。
- DeleteFailed：删除失败。
- Deleted：资源失效。
- Error：错误。
Tags object[] 示例值：--
记忆库标签。
Type string 示例值：custom
标签类型。
- system：系统标签。
- custom：用户标签。
Key string 示例值：k1
标签键。
Value string 示例值：v1
标签值。
Trn string 示例值：trn:agentkit:cn-beijing:210000:memory:mem-****
记忆库的TRN。
VpcConfig object 示例值：--
VPC私网配置。
SubnetIds string[] 示例值：["subnet-1234567890"]
子网ID列表。
VpcId string 示例值：vpc-257gqcdfvx6n****
VPC ID。
请求示例
POST https://agentkit.cn-beijing.volcengineapi.com?Action=GetMemoryCollection&Version=2025-10-30 HTTP/1.1
Content-Type: application/json
{
"MemoryId": "mem-1761138****"
}
返回示例
{
"ResponseMetadata": {
"RequestId": "202106111445100102252431000052****",
"Action": "GetMemoryCollection",
"Version": "2025-10-10",
"Service": "agentkit",
"Region": "cn-beijing"
},
"Result": {
"MemoryId": "mem-1761138****",
"Name": "my_collection",
"Description": "memory-test",
"Trn": "trn:appo:memory:cn-beijing:123456:memory/mem-1761138****",
"ProviderCollectionId": "mem-294775****",
"ProviderType": "MEM0",
"Status": "Ready",
"LongTermConfiguration": {
"Strategies": [
{
"Type": "Summary",
"CustomExtractionInstructions": "Extract key information from conversation",
"Name": "agentkit_semantic_v1"
}
]
},
"LastUpdateTime": "2025-09-16T10:05:00Z",
"Managed": "true",
"CreateTime": "2025-09-16T10:00:00Z"
}
}
错误码
状态码 | 错误码 | 错误信息 | 说明 |
400 | MissingParameter.MemoryId | The required parameter MemoryId is not supplied. | 参数MemoryId不能为空。 |
404 | InvalidResource.NotFound | The specified resource does not exist. | 资源不存在。 |
最近更新时间：2026.02.14 11:21:12
这个页面对您有帮助吗？
有用
有用
无用
无用