SuperAPI AI 工具集

cawplan-support-metrics

数据与分析

查看项目

更新于 10-15 20:11

技能介绍

用途:该技能用于受控的 Support Ops 到 CawPlan 关键指标工作流,将通用 cawplan metrics 命令特化为固定的 Support 数据契约,处理每日工单指标的准备、校验、导入、对账与修正。

主要能力:支持五种模式——准备导出器(检查 Apps Script 或表格布局,配置或小幅修补内置导出器,禁止添加直接 CawPlan HTTP 调用)、校验/试运行(校验文件、确认产品 ID、拒绝重复身份或不支持的词汇、显示总计但不写入)、导入(仅在用户查看并批准试运行后,通过 cawplan metrics ingest 分批上传规范条目)、对账(查询精确导入范围与维度,检查截断,比较 CawPlan 总计与导出)、修正(不覆盖或删除既有数据点,预览增量修正差值,仅在明确批准后写入)。

使用方式:先运行 cawplan skill check;若缺少认证,停止并让用户运行 cawplan auth login,不要在 Apps Script 中请求或嵌入 API 密钥。使用 assets/CawPlanSupportMetrics.gs 作为维护的导出器,复制到绑定的 Support Ops Apps Script 项目,不要从头重新生成。首次导出前:运行 cawplanSupportInspectSource() 并查看记录的人员表头与解析出的源列;在 CAWPLAN_SUPPORT_CONFIG.products 中设置确切的 CawPlan 产品 unique_id 值;将批准的 B、C、E、F、H、I 表头文本复制到 CAWPLAN_SUPPORT_CONFIG.approvedHeaders;设置包含式的 startDate 和 endDate;运行 cawplanSupportExportMetrics(),使用记录的 Drive 文件 URL 和 SHA-256 进行试运行。导出器对 Sheets 只读,仅在 Drive 中创建请求的 JSON 文件。

V1 契约边界:唯一普通 V1 写入为 domain = cawplan_csm、metric = ticket_created、field = value。允许的基础标签为 product_line、channel、assignee、source_system。dimensions.product 必须是已确认的 CawPlan 产品 unique_id;工作区归属由服务器注入,不得提供。Zendesk 状态快照、Solved/Pending KPI、Jira SPRT 问题、每周总计、百分比和报告产物不在 V1 写入契约内,可分析或导出,但在平台所有者批准新的规范指标契约前不得导入。

写入安全:校验、预览和查询视为只读。不得仅因附加了文件就导入;用户必须请求写入并批准试运行。不得同时导入 assignee 级行及其派生的 Total 行。不得使用重新生成的时间戳或更改的标签重试;先对账,仅在需要时重试字节等价的规范条目。遇到未知列、产品不明确、意外标签、负基础值、部分源范围、查询截断或总计不匹配时停止。每次写入需报告源校验和、范围、条目数、接受数和对账结果。

限制:仅支持上述 V1 写入契约;其他指标类型暂未提供导入支持。