功能概述
COS Agent 智能工作台是对象存储(Cloud Object Storage,COS)提供的智能交互工具。您可以通过自然语言查询存储资源、了解配置和用量,也可以选择 COS 中的文件,使用数据万象(Cloud Infinite,CI)进行图片处理、内容识别、文档转换和智能检索。
本文介绍工作台的使用方法,并提供资源盘点、成本分析、图片处理等常见场景的操作示例。
工作台支持以下功能:
功能 | 功能说明 | 提问示例 |
资源查询与导出 | 查询存储桶、文件及相关配置,并将查询结果整理为 CSV 文件。 | 列出最近创建的10个存储桶,并导出名称、地域和创建时间。 |
成本分析 | 结合单个存储桶上一个完整自然月的费用、用量和生命周期配置,提供优化建议。 | 分析这个存储桶上个月的费用和用量,并提出优化建议。 |
配置风险分析 | 结合访问权限、防盗链等配置,说明潜在风险及改进方向。 | 检查这个存储桶的公开访问权限和防盗链配置。 |
图片处理与内容识别 | 添加文字水印、转换图片格式、识别图片文字和内容。 | 给这张图片添加文字水印“示例品牌”。 |
文档处理 | 将支持的办公文档转换为 PDF,并获取文档在线预览入口。 | 把这份 Word 文档转换成 PDF。 |
媒体处理 | 为视频生成封面、转换视频格式、查询媒体信息或处理音频噪声。 | 为这段视频生成一张封面。 |
智能检索 | 在已建立相应索引的数据集中,按内容描述查找图片,或按元数据条件筛选文件。 | 查找画面中包含蓝天、白云和草地的图片。 |
使用准备
使用前,请根据任务准备以下条件:
账号与权限:已开通 COS 服务,且当前登录账号具有目标资源的相应操作权限。查询配置、读取文件、写入处理结果和查看费用所需的权限不同。使用子账号时,请由管理员按任务需要授权。
待处理文件:图片、文档、视频等文件已上传至 COS。工作台通过资源选择功能引用云上文件。本地文件请先在 COS 控制台上传,操作方式请参见 上传文件。
数据万象服务:执行数据处理任务时,需开通相应的数据万象服务,并满足目标存储桶的服务使用条件,详情请参见 通过 COS 使用数据万象。只查询 COS 资源时,无需开通数据处理服务。
文件和地域条件:不同数据处理功能支持的地域、文件格式、大小及并发限制不同,详情请参见 数据万象使用限制。图片检索还需准备数据集和索引,详情请参见本文的“按内容描述查找图片”。
费用说明
通过工作台调用数据万象功能,会产生数据处理费用和流量费用。处理结果保存在 COS 中时,会产生存储费用。
使用方法
步骤1:进入工作台
说明:
当前工作台面向中国站中文控制台提供,入口是否可用以控制台实际开放情况为准。
工作台首页如下图所示:

步骤2:选择资源
涉及具体存储桶或文件时,单击输入框中的 @,或在输入框中输入 @,打开资源选择面板。
资源选择面板支持以下资源类型:
资源类型 | 选择方式 | 适用任务 |
存储桶 | 在存储桶页签中查找并选择目标存储桶。 | 查询配置、分析成本、评估配置风险 |
文件 | 在文件页签中选择存储桶,并查找目标文件。 | 图片处理、文字识别、文档转换、媒体处理 |
收藏路径 | 在收藏路径页签中选择已收藏的路径。 | 围绕常用存储路径查询资源 |
选中后,输入框中会显示资源引用。发送前,请核对资源名称和所在存储桶。
查询账号下的存储桶列表等任务,无需预先选定存储桶,直接输入筛选条件即可。您也可以在问题中提供完整的存储桶名称、地域和文件路径。信息不足时,按对话提示补充。
资源选择面板如下图所示:

步骤3:描述任务并发送
在输入框中说明需要完成的任务,单击发送图标或按 Enter 键发送。例如,选中存储桶后输入:请说明这个存储桶当前的访问权限。
建议在提问中说明以下信息:
操作对象:要查询的存储桶、处理的文件或检索的数据集。
任务要求:需要查询、分析、转换或提取的内容。
范围和结果形式:时间范围、筛选条件、排序方式、输出字段或目标格式。
例如,“列出广州地域最近创建的10个存储桶,按创建时间倒序展示名称、地域和创建时间”,比“帮我整理一下资源”更便于确定查询范围。
步骤4:补充信息或确认操作
任务缺少必要信息时,工作台会在对话中提示您补充或选择。完成选择后,继续当前任务。
使用数据万象功能时,可能出现以下提示:
服务开通提示:对于符合开通条件、尚未启用所需服务的存储桶,请按提示核对服务和目标资源,再决定是否开通。账号首次开通或权限不足时,需先完成相应的服务开通或授权。
功能计费提示:阅读计费说明后,单击已知悉,继续执行继续任务,或单击取消任务终止任务。
计费提示如下图所示:

步骤5:查看结果并继续提问
任务完成后,在对话中查看查询结果、分析说明或处理结果入口。
查询和分析任务:查看表格、统计范围及建议。如有未获取的数据,请结合缺失项判断结果的适用范围。
文件处理任务:根据返回的文件位置或访问入口查看结果。文档转换、视频处理等异步任务需等待处理完成。
导出任务:通过对话中的下载入口获取文件,并检查字段和数据范围。
您可以在同一会话中继续提问,例如“解释一下这项配置的含义”或“把刚才的查询结果导出为 CSV”。切换到新的任务时,可新建会话。
常见使用场景
以下提问均为使用示例,请将资源和条件替换为您的实际需求。涉及具体文件的示例,均需先通过 @选择目标文件。
为图片添加文字水印
适用场景:为商品图、活动图等素材添加品牌文字。
1. 选择 COS 中的一张图片。
2. 输入内容:给这张图片添加文字水印“秋日影像”,保留原图,提供处理后的图片。
3. 按需完成服务开通或计费确认,等待处理结束。
4. 根据返回的结果入口查看处理后的图片,核对水印内容和显示效果。
需要转换图片格式时,选择图片后输入“把这张图片转换成 WebP,保留原图并提供转换后的图片”。
处理结果示例如下图所示:

按内容描述查找图片
适用场景:记得图片内容,但不清楚文件名称或路径。
使用前,需准备支持图片检索的数据集,并确保目标图片已完成索引。数据集用于管理文件的索引信息,仅将图片上传到 COS,尚不能直接按画面内容检索。
1. 确认待检索的存储桶,以及已准备好的图片检索数据集。
2. 选择目标存储桶。如果当前对话尚未明确要检索的数据集,请先补充数据集名称。明确范围后,输入内容:在这个素材库中查找有蓝天、白云和草地的图片,列出候选结果。
3. 如有多个候选数据集或缺少信息,按对话提示明确检索范围。
4. 查看返回的候选文件及可用的预览或访问入口,挑选需要的素材。
检索结果覆盖所选数据集中已完成索引的文件。未找到预期图片时,请先核对文件是否已入库、数据集模板是否匹配,再调整画面描述。
检索结果示例如下图所示:

将 Word 文档转换为 PDF
适用场景:将存储在 COS 中的办公文档转换为便于预览和分发的 PDF 文件。
1. 选择一份受支持的 Word 文档。
2. 输入内容:把这份文档转换成 PDF,方便分发。
3. 按提示完成必要确认,等待文档处理任务完成。
4. 根据返回的结果文件位置或访问入口打开 PDF,检查页面内容和排版。
任务仍在处理中时,可继续提问“查询刚才文档转换任务的状态”。“任务已提交”表示已发起处理,请在任务成功并取得结果文件后再使用 PDF。
文档转换结果示例如下图所示:

查询并导出存储桶列表
适用场景:盘点近期创建的存储桶,整理资源台账。
1. 在工作台中输入内容:列出广州地域最近创建的10个存储桶,按创建时间倒序展示名称、地域和创建时间。
2. 查看返回的列表,确认地域、排序和字段符合要求。
3. 在同一会话中继续输入以下内容:把刚才的结果导出为 CSV。
4. 通过回答中的下载入口获取 CSV 文件,核对名称、地域和创建时间三列。
结果仅覆盖本次查询范围。符合条件的存储桶不足10个时,按实际查询结果展示。回答提示部分数据未获取时,导出文件也需结合该范围使用。
存储桶列表查询结果示例如下图所示:

分析存储桶成本
适用场景:了解单个存储桶上个月的费用、用量及可能的优化方向。
1. 通过 @选择一个存储桶。
2. 输入内容:分析这个存储桶上一个完整自然月的费用和用量,并结合生命周期配置提出优化建议。
3. 查看回答中的统计月份、费用与用量信息、生命周期配置及相关建议。
4. 如需进一步理解某项建议,可继续提问:请解释生命周期配置与这项建议的关系,以及调整前需要确认哪些业务条件。
该场景按单个存储桶、上一个完整自然月进行分析。费用和用量是不同口径,未取得费用数据时,不能将用量直接作为费用金额。
需要调整生命周期等配置时,请结合业务要求在对应控制台页面操作。
评估公开访问与防盗链配置
适用场景:了解对外提供图片、视频等内容的存储桶是否存在潜在的外链盗刷风险。
1. 通过 @选择目标存储桶。
2. 输入内容:结合这个存储桶的公开访问权限和防盗链配置,分析潜在外链盗刷风险,并说明可以改进的配置。
3. 查看公开访问状态、防盗链配置及对应建议。请结合资源是否需要公开访问、业务访问来源等条件,决定是否调整配置。
该场景提供配置风险分析。公开访问或防盗链配置存在缺口,并不代表已经发生盗刷。分析建议不会直接修改配置。
提取图片中的文字
适用场景:将海报、通知等图片中的文字整理为可编辑文本。
1. 选择一张包含文字的图片。
2. 输入内容:提取图中文字,整理成可编辑文本。
3. 查看识别结果,对照原图核对日期、数字、专有名词等关键内容,再复制使用。
文字识别效果受图片清晰度、文字方向和排版等因素影响。需要了解画面内容时,可改为提问“描述这张图片中的主体、场景和明显细节”。
常见问题
找不到存储桶或文件怎么办?
请确认当前登录账号、存储桶所属地域和资源访问权限。文件选择功能引用的是 COS 中已有的对象,本地文件需先上传。资源已删除或路径发生变化时,请重新选择有效资源。
提示权限不足或服务未开通怎么办?
请先根据提示区分问题类型:
权限不足:请管理员检查当前账号是否具备资源读取、处理任务调用、结果写入或费用查询等对应权限。
服务未开通:按提示完成所需服务的开通。
开通服务不会替代账号权限授权。
为什么只有查询结果,没有下载文件?
如需文件,请在同一会话中明确提出,例如“将刚才的结果导出为 CSV”。成功生成文件后,对话中会提供下载入口。提示生成失败时,请保留已有查询结果,并按失败提示处理。
处理任务未立即返回结果怎么办?
文档转换、媒体处理等任务可能异步执行。请先查看回答中的任务状态,再在原会话中查询该任务的处理进度。任务失败时,请按错误提示检查文件格式、大小、服务状态和权限等条件。
工作台会直接修改存储桶配置吗?
普通 COS 资源管理以查询、分析和建议为主。创建、删除资源,以及修改访问权限、生命周期等配置,需要前往对应控制台页面操作。
数据万象处理任务可以生成结果文件,符合条件的服务开通也可在对话中确认后执行。
如何使用分析或识别结果?
请核对回答中的资源范围、时间范围和缺失信息。AI 生成的说明和建议可能存在偏差。涉及业务配置调整、内容审核或对外分发时,请结合实际数据和业务要求复核后使用。