文档中心

火山引擎 Agent Toolkit

Skills 与能力目录

volcengine-tosutil

把对象存储 TOS 的桶和对象操作意图转换为安全、可执行、可校验的 tosutil 流程。

你能用它做什么

桶/对象列举、上传下载、复制删除、元数据、容量统计，以及 403、网络和参数问题。

开始前准备

项目	说明
执行工具	ve tosutil 是 TOS 产品 CLI 的代理入口，沿用原生参数、认证和输出。Skill 内置的 Python 脚本 scripts/main.py 是另一条调用路径，提供预览、显式执行和结构化结果；不要将脚本参数直接传给 ve tosutil。
安装关系	使用 ve tosutil 时按当前 ve 的产品工具管理方式准备二进制。使用 Python 脚本时，需准备 Python 及可执行的 tosutil；脚本默认调用 PATH 中的 tosutil，也可用 --tosutil-binary 指定二进制路径。两条路径不能默认视为已经互通。官方二进制应匹配操作系统和芯片架构，并完成校验。
认证	支持永久密钥、STS 临时密钥和匿名访问；输出不回显 AK/SK/Token。

示例提示词

预览把本地目录批量上传到 TOS 的命令。

分析 tosutil 返回 403 的原因。

删除前先统计目标对象。

执行过程与结果

先确认使用 ve tosutil 代理入口还是 Python 脚本，检查对应工具、地域和产品认证配置，并核对桶、对象前缀、本地路径和递归范围。

区分查询与变更，生成可复现命令。Python 脚本默认只生成预览；直接运行 ve tosutil 遵循原生命令行为，不提供脚本的默认预览保证。

通过 Python 脚本执行时，显式传入脚本的 --run；删除等破坏性操作还需确认并传入脚本的 --yes。通过 ve tosutil 执行时，按产品命令和 Skill 的确认规则处理，不能套用上述脚本参数。

Python 脚本返回脱敏 JSON 摘要、命令和诊断信息；ve tosutil 保留产品 CLI 的原生输出。Agent 根据实际返回核对成功项、失败项与后续处理。

项目	说明
输入	操作类型、tos:// 地址或本地路径、递归选项，以及可选地域和配置。
输出	Python 脚本：默认命令预览，执行时返回脱敏 JSON 摘要和诊断信息。ve tosutil：产品 CLI 原生输出，不保证统一 JSON 格式。

操作确认与安全

Python 脚本默认只生成预览；--run 控制实际执行，删除等破坏性操作还需用户明确确认及脚本的 --yes。这些参数仅属于脚本，不是 ve tosutil 的安全开关。产品代理命令不由 ve 原生 OpenAPI 安全策略覆盖，仍须按 TOS Skill 和产品 CLI 的规则核对范围并确认风险。

使用限制

百万级对象执行 du 可能耗时较长；递归和批量删除需要额外评估。