OSS - 阿里云百炼 Agent Studio

OSS 连接器让智能体访问你自己的 OSS Bucket 中的文件。数据保留在 OSS，调用时实时读取，不产生副本。

前置条件

OSS 连接基于阿里云服务关联角色访问你的 Bucket，不需要配置 AccessKey。

首次使用前需要初始化服务关联角色。连接对话框中的 立即授权 会引导你完成这一步。

打开连接对话框

在 Apps 页面找到 OSS 卡片，单击连接。

填写基本信息

字段	是否必填	说明
连接器名称	是	使用易于识别的名称，最多 64 个字符
连接器描述	否	说明这个 Bucket 存了什么内容

完成授权

首次连接时单击 立即授权，按界面提示初始化服务关联角色。

选择存储 Bucket

在 存储 Bucket 选择 下拉列表中选择目标 Bucket。列表只展示当前账号有权限访问、且已完成授权的 Bucket。下拉列表为空时，先确认授权是否完成、Bucket 标签是否已添加。

确认创建

单击确认完成连接。

阿里云百炼通过 Bucket 标签判断是否允许访问。Bucket 必须带上这个标签：

用途	标签键	标签值
作为 OSS 连接器访问 Bucket 文件，或作为文件连接器的 OSS 批量导入来源	`bailian-datahub-access`	`read`

标签缺失或值写错时，Bucket 不会出现在下拉列表中，或连接创建失败。报错信息有时会指向跨域配置，实际原因通常是标签问题，先核对标签再排查其他方向。

标签在 OSS 控制台的 Bucket 管理页面添加。

连接成功后，Connector 会生成访问 Bucket 文件的工具。在 App 详情页的 可用的工具 区域展开工具即可查看实际的入参与出参。

OSS 在 Connector 中出现在两个位置，用途不同：

路径	数据位置	适合场景
OSS 连接器	保留在 OSS	智能体实时读取 Bucket 中的文件
文件连接器的 OSS 批量导入	副本存入平台	一次性把 Bucket 里已有的文件导进平台

从 OSS 读取数据会产生 OSS 侧的下行流量费用，由 OSS 按其计费规则收取，与 Connector 的用量分开计算。同一 Bucket 被频繁读取时，这部分费用会比较明显。