创建记忆导入任务 - CreateCoreSpaceImportJob
功能介绍
将指定格式文件内容导入到指定Space。
调用方法
请参见如何调用API。
授权信息
账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。
| 授权项 | 访问级别 | 资源类型(*为必须) | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| agentarts:memorySpace:createCoreSpaceImportJob | Write | memorySpace * | g:ResourceTag/<tag-key> | - | iam:agencies:pass |
URI
POST /v1/core/spaces/{space_id}/import
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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}$。 默认取值: 不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| format | 否 | String | 参数解释: 导入来源格式,当前仅支持 jsonl(AgentArts-Memory 平台导出的 JSONL 格式),默认值为 jsonl。 约束限制: 不涉及。 取值范围: 默认取值: jsonl。 |
| bucket | 是 | String | 参数解释: 用户自建的 OBS 桶名,导入文件从此桶中读取。 约束限制: 需符合 OBS 桶命名规范。用户需先在 OBS 页面上传待导入的文件到此桶。 取值范围: 长度 3-63 字符。 默认取值: 不涉及。 |
| file_path | 是 | String | 参数解释: 导入文件在桶中的完整文件路径(file_path)。 约束限制: 不涉及。 取值范围: 长度 1-1024 字符。 默认取值: 不涉及。 |
| agency_name | 是 | String | 参数解释: IAM 委托名称(必选),用于获取访问用户 OBS 桶的临时凭证。 约束限制: 必须是有效的 IAM 委托名称。 取值范围: 长度 1-64 字符。 默认取值: AgentArtsMemoryImportExportAgency。 |
响应参数
状态码:202
| 参数 | 参数类型 | 描述 |
|---|---|---|
| job_id | String | 参数解释: 异步任务 ID,唯一标识一个异步任务。 取值范围: 不涉及。 |
状态码: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/import
响应示例
状态码:202
{
"job_id" : "660e8400-e29b-41d4-a716-446655440001"
} 状态码:400
{
"error_code" : "AgentArts.01010001",
"error_msg" : "请求参数格式不正确"
} 状态码:403
{
"error_code" : "AgentArts.01010002",
"error_msg" : "Insufficient permissions"
} 状态码:404
{
"error_code" : "AgentArts.01010005",
"error_msg" : "Record not found"
} 状态码:429
{
"error_code" : "AgentArts.01020008",
"error_msg" : "System busy, task queued"
} 状态码:500
{
"error_code" : "AgentArts.01010008",
"error_msg" : "Internal service error"
} 状态码
| 状态码 | 描述 |
|---|---|
| 202 | 导入任务创建成功 |
| 400 | 请求参数错误 |
| 401 | 认证失败。 |
| 403 | 权限不足 |
| 404 | Space 不存在 |
| 429 | 系统并发任务已满,任务进入排队 |
| 500 | 内部服务错误 |
错误码
请参见错误码。