AgentKit
AgentKit
文档指南
请输入
- 文档首页
AgentKitAgentKit开发者指南API参考MemoryAddMemoryCollection - 导入记忆库
复制全文
下载 pdfAddMemoryCollection - 导入记忆库
文档反馈
问问助手导入记忆库。
请求参数
Action string 必选 示例值：AddMemoryCollection
要执行的操作，取值：AddMemoryCollection。
Version string 必选 示例值：2025-10-30
API的版本，取值：2025-10-30。
ClientToken string 可选 示例值：333339fe****
保证请求幂等性。由客户端自动生成一个参数值，确保不同请求间该参数值唯一，避免当调用API超时或服务器内部错误时，客户端多次重试导致重复性操作。
取值：仅支持ASCII字符，且不能超过64个字符。
Collections.N.ProviderCollectionId string[] 必选 示例值：m-123
待导入记忆库的ID。
- 参数 - N：表示记忆库的序号。
- 多个字段名之间用&分隔。
取值：
- Mem0：填入Mem0项目的ID，即MemoryProjectId。
- Viking：填入ResourceId。
Collections.N.Description string[] 可选 示例值：knmemory-test
待导入记忆库的描述。
- 参数 - N：表示记忆库的序号。
- 最多允许输入200个字符，不填默认为空。
- 多个字段名之间用&分隔。
Collections.N.Name string[] 可选 示例值：my_collection
待导入记忆库名称。
- 参数 - N：表示记忆库的序号。
- 多个字段名之间用&分隔。
取值：
- Mem0：填入Mem0项目的名称，即MemoryProjectName。
- Viking：填入CollectionName。
Collections.N.ProjectName string[] 可选 示例值：default
所属项目名称。
- 参数 - N：表示记忆库的序号。
- 多个字段名之间用&分隔。
Collections.N.ProviderType string[] 可选 示例值：MEM0
待导入记忆库的类型。
- 参数 - N：表示记忆库的序号。
- 多个字段名之间用&分隔。
- 取值：
- MEM0：Mem0记忆库。
- VIKINGDB_MEMORY：Viking长期记忆。
返回参数
Collections object[] 示例值：--
已导入记忆库信息。
MemoryId string 示例值：mem-17616225****
记忆库ID。
Message string 示例值：The collection is not ready.
当前状态的详细信息，作为发布状态的补充。例如启动失败的原因。
ProviderCollectionId string 示例值：mem-294775****
已导入的记忆库ID。
ProviderType string 示例值：MEM0
已导入的记忆库平台类型。
Status string 示例值：Ready
记忆库状态，取值：
- Creating：创建中。
- CreateFailed：创建失败。
- Ready：可用。
- Deleting：删除中。
- DeleteFailed：删除失败。
- Deleted：已删除。
- Error：错误。
请求示例
POST https://agentkit.cn-beijing.volcengineapi.com?Action=AddMemoryCollection&Version=2025-10-30 HTTP/1.1
Content-Type: application/json
{
{
"Collections": [
{
"ProviderType": "MEM0",
"ProviderCollectionId":"mem-294775****"
}
]
}
}
返回示例
{
"ResponseMetadata": {
"RequestId": "202106111445100102252431000052****",
"Action": "AddMemoryCollection",
"Version": "2025-10-10",
"Service": "agentkit",
"Region": "cn-beijing"
},
"Result": {
"Collections": [
{
"MemoryId": " mem-1761138****",
"ProviderCollectionId": "mem-294775****",
"ProviderType": "MEM0",
"Status": "Ready",
"Message": ""
}
]
}
}
错误码
状态码 | 错误码 | 错误信息 | 说明 |
400 | InvalidClientToken.Malformed | The specified ClientToken is malformed. | 指定的ClientToken不合法。 |
400 | InvalidDescription.Malformed | The specified Description is malformed. | 指定的描述格式错误。 |
400 | InvalidName.Malformed | The specified Name is malformed. | 指定的Name不合法。 |
400 | InvalidProjectName.Malformed | The specified ProjectName is malformed. | 指定的ProjectName不合法。 |
400 | InvalidProviderCollectionId.Malformed | The specified ProviderCollectionId is malformed. | 指定的ProviderCollectionId不合法。 |
400 | InvalidRegion.Malformed | The specified Region is malformed. | 指定的Region不合法。 |
400 | LimitExceeded.MaximumCollections | The number of specified Collections exceeds the maximum limit. | 指定的Collections超过最大限制。 |
400 | MissingParameter.Collections | The required parameter Collections is not supplied. | 参数Collections不能为空。 |
400 | MissingParameter.ProviderCollectionId | The required parameter ProviderCollectionId is not supplied. | 参数ProviderCollectionId不能为空。 |
最近更新时间：2026.02.14 11:21:12
这个页面对您有帮助吗？
有用
有用
无用
无用