Auto-API 接口与报表自动化
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_47fda023/g-2。
技能介绍
要解决什么问题
业务系统往往把能力藏在 OpenAPI 文档和后台里:话务报表、坐席报表、CDR 导出、质检报表、通用列表导出等,都需要先找对 API 名称、参数大小写和 daterange 格式,再处理登录与签名。手工查文档、拼请求、落 Excel,既慢也容易因漏参或误传可选字段把整段数据拉错。
技能如何工作
技能把执行拆成固定顺序:检测 meta.json(need、Key、ApiUrl、ApiList、ApiUseInfo 等必填项;仅 Choose 可空)→ 登录(WeCall 流程必需;cli 固定为 ai)→ 按任务走执行清单。
Choose 决定两套安全策略:
- WeCall(
Choose="WeCall"):删除类操作直接拦截;报表与 CDR 等走export_manager里封装函数(如generate_traffic_report、export_cdr、download_report、generic_export)。 - 通用(
Choose=""):删除类需用户明确回复「确认」;调用以call_api/generic_export为主,把响应键下的数据导出为 Excel。
调用前技能要求对照 ApiList 文档核对参数名、类型、必填性与数组格式;必填参数未给出会先追问,可选参数不设默认值;报表与会话类任务 必须先有 daterange(起止用 , 分隔,禁止 ~)。
适用边界与注意点
- 不会替你「猜」项目 ID、任务 ID 或配额:需通过
search_projects、search_rules等辅助函数或用户提供。 - WeCall 与通用流程对危险操作的约束不同,改
meta.json前会展示前后对比,需你确认后才写入。 - 隐私与账号:换号会清空
session_state.json/wecall_credentials.json后重新登录;敏感数据不应在对话中随意扩散。
使用场景
- 话务运营需在指定 `daterange` 内按项目/任务 ID 生成话务或坐席话务报表并下载 Excel
- 质检主管要导出某段时间的智能质检或常规质检报表,并核对 `rule_id`、配额等 GetReport 可选参数
- 运维或数据同事要把某任务下的会话记录导出为 CDR,或按号码模板条件 `build_sample` 后带 `sample` 条件导出
- 已配置 `ApiUrl` 与 `ApiList` 的业务系统里,用 `generic_export` 按文档方法名拉列表并映射列标题导出
适合人员
- 呼叫中心项目经理:经常按项目/任务查 `search_rules` 并批量下载话务、监控类报表
- 质检与培训负责人:按周期导出质检报表,需严格区分时间段且不愿手写 API 参数
- WeCall 平台实施或二线支持:帮客户配置 `meta.json`、登录与换号,并拦截删除类误操作
- 对接自建 OpenAPI 的后台开发:走通用 `Choose=""` 流程,把 `GetUserList` 等接口结果落成 Excel