离线文档是长期进入“知识管理”的资料，和对话框里临时上传的实时文档不同。腾讯云官方流程把它分成三段，每一段的返回值都是下一段的输入。
三步流程与关键字段
离线上传固定分成三步：取临时密钥、上传 COS、调用 SaveDoc。
- 每个文件都重新调用 DescribeStorageCredential，填写真实文件后缀和 BotBizID；离线文档的 TypeKey 使用
offline，IsPublic 使用false。 - 使用返回的 TmpSecretId、TmpSecretKey、Token 与 UploadPath，通过 COS SDK 上传。上传对象 key 必须等于 UploadPath。
- 调用 SaveDoc 保存元数据。SaveDoc 的 CosUrl 使用返回的 UploadPath，CosHash 与 Etag 使用 COS 上传响应头中的真实值。
为什么不能用固定密钥示例直接替换
官方文档明确区分 API Explorer 常见的固定密钥示例与本流程的临时凭证。临时凭证有有效期且权限受限，不能只复制 SecretId/SecretKey 而漏掉 Token。也不要把密钥写进前端或日志。
SaveDoc 后怎样验收
上传后在知识管理中找到文档，并检查解析状态、文件名和版本是否正确。再用文档内一个唯一短语做检索测试，确认能打开对应原文。只有 COS 上传成功而未调用 SaveDoc，平台不会自动把对象当成知识文档。
常见失败
- 403：临时密钥过期、Token 漏传或 key 不等于 UploadPath。
- 若 SaveDoc 报校验错误，优先核对 CosHash、Etag 和上传响应头。
- 文档进了错误空间：核对 BotBizID、TypeKey 与当前工作空间。
本文未使用你的凭证上传文件；字段、格式限制和临时密钥有效期可能更新，应以接口返回为准。
三步业务流程见离线文档上传官方说明，COS 临时凭证差异见ADP 操作 COS 指南。
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/32226.html
