文档中心

火山引擎 Agent Toolkit

Skills 与能力目录

volcengine-cli

通过 ve 命令调用火山引擎 OpenAPI，创建、查询、修改和删除云资源，并按任务使用 ve tosutil、ve arkcli 和 ve volclog 等产品工具。

你能用它做什么

通用云资源查询与操作，或你直接提到 ve、云服务器 ECS、私有网络 VPC、云数据库 RDS、缓存数据库 Redis 版等基础资源。

开始前准备

项目	说明
执行工具	ve，以及按任务选用的 ve tosutil、ve arkcli 和 ve volclog。产品工具遵循各自的参数、认证与输出规则。少量未由 ve 暴露的扩展 API 使用 Skill 内置脚本。
安装关系	skills-setup 可自动安装 ve；也可运行 npm install -g @volcengine/cli，或从 GitHub Releases 安装。当前 Skill 要求 ve 1.1.11 或更高版本；使用 MCP 时另按 MCP 接入说明检查版本与可用工具。首次使用时只准备当前任务所需工具；Agent 的调用来源标识由 Skill 指引处理，无需在安装时手动配置。安装后运行 ve --version 验证。
认证	ve 默认 Console Login，也支持 AK/SK、STS 和 SSO；一次对话内固定 Profile，不由 Agent 自主切换。ve 的身份与 Profile 不自动等同于产品 CLI 的身份，执行前按选中工具分别确认账号、地域和资源范围。

示例提示词

列出当前账号下的 ECS 实例。

查询某个安全组的入方向规则。

创建 VPC 前先展示完整命令。

执行过程与结果

确认目标 Profile、地域和资源范围。

读取 ve --help 或 API 规格，确定 Action 和参数结构。

首次调用 ve 原生 API 前，运行 ve configure safety-policy show 检查策略。策略已启用且规则非空时，按 CLI 的 allow、confirm、deny 判定执行，不再叠加 Skill 内置确认；策略关闭、规则为空或版本不支持时，使用 Skill 内置确认。策略读取失败或格式错误时停止调用，不得静默回退。

执行后同时检查退出码、业务错误和 RequestId；异步资源继续查询到稳定状态。

项目	说明
输入	你的目标、目标账号/Profile、地域、资源参数。
输出	API 返回结果、资源状态、RequestId，以及经过解释的执行结果。

操作确认与安全

CLI 策略返回 allow 时执行；返回 deny 时停止，不尝试绕过；返回 confirm 时展示命令、参数和影响，取得用户确认后，仅对原命令和原参数追加一次 --yes 重试。--yes 是确认参数，不是技术强制审批凭证。使用 Skill 内置确认时，经核实无副作用的只读操作可直接执行，写操作先确认，破坏性操作说明不可逆影响；支持 DryRun 时先预演。ve tosutil、ve arkcli、ve volclog 等产品代理命令不受原生 API 安全策略覆盖，按对应产品 Skill 和 CLI 的规则执行；其他专业 Skill 及其辅助脚本仍遵循各自的确认要求。

使用限制

不覆盖完整 CLI 命令手册；命令参数以 ve --help 和 API 规格为准。异步资源创建需要轮询最终状态。