智能体搭建

1. 概览

在语音机器人外呼场景中，智能体负责处理客户与机器人之间的对话逻辑。通话过程中，平台会先将客户语音通过 ASR 转写为文本，再将文本发送给智能体理解和生成回复，最后由 TTS 将回复内容播报给客户。

因此，智能体的搭建质量会直接影响：

• 对话流畅度：客户是否能自然地与机器人连续交流。
• 话术执行准确性：机器人是否能按预设流程推进对话。
• 业务目标达成率：如邀约、回访、确认信息、满意度收集等任务是否完成。
• 客户体验：开场白、变量播报、回复语气、结束动作是否自然。

建议在业务测试阶段即完成智能体搭建与调优，并通过调试环境进行多轮验证后，再接入语音导航和外呼任务。

2. 智能体搭建全流程概述

📋 智能体搭建完整流程

┌───────────────────────────────────────────────┐
│                智能体搭建全流程图               │
└───────────────────────────────────────────────┘

🚀 **步骤 1：进入智能体搭建页面**
    └── 进入智能体搭建模块，查看页面布局

🧩 **步骤 2：创建智能体**
    ├── 选择空白应用创建
    └── 或从模板创建

🧠 **步骤 3：配置提示词与模型**
    ├── 选择大模型
    ├── 编写提示词
    └── 明确角色、任务、流程与限制条件

🗣️ **步骤 4：配置开场白与变量**
    ├── 设置开场白
    ├── 配置变量
    └── 在提示词中插入变量

📞 **步骤 5：配置结束规则**
    └── 设置挂机指令与限制条件

🔧 **步骤 6：按需启用扩展能力**
    ├── 网络搜索
    ├── 知识检索
    ├── 引用和总结
    └── 内容检索等功能

✅ **步骤 7：调试与验证**
    ├── 在右侧调试区进行多轮测试
    ├── 查看调试记录
    └── 确认可接入语音导航

⏱️ 预计操作时间

• 创建与基础配置：约 5 分钟
• 提示词、变量与规则配置：约 5-10 分钟
• 调试与验证：约 5 分钟

3. 步骤详解

Step 1：进入智能体搭建页面

页面位置

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

页面布局说明

根据当前页面布局，智能体搭建页主要由以下几个区域组成：

• 左侧应用列表区：展示当前企业下已创建的智能体，支持切换、编辑和查看日志。
• 中间编辑区：用于编辑智能体核心内容，通常包含提示词、变量、知识库、工具等配置模块。
• 顶部导航区：用于切换智能体名称、工作台、知识库、工具等模块，右上角可执行发布等操作。
• 右侧调试与预览区：用于输入测试内容，实时验证智能体回复效果。
• 功能抽屉区：点击页面中的功能入口后，可打开右侧抽屉，按需开启网络搜索、知识召回、内容检索等扩展能力。

建议先完成中间编辑区中的核心配置，再使用右侧调试区进行多轮验证。

Step 2：创建智能体

操作步骤

1. 进入智能体搭建页面后，点击新建应用。
2. 选择创建方式：
   • 空白应用创建
   • 从模板创建
3. 设置应用名称。
4. 将应用分类设置为外呼机器人。
5. 保存后进入编辑页面。

创建方式说明

空白应用创建

适合以下场景：

• 需要自行设计完整业务流程和话术
• 希望灵活控制提示词结构与交互策略
• 需要适配企业特定业务逻辑

推荐优先选择以下类型：

• 聊天助手（Chat Assistant）
• Chatflow

从模板创建

适合以下场景：

• 希望快速搭建一个可测试的外呼机器人
• 当前业务场景与系统预置模板相近
• 需要先完成 POC 验证，再做深度改造

平台在外呼机器人分类下通常预置了多个经过业务验证的行业模板，可用于快速起步。

配置要点

• 分类必须选择“外呼机器人”，否则后续在语音导航智能体节点中无法选择该智能体。
• 若只是首次验证业务流程，可优先使用模板创建；若业务规则较复杂，建议从空白应用开始搭建。

Step 3：配置模型与提示词

模型配置

智能体创建完成后，需要选择用于生成对话内容的大模型。

推荐模型

使用建议

• 流程严格类外呼：优先使用 doubao-seed-2.0-lite
• 灵活交互类外呼：优先使用 qwen3.5-flash
• 复杂业务场景：可根据效果评估更强模型

提示词

提示词（Prompt）是智能体行为的核心控制方式。一个可用于外呼场景的提示词，通常应至少包含以下要素：

• 角色：机器人扮演的身份，如客服专员、回访人员、活动邀约专员。
• 任务要求：本次外呼要达成的目标，如确认信息、邀约到店、满意度回访。
• 对话流程：每一步如何推进，以及面对不同用户回答时如何分支。
• 全局语境：与业务相关的补充背景、知识要点、可选话术风格等。
• 限制条件：机器人不能说什么、不能承诺什么、什么情况下必须结束通话等。

提示词编写建议

• 流程类任务要写清楚每一步的判断条件和推进顺序。
• 营销类任务除了流程，还要写明语气要求、追问方式和转化目标。
• 对结束场景、拒绝场景、异常场景要提前写好兜底规则。

提示词撰写可参考既有模板或企业内部沉淀的话术样例。

Step 4：配置开场白与变量

开场白配置

外呼机器人在客户接听电话后，通常会先播报开场白，用于说明身份和来电目的。

开场白可通过以下方式配置：

方式一：在提示词中配置

可直接在提示词的对话流程或场景示例中写入开场白话术，例如：

您好，我是XX公司的客服专员，今天致电是想和您确认一下...

方式二：使用对话开场白功能

可通过页面右下角的管理入口进行配置：

管理 → 开启对话开场白 → 设置开场白

若使用此方式，请确保其内容与提示词中的开场白保持一致。

方式三：在语音导航中配置

在某些业务场景下，也可以在语音导航的智能体节点中配置固定开场白。若采用该方式，同样需要保证与智能体中的开场内容一致。

开场白注意事项

• 如果同时在提示词和对话开场白中配置了不同内容，可能导致重复播报。
• 若开场白中使用了变量，也需要同步检查对话开场白配置内容。

变量配置

在实际外呼业务中，经常需要根据客户信息动态生成话术，例如：

• 客户姓名
• 城市
• 意向产品
• 业务办理时间

此时需要在智能体中配置变量。

添加变量

点击添加变量：

• 选择字段类型
• 输入变量名称

在提示词中插入变量

在提示词编辑框中输入：

/

按回车后即可选择变量并插入。

示例：

您好 {{客户姓名}}，我是XX公司的客服...

调试变量

在右侧调试区中，可手动输入变量值并进行测试，用于验证变量是否已正确替换到话术中。

实际外呼变量传入说明

智能体页面中配置的变量主要用于调试环境。

如需在真实外呼任务中传入变量，需要通过语音导航中的通道变量机制和外呼任务导入模板进行传递。因此，变量名需要与语音导航节点和任务导入数据中的变量定义保持一致。

Step 5：配置挂机规则

对话结束时需要触发挂机指令，否则系统无法自动结束通话。

配置要求

在提示词中，所有触发挂机的回复都需要在**“再见”后紧跟挂机指令**，中间不加任何其他标点：

感谢您的时间，祝您生活愉快，再见#挂机#

限制条件建议

建议在提示词的限制条件中加入类似规则：

- 正常流程结束时，最后一句话提及“再见”需要触发“#挂机#”指令，以便系统识别并结束通话。

注意事项

• #挂机# 前不要添加其他标点符号。
• 再见！#挂机# 是错误写法，再见#挂机# 才是正确写法。
• 语音导航中的智能体节点通常已内置挂机动作，但前提是智能体侧正确输出了 #挂机# 指令。

Step 6：按需启用扩展能力

在页面中点击功能入口后，可打开右侧功能抽屉，按需启用智能体的扩展能力。

根据当前页面示意，常见能力包括：

网络搜索

用于在回复过程中引入联网信息，适合需要引用实时内容或外部公开信息的场景。

关键词召回

用于增强特定关键词触发下的内容召回能力，帮助智能体更稳定地命中特定业务知识或预设话术。

引用和总结

用于对召回内容或上下文内容进行归纳，帮助智能体更有条理地组织回复。

内容检索

用于在知识内容较多的场景中，根据客户问题检索并引用更相关的内容。

配置建议

• 首次搭建基础链路时，可先不启用过多扩展能力，优先确保主流程可用。
• 当业务依赖外部知识或复杂知识检索时，再根据效果逐项开启。

Step 7：调试与验证

调试与预览区

页面右侧的调试与预览区域用于进行多轮测试对话。建议在正式接入语音导航前，先在这里完成文本层面的验证。

可重点检查：

• 话术流程是否按预期推进
• 开场白是否正常播报且不重复
• 变量是否正确替换
• 对话结束时是否能正确触发 #挂机#
• 扩展能力是否按预期生效

日志与记录

在左侧智能体菜单中，通常还可查看与当前智能体相关的调试记录或日志，用于复盘历史测试内容和定位问题。

验证标准

在将智能体接入语音导航前，建议至少确认以下结果：

• 智能体能够稳定回复，不出现明显跑题
• 开场白、变量和挂机规则均已生效
• 核心业务流程可以至少完整跑通 1 次

4. 常见配置建议

场景一：首次搭建与联调

建议优先完成以下最小配置：

• 创建外呼机器人分类智能体
• 选择模型
• 编写提示词
• 配置开场白
• 配置变量（如有）
• 配置挂机规则
• 完成调试验证

先保证基础链路可用，再逐步增加知识库、工具、扩展能力等配置。

场景二：正式上线前

建议额外核对：

• 话术是否符合业务和合规要求
• 模型是否适配当前业务场景
• 变量是否覆盖所有必要业务参数
• 挂机、转人工等关键动作是否在提示词中已明确约定
• 是否已完成足够轮次的调试与业务验证

5. 下一步

完成智能体搭建后，通常需要继续：

• 在语音导航中配置智能体节点并完成节点连线
• 创建自动外呼任务并导入号码
• 在通话记录中查看录音、对话文本与分析结果

6. 相关文档