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

2026-08-05   访问量:1010


核心差异说明

腾讯云智能体开发平台(Tencent Cloud ADP)内置的 COS 服务与客户自购 COS 的主要区别如下:

存储归属

Tencent Cloud ADP 的数据存储在平台的 COS 中,无需单独购买存储服务,费用按字符计费。

不支持将文件上传至客户自购的 COS 中。

权限控制

平台通过临时密钥实现细粒度权限管理,避免越权操作影响其他用户数据。

说明:

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


热门文章
更多>