用途:当用户希望「让 AI 机器人帮忙打电话办事」时调用,例如预订餐厅、催缴欠费、满意度回访、问卷调查,以及查询此前外呼任务结果。
主要能力:脚本内置三个动作。list_scripts 查询可用话术(GET,无参或可选 --scene);create_task 创建外呼任务(POST,PhoneList 为对象数组,由脚本根据 --phone-list 与 --variable-values 构造);query_task 查询任务进度与通话结果(GET)。创建任务后返回 TaskId,无需选择号码池,平台按话术绑定的默认号码池自动选号;查询结果包含任务进度、通话明细(含 ASR、意图标签、通话时长等)。
使用方式:先按优先级解析鉴权。其一为 ARK_SKILL_API_KEY 加 ARK_SKILL_API_BASE,对应火山引擎 arkclaw 企业版,需在火山后台配置 AK/SK 并由 arkclaw 注入这两个环境变量,脚本以 Bearer 鉴权直连网关,无需本地签名;其二为 VOLC_ACCESS_KEY 加 VOLC_SECRET_KEY(兼容 VOLCENGINE_ACCESS_KEY 与 VOLCENGINE_SECRET_KEY),对应个人版 arkclaw、openclaw、coco、aime、claudecode 等普通 agent,由用户把 AK/SK 告知 agent,脚本本地做 HMAC-SHA256(Volc V4)签名;两者皆无则报错并提示填入 AK/SK。标准流程为:从用户语义抽取目标号码、任务意图与关键变量;用 list_scripts 匹配话术,若无匹配则给出已有话术列表供选择,或提示前往控制台创建话术;再调用 create_task 创建任务并获取 TaskId;后续用 query_task 拉取进度与明细。
限制与兜底:RESOURCE_NOT_FOUND 表示话术不存在,应返回当前可用话术列表;鉴权失败需提示检查 AK/SK,普通 agent 检查 VOLC_ACCESS_KEY/VOLC_SECRET_KEY,企业版需确认后台配置已完成后 ARK_SKILL_API_KEY/ARK_SKILL_API_BASE 已注入。调用任意 action 前(尤其构造 create_task 的 PhoneList/VariableValues)应先阅读内置本地基础知识文档 references/vms-fundamentals.md,其中涵盖 SubServiceType 枚举、号码状态映射、CallId 格式、录音 CDN、出口 IP 白名单等所有 vms-* skill 共用规范;该文件在外网受限环境也可用,性能优于远程拉取。