Agent Skills
返回列表
Auto-API 接口与报表自动化

Auto-API 接口与报表自动化

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 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