客服数据一体化看板

问题场景

客服数据分散在 Google Sheets、腾讯文档、Zendesk/Intercom、企业微信、MySQL/PostgreSQL、Excel/CSV，字段名不统一，指标口径容易漂移。团队需要快速产出可分享、可汇报、可协作的看板，而不是一次性手工拼表。

工作方式

• 多源读取：通过 read_google_sheet.py、pandas.read_sql、API、tencent-docs MCP 等读取数据，并归一为标准 DataFrame。
• 指标计算：覆盖咨询量、工单量、平均响应时长、SLA达标率、CSAT、NPS、FCR、升级率、人均接待量等；用户指定指标优先，否则全量输出。
• 输出格式：生成 HTML 交互看板、Excel 报表、PPT 汇报页或腾讯文档智能表格，适合浏览器分享、存档加工、会议汇报和团队协作。
• 自动刷新：可配置每日/每周定时重生成；Google Sheets 场景还可启用 --live-sheet-id，让 HTML 页面打开时直接拉取最新数据。

适用边界

需要稳定数据源与字段语义。缺少 ticket_id、created_at、csat_score 等字段时，部分指标会显示 N/A；超过 10 万行时建议先抽样或按日期过滤。涉及绩效、敏感字段或 API Token、Sheet 分享权限时，输出前需确认数据安全与访问有效性。