首次使用只需完成任务一：查询一次公开文档，验证 Agent 能找到并调用相关能力。该任务无需云账号凭据，也不会创建资源。后续可按目标选择方舟模型、Managed Agents、费用查询、云资源查询或部署分析。涉及模型请求或资源创建的任务，应先确认权限、范围与费用。

开始前准备

已安装的核心 Skills 可以被 Agent 发现并在当前对话加载。Agent 能运行 ve、访问公开文档服务，并允许 CLI 读写当前用户的 ~/.volcengine 目录；若被沙箱拦截，按提示授权所需操作后重试，不需要为公开文档查询配置云账号凭据。

任务一无需云账号认证。仅执行可选的任务二时，才需提前完成认证，并确认 ve sts GetCallerIdentity 能返回当前身份，且不包含 ResponseMetadata.Error。

任务一：查询官方文档

向 Agent 输入：

Agent 应使用 volcengine-knowledge-search，返回相关官方页面、来源链接和基于文档整理的说明。该任务不需要云账号认证。

验证结果

任务二：执行只读云资源查询（可选）

先检查本地工具和身份：

然后向 Agent 输入：

Agent 应使用 volcengine-cli，先读取实时帮助或 API 规格，再执行查询。结果需要同时检查进程退出状态和 ResponseMetadata.Error，不能只根据 HTTP 或退出码判断成功。

验证结果

任务三：分析部署方案（可选）

该任务需要按需安装的 volcengine-prepare。如果尚未安装，可先让 volcengine-find-skills 查找并安装；如果当前 Agent 不能动态加载新 Skill，请新建任务后在本地项目根目录输入：

Agent 应使用 volcengine-prepare 分析代码仓库，返回可部署服务面、路径排序和 CLI/IaC 建议。分析阶段不创建云资源。

验证结果

选择下一项任务

目标	示例需求	验证重点
接入方舟模型	为当前应用接入文本模型，优先检查可复用的接入点，确认后测试一次请求	已加载 Ark Skills；接入配置有效；实际请求得到预期响应
创建和管理 Managed Agents	创建一个文档问答智能体，Skills 稍后提供；先展示配置和费用影响	云端配置、环境与测试会话分别验证，不把本地 Skill 安装当成云端挂载
查询方舟用量与费用	查询上一个完整月的模型用量与结算金额，说明时间和归属范围	实际用量与已结算金额分列；未出账和无权限不按零处理
分析云费用变化	比较最近两个完整账期，解释费用变化，只分析不变更资源	查询范围一致，结论有工具结果支持

方舟任务先按安装与配置准备按需 Skills 与工具。需要正式部署时，使用 volcengine-deploy，并在资源创建前确认部署计划。执行失败时，使用故障诊断收集证据。