七鱼开发文档中心
总览服务端 APIWebiOSAndroid鸿蒙Uniapp微信小程序插件三方接入
知识库Agent Tool操作接口

批量上传文件

通过文件 URL 批量上传入库。HTTP 接口 files 上限为 10。

请求体

名称类型必填描述示例值
spaceIdint64是知识库空间 ID。123456
parentIdint64否父目录 ID,根目录为 0。0
filesobject[]是文件列表,HTTP 接口上限为 10。
└titlestring是文件标题,需包含扩展名。FAQ.md
└fileUrlstring是可访问的文件 URL。https://example.com/faq.md

返回参数

名称类型描述示例值
codeint32业务响应码。200 表示成功;失败时为 RetCode 中定义的业务码。200
msgstring响应说明。成功通常为 ok;失败时为错误原因。ok
messagestring兼容字段,部分异常场景可能返回错误说明。
dataobject批量上传结果。
└resultsobject[]逐文件上传结果。
└titlestring文件标题。FAQ.md
└docIdint64文档 ID。987654
└successboolean是否成功。true
└errorMsgstring失败原因。title and fileUrl are required
└parentIdint64目标父目录 ID。0
└spaceIdint64目标空间 ID。123456

错误码

状态码描述
400请求参数错误。常见业务码:402 MISS_PARAM、403 ERR_PARAM。
401PERSONAL_API 鉴权失败。常见业务码:405 AUTH_FAILED。
403权限不足。常见业务码:406 FORBIDDEN。
404资源不存在。常见业务码:404 NOT_FOUND。
500服务内部异常。常见业务码:500 ERROR。
postEndpoint
/api/athena/agent/tool/batchUploadFiles
POST
/api/athena/agent/tool/batchUploadFiles
curl -X POST "https://b.163.com/api/athena/agent/tool/batchUploadFiles" \  -H "Content-Type: application/json" \  -d '{    "spaceId": 123456,    "files": [      {        "title": "FAQ.md",        "fileUrl": "https://example.com/faq.md"      }    ]  }'
{
  "code": 200,
  "msg": "ok",
  "message": "string",
  "data": {
    "results": [
      {
        "title": "FAQ.md",
        "docId": 987654,
        "success": true,
        "errorMsg": "title and fileUrl are required"
      }
    ],
    "parentId": 0,
    "spaceId": 123456
  }
}
{
  "code": 200,
  "msg": "ok",
  "message": "string"
}
{
  "code": 200,
  "msg": "ok",
  "message": "string"
}
{
  "code": 200,
  "msg": "ok",
  "message": "string"
}
{
  "code": 200,
  "msg": "ok",
  "message": "string"
}
{
  "code": 200,
  "msg": "ok",
  "message": "string"
}

这篇文档有帮助吗?