文档中心

火山引擎 Agent Toolkit

CLI 使用

在终端、脚本或能够执行命令的 Agent 中，使用 CLI 检索文档、查询 API 和操作云资源。ve 提供通用命令入口；需要产品专用流程时，通过相应 Skill 使用产品 CLI。希望配置 MCP 工具连接时，见“通过 MCP 接入 Agent”。

按任务选择工具

任务	入口	说明
通用云资源操作	ve <service> <Action>	先读取接口或实时帮助，再执行查询与变更。
官方文档查询	ve docs search / ve docs fetch	查询公开文档，无需云账号登录。
TOS 文件操作	ve tosutil	按 volcengine-tosutil 使用产品命令。
方舟模型与产品任务	ve arkcli	按 Ark 官方 Skills 执行模型、接入、用量和诊断等任务。
日志服务与日志采集	ve volclog	按 volcengine-tls 或 volcengine-tls-logcollector 查找可用操作，读取操作说明并按步骤执行。
veFaaS、Supabase 等专项任务	对应 Skill 指定的产品工具	工具名称、安装和授权按相应 Skill 说明，不推定它们都有 ve 代理命令。

首次使用与版本

先运行 ve version。当前 volcengine-cli Skill 要求 ve 1.1.11 或更高版本；通过 MCP 接入时，已验证版本为 ve 1.2.2，还需按“通过 MCP 接入 Agent”检查六项工具及调用结果。Skill 的最低版本要求不代表该版本已覆盖全部 MCP 工具。对应产品代理入口不存在时先升级 ve。ve 从 PATH 或托管目录解析产品工具，工具缺失时按当前实现从官方来源准备并校验。独立安装的工具也可能被优先选中。

只检查当前任务需要的工具，不为一个任务安装所有产品 CLI。原生 API 参数、输出格式和通用 flags 不直接套用到被代理的产品命令。

认证

ve 的 Profile 与产品 CLI 的 Profile 可能属于不同配置体系。按实际选中的产品工具确认身份、地域和访问范围，不把 ve sts GetCallerIdentity 成功当作所有产品都已认证。

更新

ve 托管工具可按当前帮助使用 ve proxycli upgrade tosutil、ve proxycli upgrade arkcli 或 ve proxycli upgrade tls-cli。TLS 的管理标识是 tls-cli，调用入口是 ve volclog。外部 PATH 安装由其原包管理器维护，升级 ve 不代表同时升级全部产品工具。

完整安装与通用命令说明见火山引擎 CLI 文档；产品参数按对应 CLI 实时帮助与官方文档确认。

使用 Ark CLI 完成方舟任务

模型接入、Managed Agents 和方舟用量账单由 Ark 官方 Skills 指导。可使用独立 arkcli，或通过 ve arkcli 调用产品命令；两种入口都需核对实际解析的版本与 Ark 认证，不把 ve 原生 API 参数直接传给产品命令。

先按安装与配置准备工具与本地 Skills，再进入模型与智能体管理。本地 +connect 同步 Skills，不等于云端 Agent 已创建或业务 Skills 已挂载。

最近更新时间：2026.10.29 15:14:48

这个页面对您有帮助吗？

有用

无用