旺小美助手

要解决什么问题

销售与运营同学日常要在旺小美 App 里翻录音、接访和客户档案，对话式复盘时很难把「按日期筛录音」「查某条 NLP 分析」「本周意向客户」一次性说清楚。本技能把旺小美 SaaS 的后端 API 接到 Agent 上，用自然语言发起查询，而不是在多个菜单里点选。

技能如何工作

授权是前置步骤：你说明想查的数据类型后，技能会起本地回调服务并展示二维码，用已登录的旺小美 App 扫码后，token 写入 ~/.wangke-auth-token，后续请求自动带上 X-Auth-Token 等头。

封装在 api-client.js 里的能力大致分四类：

• 录音：列表（日期 YYYY-MM-DD HH:mm:ss、状态、用户等筛选）、详情与转写、NLP 分析、关键词搜索
• 接访：列表、来访详情、虚拟接访
• 客户：多维筛选（类型、成交状态、来源、级别、意向、是否关联录音等）、详情、姓名/手机号搜索
• 账号与项目：当前用户、租户/项目列表、切换项目 会话

常见说法如「最近 10 条录音」「查看录音 ID 12345」「2026-04-01 到 2026-04-30 的接访」会映射到文档中的 POST/GET 端点（如 /beautx-ai-voice/app/audio/page、/beautx-ai-voice/app/customer/pageV2）。

边界与注意点

• 需能访问 wangkeapp.wangxiaobao.com；App 需支持扫码授权。
• Token 持久化在本地，单账号：重新授权会覆盖旧 token；过期或换号可删授权文件或让 Agent「清除授权」。
• 权限范围取决于 App 登录账号在旺小美里的租户/项目，切换项目后查询结果会随之变化。