SuperAPI AI 工具集

byted-sms-sender

办公与效率

查看项目

更新于 10-15 17:30

技能介绍

用途:通过火山引擎发送和管理国内短信,覆盖验证码、通知、营销短信,以及服务开通引导、资质申请、签名与模板申请、发送记录、回执、送达率和失败原因查询。

主要能力:查询消息组、资质、签名和模板;资质申请向导(含营业证件上传识别、经办人/责任人/法人材料填写);单发与群发;发送状态与回执查询;送达率、成功率与失败原因分析。

使用方式:业务统一通过 python3 -B <skill目录>/scripts/sms_cli.py 执行,不绕过脚本直接调用写 Action。首次调用或鉴权失败时读取 auth-setup.md,执行 auth-doctor 并跟随唯一 error.remediation;首次业务调用执行只读 list-message-groups,仅 RE:0001 时读取 service-onboarding.md。按任务读取 actions.md、application-contracts.md、qualification-materials.md、delivery-contracts.md、workflows.md、rules.md 等最小参考集合。申请流程为 *-preview → 客户确认 → *-submit;单发为 match-template → send-preview → 客户授权 → send-submit → send-status;群发为 batch-template-demo / batch-precheck → batch-create → batch-launch-preview → 指定任务授权 → batch-launch-submit,管理用 batch-detail、batch-list、batch-cancel;分析用 analytics,需要消息级证据时加 --include-logs。

适用场景:需要在国内发送验证码、通知或营销短信,或办理短信服务开通、资质、签名、模板及查询发送效果时。

限制:默认客户不使用终端,Agent 负责安装、登录、命令和清理,客户只操作浏览器并确认业务写入;除非客户询问,不展示命令、JSON、CLI、Profile、HOME、AK/SK 或沙箱。鉴权只执行 remediation,同一时间一个登录会话;AK/SK 仅在客户主动选择时提示一套 VOLCENGINE_* 变量。资质敏感材料只在本机向导填写,Agent 读取掩码后的 QUALIFICATION_EXCHANGE 和 QUALIFICATION_FAILURE 排查。申请、发送和任务启动基于当前预览授权,字段变化后需重新预览。可能已发出的写请求不重试、不切换调用路径,返回 outcome_unknown 并按契约对账。创建或启动群发不代表送达,只有公开发送日志是消息级证据。最终输出不包含完整个人信息、图片、文件地址、凭证、ticket、Authorization 或签名 URL 查询参数,保留公开 Request ID 和错误码,不推断内部原因。