文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 记忆库/ 异步任务管理/ 创建记忆导入任务 - CreateCoreSpaceImportJob
更新时间:2026-11-04 GMT+08:00
分享

创建记忆导入任务 - 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

表1 路径参数

参数

是否必选

参数类型

描述

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}$。

默认取值:

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

format

否

String

参数解释:

导入来源格式,当前仅支持 jsonl(AgentArts-Memory 平台导出的 JSONL 格式),默认值为 jsonl。

约束限制:

不涉及。

取值范围:

  • jsonl: AgentArts-Memory 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

表3 响应Body参数

参数

参数类型

描述

job_id

String

参数解释:

异步任务 ID,唯一标识一个异步任务。

取值范围:

不涉及。

状态码:400

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.01XXXXXX。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息,描述错误详情,供问题排查使用。

取值范围:

不涉及。

状态码:401

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.01XXXXXX。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息,描述错误详情,供问题排查使用。

取值范围:

不涉及。

状态码:403

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.XXXXXXXX。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息,描述错误详情,供问题排查使用。

取值范围:

不涉及。

encoded_authorization_message

String

参数解释:

编码后的授权失败信息。

取值范围:

不涉及。

details

Array of CoreSpaceCommonError objects

参数解释:

依赖的下游服务错误信息列表,包含导致当前请求失败的下游服务错误详情。

取值范围:

不涉及。

表7 CoreSpaceCommonError

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.01XXXXXX。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息,描述错误详情,供问题排查使用。

取值范围:

不涉及。

状态码:404

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.01XXXXXX。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息,描述错误详情,供问题排查使用。

取值范围:

不涉及。

状态码:429

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.01XXXXXX。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息,描述错误详情,供问题排查使用。

取值范围:

不涉及。

状态码:500

表10 响应Body参数

参数

参数类型

描述

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

内部服务错误

错误码

请参见错误码。

相关文档