tencent cloud

腾讯云智能体开发平台操作 cos 指南
下载PDF
最后更新时间：2026-02-06 18:00:05
腾讯云智能体开发平台操作 cos 指南
最后更新时间： 2026-02-06 18:00:05
下载PDF

核心差异说明​​

腾讯云智能体开发平台（Tencent Cloud ADP）内置的 COS 服务与客户自购 COS 的主要区别如下：
1. ​​存储归属​​
Tencent Cloud ADP 的数据存储在平台的 COS 中，无需单独购买存储服务，费用按字符计费。
​​不支持​​将文件上传至客户自购的 COS 中。
2. ​​权限控制​​
平台通过临时密钥实现细粒度权限管理，避免越权操作影响其他用户数据。
说明：
使用腾讯云智能体开发平台 Tencent Cloud ADP 产品，不需要购买 COS , 不支持将文件上传到自己购买的 COS 中。

操作流程对比​​

​​操作步骤​​
腾讯云智能体开发平台内置COS​​
​​客户自购COS​​
​​1. 密钥获取​​
调用 DescribeStorageCredential 接口获取临时密钥
使用购买时获得的固定密钥（SecretId/Key）
​​2. 客户端初始化​​
通过临时密钥创建低权限 CosClient
通过固定密钥创建 CosClient
​​3. 数据操作​​
调用COS API（需临时密钥权限匹配）
直接调用COS API
注意：
临时密钥的参数组合错误会导致操作失败（如403权限不足）。

临时密钥参数配置指南​​

以下为常见场景的参数组合示例，请根据实际需求填写（​​标灰字段为必填​​）：
​​场景​​
​​参数组合​​
​​备注​​
​​知识库上传文档（离线）​​
{"BotBizId":"182693390xxxx", "FileType":"pdf", "IsPublic":false}
​​对话中上传文档（实时）​​
{"BotBizId":"182693390xxxx", "FileType":"pdf", "IsPublic":false, "TypeKey":"realtime"}
​​对话中上传图片​​
{"BotBizId":"182693390xxxx", "FileType":"jpeg", "IsPublic":true, "TypeKey":"realtime"}
图片必须设为IsPublic:true，参考实时文档解析
​​文件下载​​
{"BotBizId":"182693390xxxx", "IsPublic":false}
无需指定文件类型

常见问题​​

❓ ​​为什么需要临时密钥？
平台通过动态权限隔离用户数据，保障安全性。
❓ ​​参数填错怎么办？
检查场景是否匹配（如上传图片需 IsPublic:true），或在对应操作页面通过抓包工具核对接口入参。
❓ ​​能否跨场景混用参数？
禁止混用。例如：离线文档上传不可使用 TypeKey:"realtime"。

本页内容是否解决了您的问题？
您也可以 联系销售 或 提交工单 以寻求帮助。
是
否

文档反馈