SuperAPI AI 工具集

byted-vms-voice-notify

办公与效率

查看项目

更新于 10-15 17:30

技能介绍

用途:在用户提到「语音通知 / 语音播报 / 自动外呼通知 / 语音提醒」并给出被叫号码与播报内容时调用,封装火山云通信 TOP 语音通知接口,默认走 SingleBatchAppend 单次发送,仅在明确要求「创建批量任务 / 任务化外呼 / 定时外呼」时改用 CreateTask。

主要能力:单次发送与结果查询、取消;批量任务创建、追加号码(单次不超过 1 万)、暂停、恢复、停止、更新参数(执行窗口、并发、重呼策略、禁呼时段);号码池查询;TTS 模板创建、删除、查询(改名改文案需走控制台);录音查询、删除与直传(get_upload_url → 客户端 PUT → submit_upload);通用资源列表、可用资源、改名、删除。本 skill 是所有 TTS / 录音 / 通用资源操作的唯一入口,byted-vms-configure 不再提供这些接口,只保留风控黑名单、可呼性与鉴权查询。

使用方式:鉴权按优先级解析,ARK_SKILL_API_KEY + ARK_SKILL_API_BASE(火山引擎 arkclaw 企业版,由 arkclaw 注入)优先,其次 VOLC_ACCESS_KEY + VOLC_SECRET_KEY(兼容 VOLCENGINE_ACCESS_KEY/VOLCENGINE_SECRET_KEY,脚本本地做 HMAC-SHA256 Volc V4 签名),否则报错并提示填入 AK/SK。核心命令为 python3 scripts/send_voice_notify.py 配合子命令,如 single_append、create_task、list_resource、list_number_pool、open_create_tts、delete_tts、query_single、cancel_single、batch_append、pause_task、resume_task、stop_task、update_task、get_upload_url、submit_upload、query_voice、delete_voice、list_usable、update_resource、delete_resource。

流程与限制:未指定资源时先 list_resource 按关键词查找;未指定号码池时取第一个 NumberCount > 0 的池,没有则需购买号码。定制化模板诉求(涉及语速、音调、音量、音色等但未给出具体参数值)必须先引导用户前往控制台手工配置,仅当用户已给出文案加语速、音调、音量等完整参数时才可调用 open_create_tts,模板需审核后使用。录音注册统一走直传两步法,旧的 create_voice 子命令已弃用,调用返回 ApiNotSupported。失败时脚本输出 errorCode 与 suggest;账号未实名、资质未通过、缺号码池或资源、鉴权失败均有对应引导。参数传递与通用规范详见内置文档 references/vms-fundamentals.md。