获取 Luma Agent 绑定的知识库中指定文档的临时下载地址，默认有效期一小时。
接口说明
获取 Luma Agent 绑定的知识库中指定文档的临时下载地址，默认有效期一小时。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| AgentName |
string |
是 |
Agent 名称 |
my_agent |
| Catalog |
string |
是 |
Agent 已绑定的数据目录名称。可通过 ListLumaCatalogs 获取 |
my_catalog |
| Namespace |
string |
是 |
Agent 已绑定的命名空间名称。可通过 ListLumaNamespaces 获取 |
my_namespace |
| KnowledgeBaseName |
string |
是 |
Agent 已绑定的知识库名称。可通过 ListLumaKnowledgeBases 获取 |
my-knowledge-base |
| DocumentId |
string |
是 |
文档的唯一标识。可通过 ListLumaDocuments 获取 |
doc-a1b2c3d4 |
| NetworkType |
string |
否 |
取值：public（公网）、vpc（内网）。不传时默认公网 |
public |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| Message |
string |
接口返回的提示信息，成功时为 Operation success，失败时为具体错误描述 |
Operation success |
| RequestId |
string |
本次请求的唯一标识，用于问题排查与工单反馈 |
34AD682D-5B91-5773-8132-AA38C130**** |
| Data |
object |
文档原文的预签名下载 URL 信息 |
|
| DownloadUrl |
string |
文档原文的预签名下载 URL，短时间内有效 |
https://my-bucket.oss-cn-hangzhou.aliyuncs.com/kb/doc-bp1xxxxxxxxxxxx?Expires=1788000000&Signature=xxxx |
| ExpireAt |
string |
下载 URL 的过期时间（UTC） |
2026-08-24T12:00:00Z |
| Code |
string |
接口返回码，Success 表示成功，失败时为具体错误码 |
Success |
| Success |
boolean |
本次调用是否成功，true 表示成功 |
true |
示例
正常返回示例
JSON格式
{
"Message": "Operation success",
"RequestId": "34AD682D-5B91-5773-8132-AA38C130****",
"Data": {
"DownloadUrl": "https://my-bucket.oss-cn-hangzhou.aliyuncs.com/kb/doc-bp1xxxxxxxxxxxx?Expires=1788000000&Signature=xxxx",
"ExpireAt": "2026-08-24T12:00:00Z"
},
"Code": "Success",
"Success": true
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidParameter | The specified parameter is invalid | |
| 403 | ServiceNotEnable | Service not enable | |
| 404 | AgentNotFound | Agent not found | |
| 404 | ResourceNotFound | The specified resource is not bound to the agent |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。