第 5 章 AI Agent
CH 05本章概览6 节
「AI 机器人」是声邻 Voicelen 的核心,用于配置可自动通话的语音机器人。

5.1 Agent 详情
Section titled “5.1 Agent 详情”点击 Agent 进入编辑页,顶部有 4 个标签页:配置、语音试听、文本对话、实时通话。配置页左侧为锚点导航,分 6 组:基础 / 大脑 · 大模型 / 听 · 识别 / 说 · 音色 / 对话策略 / 工具;新建机器人时还提供「快速生成」,一句话描述业务即可生成完整配置。

5.2 Prompt 编辑
Section titled “5.2 Prompt 编辑”Prompt 使用富文本编辑器,支持:
@触发工具插入:在 Prompt 任意位置输入@,弹出工具菜单- 挂断
${tool:hangup|告别语}$— AI 满足条件时主动挂断 - 转人工
${tool:transfer_human}$— 触发人工接管 - 收集信息
${tool:collect_info|字段}$— 收集姓名/电话等到客户表
- 挂断
- 变量替换:
{{customer.name}}/{{date}}等,通话时自动填入 - 预览变量替换:编辑器支持预览变量填充后的效果
- AI 润色:一键让大模型优化 Prompt 措辞
开场白:接通后自动播报,支持变量;可开启「播放完开场白后自动挂机」开关,适合纯通知类外呼(播完即挂,不进入对话)。
5.3 模型配置
Section titled “5.3 模型配置”- ASR:腾讯云(推荐
8k_zh)、阿里云 - LLM:OpenAI 兼容协议,DeepSeek / 智谱 / 自部署均可
- TTS:MiniMax(推荐
speech-02-hd)、阿里云
5.4 声纹过滤
Section titled “5.4 声纹过滤”在「听 · 识别」区可开启声纹过滤:通话开始锁定首个说话人为主讲人,自动过滤非主讲人语音(旁人插话、环境人声)不送 AI;若检测到新说话人稳定接管说话,自动重锁定为新主讲人。

参数分两组,默认值已按电话音质实测调优,一般无需调整:
| 参数 | 默认 | 说明 |
|---|---|---|
| 锁定所需有效语音(ms) | 15000 | 通话开始累计到此时长判定主讲人 |
| 最长锁定尝试时长(ms) | 30000 | 超时仍不稳定则本通不过滤 |
| 主讲人匹配阈值 | 0.60 | 相似度 ≥ 此值判为主讲人 |
| 非主讲人拒绝阈值 | 0.50 | 相似度 < 此值判为非主讲人 |
| 连续非主讲人段数 | 3 | 重锁定触发所需连续段数 |
| 累计有效语音(ms) | 5000 | 重锁定还需累计的语音时长 |
| 段间相似度阈值 | 0.55 | 候选段两两相似度下限,避免噪声误触发 |
5.5 工具:数据查询(http_fetch)
Section titled “5.5 工具:数据查询(http_fetch)”「数据查询」工具让机器人在通话中调用你的业务接口(查保单、查订单、查物流等):
- URL / 请求头 / 请求体支持「+ 插入变量」:
{param}(客户口述参数)与{collected.<字段名>}(信息收集结果) - 依赖收集字段:勾选后,机器人必须先向客户收集完这些字段才发起查询;未收齐时系统自动提示机器人补问
- 响应字段路径:按点分路径(如
data.policy.no)取值回灌对话,留空则整体回灌 - 客户可通过电话按键输入参数(按
#结束提交);11 位手机号输入完成后自动触发查询
5.6 高级参数
Section titled “5.6 高级参数”- VAD 阈值:能量阈值、语音概率、连续帧数,影响打断灵敏度
- 沉默检测:超过 N 秒不说话时 AI 主动追问
- AI 质检:开关,默认关闭,开启后通话结束异步分析