SuperAPI AI 工具集

byted-vms-number-pool

通用与其它

查看项目

更新于 10-15 18:28

技能介绍

用途:火山云通信(VMS)通用能力层 Skill,统一管理号码池、号码、资质三类资源,也作为 byted-vms-voice-notify、byted-vms-aicall、byted-vms-secret-number 等业务层 Skill 的预检复用组件。

鉴权:按优先级解析。优先使用 ARK_SKILL_API_KEY 与 ARK_SKILL_API_BASE(火山引擎 arkclaw 企业版,由 arkclaw 注入,Bearer 直连网关,无需本地签名);其次使用 VOLC_ACCESS_KEY 与 VOLC_SECRET_KEY(兼容 VOLCENGINE_ACCESS_KEY/VOLCENGINE_SECRET_KEY),脚本本地做 HMAC-SHA256(Volc V4)签名;否则报错并提示填入 AK/SK。

主要能力(命令示例):查号码池 python3 scripts/number_pool.py list_pool [--sub-service-type 102] [--name 北京],默认语音通知为 102,智能外呼 104,隐私号 201~206;创建号码池 create_pool --name ... --sub-service-type 102 --qualification-id ...;更新号码池 update_pool --number-pool-no ...;查池下号码 list_number --number-pool-no ...;按手机号反查 query_number --phone ... [--sub-service-type 201];查申请记录 query_apply_record;启停号码 toggle_number --enable true;提交资质 add_qualification --payload '{...}';上传资质材料 upload_qualification_file --file-url ... --file-type 1;查资质 query_qualification、list_qualification(支持主体名称/状态/类型筛选);更新资质 update_qualification。

限制:申请号码/购号未开放 OpenAPI 写入,apply_number 仅返回控制台引导,需前往指定控制台页面申请;资质 Status=0 待审核期间不能创建号码池,约 1 个工作日;业务层通过 Agent 触发本 Skill 命令并取回结果,不直接 import 本包 Python 代码。参数约束详见内置 references/vms-fundamentals.md。