AI 质检通话功能
1. 概述
本平台集成先进的 ASR（Automatic Speech Recognition）语音识别与 NLP（Natural Language Processing）语义理解技术，可精准转写通话内容并对意图进行深度解析，实现 高效、自动化、可配置的智能质检。
前置条件：需先完成 VOS 服务器 IP 白名单添加。
核心亮点
- 原生适配：AI 插件兼容各版本 VOS，不修改、不污染原有运行环境，安全稳定。
- 专用模型：能区分客服与客户双方角色，理解对话语义；出现投诉风险可自动拉黑被叫 号码。
- 灵活策略：支持全面质检 / 抽检模式，降低资源与成本消耗。
- 自动联动：可与黑名单、告警词库、通话上传策略联动，形成闭环治理。
2. VOS 插件
插件安装于 VOS 所在服务器，职责：定时扫描本地录音文件 → VOS 转码（mp3）→ 条件过 滤 → 上传至平台供 AI 模型分析。插件自身不做复杂业务逻辑，便于升级与维护。
2.1 部署流程
(1) 部署文件准备
请联系客服获取安装包，包含：
| 序号 | 组件 | 说明 |
|---|---|---|
| A | NODEJS 运行环境 | 提供插件所需 Node.js 版本（离线包） |
| B | 插件源码 | 质检采集与上传核心逻辑 |
| C | 安装脚本 | 一键初始化、配置与服务注册 |
| D | SQLite 数据库文件 | 本地轻量数据存储（任务/状态缓存） |
将上述文件上传到服务器目录：/zx
以 root 权限执行安装脚本：
chmod 755 /zx/install.sh && /zx/install.sh(2) 自动化安装示例
安装完成后会输出登陆信息：
部署成功后，可在后台查看：VOS 在线插件列表。
目录说明
- 程序目录：
/qc - 配置目录：
/voszx - 数据 & 录音目录：
/vosxxxx（服务器差异化命名；用于存放数据库与 mp3，可后台调 整路径与名称） - 安装目录：
/zx（官方提供的安装文件统一放置于此） - 备份目录：
/qc.bak-YYYYMMDDHHmmss（重新安装 / 升级时自动生成原版本备份）
2.2 插件设置
2.2.1 首次登录
首次进入系统会提示修改默认密码。请立即完成更新，防止被暴力探测。
2.2.2 安全管理
| 选项 | 说明 | 建议 |
|---|---|---|
| 数据库名称 | SQLite 文件名；修改名称即视为重置（重新初始化） | 一般保持默认 |
| 平台端口 | Web 管理端口 | 修改为非常见端口，降低被扫描风险 |
| 加密参数 | 内部加密；修改后系统会重新加密 | 首次部署后立即修改 |
| 存放文件夹 | 录音与数据库实际物理存放位置 | 可迁移至大容量磁盘，如 /home/vosconfig/ |
操作建议
- 登录后请立刻完成：端口 / 加密参数 调整。
- A/B/C 可一次性批量调整；D（路径）需单独操作。
- 保存后插件自动重启，属正常行为。
2.2.3 平台配置
A. 对接平台地址（API 根路径）默认：
https://api.serverai.com.cn/vos/zxB. 转换程序：调用 VOS 原生转换组件，将原始录音转为 mp3。
转换程序路径
VOS 8.0 (V2.1.8) 及以上：
/home/kunshi/mediarecord/bin/mediaconvertVOS 8.0 (V2.1.8) 以下：
/home/kunshi/audiorecord/bin/audioconvertC. VOS 录音目录：用于扫描原始录音文件。
录音目录路径
VOS 8.0 (V2.1.8) 及以上：
/home/kunshi/mediarecord/record/VOS 8.0 (V2.1.8) 以下：
/home/kunshi/audiorecord/record/2.2.4 质检规则同步
说明
插件端不创建规则，只被动接收平台下发的规则清单后执行。
若后台未启用任何规则 → 插件仅扫描不上传，不触发质检。
2.2.5 录音清单
展示近 3 小时内符合扫描策略的原始录音文件。
系统根据已生效质检规则筛选并上传录音，供后续识别与分析。
使用说明
- 仅上传后的记录可在线播放；
- 超过 3 小时的历史录音不再显示（不影响原始文件存在）；
- 插件自身不长期保存录音副本，不改写 VOS 原始录音；
- 未启用规则 → 不会上传任何录音。
3. 语音质检
启用语音质检前请确认已完成：
3.1 VOS 在线插件
菜单路径：语音质检 -> VOS 在线插件
成功部署后列表可见在线实例。
功能：
- 一键登录：直接进入插件管理界面；
- 上传策略调整：
建议批量并发上传数量：100 条（视带宽与性能可调整）。
3.2 自定义告警词库
可自建多组告警词库。当通话内容（包含 / 缺少）匹配特定词汇时触发告警。
菜单路径：语音质检 -> 自定义告警词库
应用场景示例：
| 类型 | 触发方式 | 示例 |
|---|---|---|
| 敏感风险 | 包含 | “投诉”“举报”“律师”“媒体” |
| 规范缺失 | 不包含 | 未出现：标准开场白、身份核验话术 |
3.3 质检规则
平台配置完成的规则会自动下发至插件，插件按规则筛选音频并上传；平台侧由 AI 模型分 析并生成质检结果。
菜单路径：语音质检 -> 质检规则
3.3.1 基础信息
| 字段 | 说明 |
|---|---|
| 规则名称 | 便于标识与检索 |
| VOS IP | 指定目标服务器来源 |
| 启用 | 未启用则不下发到插件 |
3.3.2 上传音频设置
控制哪些通话被上传进入质检：
| 维度 | 说明 | 示例 |
|---|---|---|
| 匹配类型/前缀 | 主叫 / 被叫号码前缀筛选，支持多前缀 | 例如：主叫前缀 0755, 010 |
| 通话时间 | 全时段或指定时间段 | 09:00-21:00 |
| 通话时长 | 单/复合区间 | >10 秒 且 <180 秒 |
| 抽检 | 时间粒度 + 比例 | 每 10 分钟抽检 50% |
3.3.3 告警词库
| 项目 | 说明 |
|---|---|
| 告警对象 | 客服 / 客户 / 双方 |
| 告警类型 | 包含 / 不包含 指定词库 |
| 告警库 | 选择一个或多个 自定义词库 |
3.3.4 AI 质检设置
| 设置项 | 作用 | 建议 |
|---|---|---|
| 报备话术 | 录入规范话术基准，用于对比偏差 | 务必填写 |
| 质检时长阈值 | 过滤极短通话，避免噪声 | 建议 30 秒起步 |
| 加入黑名单 & 有效期 | 风险通话自动拉黑 | 与投诉风险策略结合 |
启用后：识别涉嫌投诉 / 违规意向 → 自动加入 用户黑名单 并设置失效期。
3.3.5 质检结果展示
AI 质检结果：
通话记录详情：
