SuperAPI AI 工具集

byted-vms-configure

智能体与模型

查看项目

更新于 10-15 17:30

技能介绍

用途:该 Skill 属跨业务通用查询/校验层,只封装火山云通信 TOP 的号码状态与鉴权类查询接口,包括风控黑名单 QueryRiskDenyInfo、号码可呼叫综合状态 QueryCanCall、主叫鉴权(Click2Call)QueryAuth。TTS 模板、录音文件及通用资源管理入口已迁至 byted-vms-voice-notify,本 Skill 不再包含。

主要能力与命令:

  1. 查号码是否命中平台风控黑名单:python3 scripts/configure.py query_risk_deny --mobile 13800138000,可选 --account-request-id、--encrypt-type 0|1。
  2. 批量查号码可呼性(号码归属/黑名单/禁呼时段等综合状态):python3 scripts/configure.py query_can_call --numbers 13800138000,13900139000,可选 --business-line-id、--call-type。
  3. 查主叫鉴权状态:python3 scripts/configure.py query_auth --phone <AES_ENCRYPTED_PHONE>,Phone 需 AES 加密后传入。

鉴权与环境变量:优先 ARK_SKILL_API_KEY + ARK_SKILL_API_BASE(火山引擎 arkclaw 企业版,网关 Bearer 鉴权,无需本地签名);否则用 VOLC_ACCESS_KEY + VOLC_SECRET_KEY(兼容 VOLCENGINE_ACCESS_KEY/VOLCENGINE_SECRET_KEY),脚本本地做 HMAC-SHA256(Volc V4)签名;都缺失则报错提示填入 AK/SK。

适用场景:外呼任务前的号码预检与批量过滤、Click2Call 主叫鉴权校验;风控或可呼性预检可作为业务下游前置步骤。

限制与错误:OperationDenied 表示语音服务未开通;NOT_AUTH 表示账号未实名;BLACK_LIST_PHONE 表示命中平台黑名单;鉴权失败提示检查 AK/SK。错误码映射见 scripts/_topclient.py 的 ERROR_MAP。参数规范、加解密、错误码、号码状态映射等见内置文档 references/vms-fundamentals.md,本地加载无外网依赖。