知识库Agent Tool操作接口
批量上传文件
通过文件 URL 批量上传入库。HTTP 接口 files 上限为 10。
请求体
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| spaceId | int64 | 是 | 知识库空间 ID。 | 123456 |
| parentId | int64 | 否 | 父目录 ID,根目录为 0。 | 0 |
| files | object[] | 是 | 文件列表,HTTP 接口上限为 10。 | |
| └title | string | 是 | 文件标题,需包含扩展名。 | FAQ.md |
| └fileUrl | string | 是 | 可访问的文件 URL。 | https://example.com/faq.md |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 业务响应码。200 表示成功;失败时为 RetCode 中定义的业务码。 | 200 |
| msg | string | 响应说明。成功通常为 ok;失败时为错误原因。 | ok |
| message | string | 兼容字段,部分异常场景可能返回错误说明。 | |
| data | object | 批量上传结果。 | |
| └results | object[] | 逐文件上传结果。 | |
| └title | string | 文件标题。 | FAQ.md |
| └docId | int64 | 文档 ID。 | 987654 |
| └success | boolean | 是否成功。 | true |
| └errorMsg | string | 失败原因。 | title and fileUrl are required |
| └parentId | int64 | 目标父目录 ID。 | 0 |
| └spaceId | int64 | 目标空间 ID。 | 123456 |
错误码
| 状态码 | 描述 |
|---|---|
| 400 | 请求参数错误。常见业务码:402 MISS_PARAM、403 ERR_PARAM。 |
| 401 | PERSONAL_API 鉴权失败。常见业务码:405 AUTH_FAILED。 |
| 403 | 权限不足。常见业务码:406 FORBIDDEN。 |
| 404 | 资源不存在。常见业务码:404 NOT_FOUND。 |
| 500 | 服务内部异常。常见业务码:500 ERROR。 |
postEndpoint
/api/athena/agent/tool/batchUploadFilescurl -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"
}这篇文档有帮助吗?