知识库Agent Tool查询接口
获取文档内容下载地址
获取文档标题和下载地址。文件夹没有正文,会返回参数错误。
请求体
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| spaceId | int64 | 是 | 知识库空间 ID。 | 123456 |
| docId | int64 | 是 | 文档 ID。 | 987654 |
| expireDays | int32 | 否 | 外部预览链接有效天数,必须大于 0,且不能超过服务端配置上限。 | 7 |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 业务响应码。200 表示成功;失败时为 RetCode 中定义的业务码。 | 200 |
| msg | string | 响应说明。成功通常为 ok;失败时为错误原因。 | ok |
| message | string | 兼容字段,部分异常场景可能返回错误说明。 | |
| data | object | 文档内容下载信息。 | |
| └title | string | 文档标题。 | 退款规则 |
| └type | string | 文档类型。 | MARKDOWN |
| └content | string | 文档正文内容。 | |
| └downloadUrl | string | 文档下载地址,当前内容无法直接内联返回时提供。 | https://example.com/download |
错误码
| 状态码 | 描述 |
|---|---|
| 400 | 请求参数错误。常见业务码:402 MISS_PARAM、403 ERR_PARAM。 |
| 401 | PERSONAL_API 鉴权失败。常见业务码:405 AUTH_FAILED。 |
| 404 | 资源不存在。常见业务码:404 NOT_FOUND。 |
| 500 | 服务内部异常。常见业务码:500 ERROR。 |
postEndpoint
/api/athena/agent/tool/getDocContentcurl -X POST "https://b.163.com/api/athena/agent/tool/getDocContent" \ -H "Content-Type: application/json" \ -d '{ "spaceId": 123456, "docId": 987654 }'{
"code": 200,
"msg": "ok",
"message": "string",
"data": {
"title": "退款规则",
"type": "MARKDOWN",
"content": "string",
"downloadUrl": "https://example.com/download"
}
}{
"code": 200,
"msg": "ok",
"message": "string"
}{
"code": 200,
"msg": "ok",
"message": "string"
}{
"code": 200,
"msg": "ok",
"message": "string"
}{
"code": 200,
"msg": "ok",
"message": "string"
}这篇文档有帮助吗?