文档中心

火山引擎 Agent Toolkit

场景指南

云资源查询与盘点

通用云资源查询与盘点由 volcengine-cli 承接。Agent 会先确认身份和地域，再通过 ve 执行经 Skill 或 API 规格确认无副作用的只读 Action。

示例输入

开始前准备

如果使用指定 Profile，请在整个任务中保持一致，并明确目标地域。

处理过程

检查 ve 和当前身份。

根据服务和 Action 读取实时帮助或 Swagger，确认参数结构。

确认接口语义和参数没有副作用，并按下方确认规则执行只读操作；不能只根据 Describe、List、Get 或 Query 等名称判断。

同时检查退出码和 ResponseMetadata.Error。

异步状态查询会继续检查到稳定状态后再返回结果。

确认点

首次调用 ve 原生 API 前，Agent 运行 ve configure safety-policy show。策略已启用且规则非空时，只读和写操作均按 CLI 的 allow、confirm、deny 判定执行，不再叠加内置确认；confirm 需要展示目标、参数和影响，取得用户确认后仅对原命令单次追加 --yes 重试，deny 则停止。策略关闭、规则为空或版本不支持时，使用 Skill 内置确认：经核实无副作用的只读查询可直接执行，创建、修改或删除资源前展示目标、参数和影响并等待确认。策略读取失败或格式错误时停止，不静默回退。任务转交产品代理命令或其他专业 Skill 时，按对应 Skill 和工具的规则执行。

预期输出

实际使用的 Profile、账号、地域、服务和 Action，以及查询范围、分页完成情况和未取得的信息。

资源列表、详情或明确的空结果；仅对当前权限与产品接口下实际覆盖的范围做汇总，不据此宣称已完成所有账号、所有地域或全部云产品的资源盘点。

业务失败时保留 ErrorCode、RequestId 和必要的诊断上下文。

查询运行中的服务器

可以直接描述：“帮我看看指定账号和地域还有哪些 ECS 服务器在运行，只查询，不停止或释放资源。”Agent 使用 volcengine-cli 核对 ECS 查询接口、运行状态及分页，输出实例清单和查询范围。只查看部分地域或部分页时，不能声称已经盘点全部资源。

查询账户余额

可以直接描述：“帮我查当前火山账号还有多少余额，只查询，并解释返回的余额字段。”该任务可由 volcengine-cli 调用余额接口承接，不需要独立的余额 Skill；涉及欠费或余额异常时可转 volcengine-troubleshooting。

执行前检查当前身份和余额查询权限，并读取 QueryBalanceAcct 的官方规格与帮助。返回后说明字段含义、币种、查询时间和请求标识；可用余额、现金余额、欠费及账单金额不能混用。接口失败或未取得某字段时如实说明，不补造余额。

volcengine-sale 主要承接询价、购买和开通，不负责余额查询不代表整个 Toolkit 不支持。已发生的方舟费用见方舟用量与费用分析，跨账期费用变化见云费用波动分析。

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

这个页面对您有帮助吗？

有用

无用