核心差异说明
腾讯云智能体开发平台(Tencent Cloud ADP)内置的 COS 服务与客户自购 COS 的主要区别如下:
1. 存储归属
Tencent Cloud ADP 的数据存储在平台的 COS 中,无需单独购买存储服务,费用按字符计费。
不支持将文件上传至客户自购的 COS 中。
2. 权限控制
平台通过临时密钥实现细粒度权限管理,避免越权操作影响其他用户数据。
说明:
使用腾讯云智能体开发平台 Tencent Cloud ADP 产品,不需要购买 COS , 不支持将文件上传到自己购买的 COS 中。
操作流程对比
操作步骤 | 腾讯云智能体开发平台内置COS | 客户自购COS |
1. 密钥获取 | 使用购买时获得的固定密钥(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"} | |
文件下载 | {"BotBizId":"182693390xxxx", "IsPublic":false} | 无需指定文件类型 |
常见问题
❓ 为什么需要临时密钥?
平台通过动态权限隔离用户数据,保障安全性。
❓ 参数填错怎么办?
检查场景是否匹配(如上传图片需 IsPublic:true),或在对应操作页面通过抓包工具核对接口入参。
❓ 能否跨场景混用参数?
禁止混用。例如:离线文档上传不可使用 TypeKey:"realtime"。