用途:以 ve 作为统一入口调用火山引擎 OpenAPI,覆盖 ECS、VPC、CLB、RDS、Redis 等服务,并委派 TOS 对象操作、Ark 产品流程、TLS 日志服务流程。
主要能力:原生 OpenAPI 调用形式为 ve <service> <Action>,支持 --profile、--region、--endpoint、--output、--query、--body、--force 等系统参数;产品入口包括 ve tosutil、ve arkcli、ve volclog,分别处理对象存储、Ark 模型与日志服务,需先加载对应产品技能(如 volcengine-tosutil、volcengine-tls)再执行。
使用方式:先运行 ve version 要求 ve >= 1.1.11;安装可用 npm i -g @volcengine/cli,或 CDN 安装 curl -fsSL https://cloudcache.volccdn.com/ve/install.sh | sh。Agent 每次执行须设置 VE_CALLER_TYPE=ai_agent、VE_CALLER_NAME、VE_SKILL_NAME,且不要为 arkcli 额外添加 ARKCLI_* 变量。先用 ve sts GetCallerIdentity 确认身份;未显式选 profile 时不得自行挑选,登录统一走 scripts/ve_login_remote.sh,不要直接调用 ve login。
限制:委派子命令仅替换可执行前缀,子参数保持不变;原生 API 的 --output、--query、--force 等规则不适用于子 CLI。若 ve volclog 报未知服务,应升级 ve 而非加 --force。升级受管子命令用 ve proxycli upgrade 加产品 ID(如 tls-cli)。Windows 建议用 npm 或 GitHub Releases:https://github.com/volcengine/volcengine-cli/releases。