文档中心>腾讯云智能体开发平台>应用接口文档>腾讯云智能体开发平台操作 cos 指南

腾讯云智能体开发平台操作 cos 指南

最近更新时间:2025-07-30 17:30:32

我的收藏

核心差异说明​​

腾讯云智能体开发平台(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"。