ZENAVA
Guides

发起语音机器人通话测试

本手册将引导您完成从智能体创建、语音导航配置到自动外呼任务启动的完整流程，帮助您快速搭建语音机器人外呼的最基础链路，并完成首次通话验证。

1. 概览

当您开始使用语音机器人外呼能力时，建议按以下顺序完成最基础的链路搭建：

  • 创建外呼智能体：配置用于电话对话的智能体，包括模型、提示词、开场白和挂机规则。
  • 配置语音导航：将智能体接入语音导航流程，形成可实际执行的通话链路。
  • 新建自动外呼任务：配置任务名称、呼叫并发、语音导航和外显号码等基础参数。
  • 导入号码并启动任务：导入待呼号码和个性化变量，发起一次真实外呼测试。
  • 查看通话结果：通过通话记录、录音和机器人对话结果，验证链路是否配置正确。

本文档仅覆盖完成首次外呼测试所需的最基础步骤。关于智能体、语音导航和外呼任务的进阶配置，可参考本文末的推荐文档。

2. 发起语音机器人通话测试全流程概述

📋 语音机器人通话测试完整流程

┌───────────────────────────────────────────────┐
│            语音机器人通话测试全流程图           │
└───────────────────────────────────────────────┘

🤖 **步骤 1：创建外呼智能体**
    ├── 新建外呼机器人应用
    ├── 选择模型
    ├── 编写提示词与开场白
    └── 配置挂机规则并完成文本调试

🎛️ **步骤 2：配置语音导航**
    ├── 新建画布类型语音导航
    ├── 拖入智能体节点
    ├── 选择智能体并配置开场白、音色等
    └── 完成节点连线

📞 **步骤 3：新建自动外呼任务**
    ├── 配置任务名称
    ├── 设置呼叫并发数
    ├── 选择语音导航
    └── 选择外显号码

📂 **步骤 4：导入号码并启动任务**
    ├── 下载并填写导入模板
    ├── 按需填写通道变量
    ├── 上传号码数据
    └── 启动任务发起外呼

📊 **步骤 5：查看测试结果**
    ├── 查看任务呼叫记录
    ├── 查看机器人对话记录与录音
    └── 根据结果回调智能体或语音导航

⏱️ 预计操作时间

  • 智能体创建与调试：约 5-10 分钟
  • 语音导航配置：约 5 分钟
  • 任务创建与号码导入：约 5 分钟
  • 结果验证：约 5 分钟

3. 步骤详解

Step 1：创建外呼智能体

页面位置

CTICloud 工作台 → 企业配置 → 高级设置 → 智能体搭建

操作步骤

  1. 点击新建应用，选择空白应用创建或从模板创建。
  2. 创建应用时，将分类设置为外呼机器人，否则后续在语音导航节点中无法选择该智能体。
  3. 选择用于生成对话内容的模型；如无特殊要求，可先使用 doubao-seed-1.6 作为起步模型。
  4. 编写提示词，至少包含角色、任务、对话流程和限制条件。
  5. 配置开场白。可直接在提示词中写入开场话术，也可使用独立的开场白配置入口，但两处内容应保持一致，避免重复播报。
  6. 如需使用客户姓名、产品名称等个性化信息，可按需配置变量。
  7. 在提示词中配置挂机规则，确保对话结束时输出 再见#挂机#，以便系统正确结束通话。
  8. 在智能体页面的调试环境中完成文本测试，确认话术流程、开场白与挂机指令均正常。

配置说明

  • 创建方式：
    • 空白应用创建：适合需要自行编排业务流程和话术的场景。
    • 从模板创建：适合快速验证业务流程，可直接复用系统预置模板。
  • 模型选择建议：
    • doubao-seed-1.6：更灵活，适合营销类、需要根据客户反应调整话术的场景。
    • qwen3.5-flash：更稳定，适合流程明确、需严格按步骤推进的场景。
  • 提示词建议包含的核心要素：
    • 角色：机器人扮演的身份
    • 任务：本次外呼希望达成的目标
    • 对话流程：每一步的推进逻辑与分支
    • 限制条件：机器人不能说什么、不能做什么
  • 变量说明：智能体页面中配置的变量主要用于调试环境测试；真实外呼任务中的变量传递，需要通过语音导航和外呼任务导入时的通道变量配合完成。

配置要点

  • 智能体分类必须选择外呼机器人。
  • 开场白建议只保留一处生效配置，避免电话接通后重复播报。
  • 挂机指令必须严格使用 再见#挂机#，中间不要加入标点符号。

验证标准

完成文本调试后，应至少确认以下结果：

  • 话术能按预期推进
  • 开场白正常且不重复
  • 对话结束时能正确触发 #挂机#

Step 2：配置语音导航

页面位置

CTICloud 工作台 → 企业配置 → 路由与 IVR → 语音导航

操作步骤

  1. 新建一个语音导航。
  2. 新建时选择画布类型，本文档后续说明均基于画布类型。
  3. 进入语音导航配置页面后，将右侧的智能体节点拖拽到左侧画布中。
  4. 配置智能体节点的基础信息：
    • 填写节点名称
    • 选择上一步创建好的外呼智能体
  5. 配置对话启动方式：
    • 可选择固定开场白或模型生成开场白
    • 若使用固定开场白，内容应与智能体中的开场白保持一致
  6. 配置播放效果：
    • 选择语音音色
    • 按需配置通话背景音
  7. 按需配置变量与预置动作；当智能体输出 #挂机# 时，应触发挂机动作。
  8. 将开始节点与智能体节点连接，形成最基础的通话流程。
  9. 保存语音导航。

配置说明

  • 导航类型：新建语音导航时可选择树形或画布类型。为了便于后续扩展与排查，建议优先使用画布类型。
  • 开场白模式：
    • 固定开场白：由节点配置中的文本直接播报。
    • 模型生成开场白：由模型在通话时动态生成。
  • 音色建议：测试阶段可优先选用较自然的常用音色，如天喻-小颜、天喻-小帅或天迈-迈迈。
  • 背景音建议：可按需选择办公室等轻量背景音，使通话体验更自然；首次测试也可不配置。
  • 变量格式：若在节点中配置变量，变量名应与智能体中的定义保持一致，变量值通常使用 ${} 格式传入。
  • 智能体分析：若希望在通话结束后查看意向标签、信息捕获或流程挂断点，可在智能体节点中按需配置智能体分析；首次验证基础链路时，可暂不配置。

配置要点

  • 建议优先使用一个开始节点 + 一个智能体节点的最简链路完成首次测试。
  • 开场白、变量名和挂机动作应与智能体中的配置保持一致。
  • 连线时需确保开始节点与首个业务节点相连，避免出现断链。

验证标准

完成配置后，应至少确认以下结果：

  • 智能体节点已正确选择目标智能体
  • 开始节点已连接到智能体节点
  • 挂机动作与 #挂机# 指令能够对应

Step 3：新建自动外呼任务

页面位置

CTICloud 工作台 → 外呼任务 → 自动外呼任务 → 任务管理

操作步骤

  1. 点击 新建任务。
  2. 填写任务名称，建议使用可区分用途的命名，例如“语音机器人联调测试”。
  3. 配置呼叫并发数。自己号码测试建议设为 1；多人联调时可根据人数设为 3～5。
  4. 选择语音导航，即上一步已创建并完成配置的语音导航。
  5. 选择外显号码。建议优先选择外显导航；测试阶段可使用默认外显导航。
  6. 点击 保存，任务将出现在任务管理列表中。

配置说明

  • 任务模板：新建任务时，也可以选择任务模板直接复用已有配置。若选择模板，系统会用模板中的内容覆盖当前已填写的任务参数。
  • 呼叫并发数：表示任务启动后同时发起的外呼数量。首次测试建议从低并发开始，便于逐通核对效果。
  • 语音导航：决定客户接通后的实际对话流程，因此应选择上一步已验证过的语音导航。
  • 外显号码：即客户接到电话时看到的主叫号码。建议优先使用外显导航，以便统一控制号码选择策略和不可用时的备用逻辑。

配置要点

  • 首次测试建议仅配置基础参数即可，不必引入定时任务、重呼策略等高级能力。
  • 若选择任务模板，模板内容会覆盖当前已填写配置；本手册以自行配置为主。

Step 4：导入号码并启动任务

页面位置

CTICloud 工作台 → 外呼任务 → 自动外呼任务 → 任务管理

操作步骤

  1. 在任务管理列表中找到刚创建的任务，点击 导入。
  2. 下载导入模板，填写被叫号码。
  3. 如需将客户姓名、产品名称等内容传给智能体，可按需填写通道变量。
  4. 上传填写完成的文件。
  5. 选择导入后立即启动或仅导入。
  6. 点击 确认导入。
  7. 若前一步选择了仅导入，可在任务列表中点击 开始 手动启动任务。

配置说明

  • 导入模板：至少需要填写被叫号码；若话术中使用了变量，还需一并填写对应的通道变量列。
  • 通道变量：用于在真实电话呼叫时向智能体传入客户姓名、产品名称等动态信息，应与语音导航和智能体中使用的变量名称保持一致。
  • 启动方式：
    • 导入后立即启动：适合完成上传后立即发起测试。
    • 仅导入：适合先检查导入数据，再手动启动任务。

配置要点

  • 首次测试建议导入少量号码，优先使用本人或团队内部号码完成验证。
  • 若使用变量，变量名应与语音导航和智能体中的变量定义保持一致。

Step 5：查看测试结果

页面位置

CTICloud 工作台 → 呼叫记录 → 任务呼叫记录 / 机器人对话记录

查看内容

任务启动后，可通过通话记录验证整条链路是否已打通：

  • 在任务呼叫记录中查看通话是否已成功发起，以及每通电话的结果状态。
  • 在机器人对话记录中查看已接通会话的对话文本与录音。
  • 如已配置智能体分析，还可进一步查看意向标签、信息捕获等分析结果。

重点核对项

首次测试时，建议重点核对以下内容：

  • 电话是否成功拨出并接通
  • 开场白是否正确播报且未重复
  • 机器人是否按预设话术与流程完成对话
  • 挂机规则是否生效
  • 若使用变量，变量是否已正确传入并体现在实际对话中

调整建议

若通话结果与预期不一致，可按问题类型回溯调整：

  • 话术流程问题：返回智能体搭建页面，调整提示词、开场白或挂机规则。
  • 路由流程问题：返回语音导航页面，检查节点选择、变量配置与连线关系。
  • 任务启动问题：返回任务管理页面，检查并发、语音导航选择、外显号码及导入数据。

4. 上一步

发起语音机器人通话测试前，建议先完成租户初始化配置：

5. 下一步

完成首次通话测试后，可继续查看外呼结果并进行问题定位：

6. 进阶文档

如需进一步了解各模块的详细功能和高级配置，可分别参考以下文档：

说明文档
智能体搭建进阶能力与配置说明智能体搭建
语音导航节点、变量与分析能力说明IVR 与流程编排-交互节点: 智能体
自动外呼任务参数与导入说明发起自动外呼任务