AB
AiBoss站
教程

通义晓蜜

教程

用通义晓蜜搭建客服对话 Agent 并编排可视化流程技能

介绍如何在通义晓蜜客服对话 Agent 中创建应用、配置人设与安全话术、编排可视化流程技能、绑定高频问答知识库,并通过对话调试与 API 接口完成上线前验证。

通义晓蜜的客服对话 Agent 面向需要搭建自助客服、业务咨询或流程引导机器人的团队。它把三件事放在同一个控制台里:用提示词定义机器人的人设与限制、用可视化画布编排带分支的对话流程、用高频问答库沉淀标准问答。流程编排完成后可以直接在测试窗里跑通整条对话,调试信息会同步到 API 接口,方便后续接入自有渠道。这篇教程按开通、建应用、配人设、编流程、配问答、调试、取接口的顺序,把每一步的操作与参数讲清楚。如果你只是想先了解这类对话 Agent 工具的整体形态,可以先看 通义晓蜜 的工具页,再回到本文动手。

准备工作

动手之前先确认下面几项,缺一项都会卡在中途。

  • 阿里云账号与实名认证:客服对话 Agent 位于阿里云百炼平台,开通与计费都走阿里云账户,账号需要能正常登录控制台。
  • 产品开通:路径是「阿里云百炼 → 应用广场 → 客服对话 Agent」。进入客服对话 Agent 的应用操作控制台后,在右上角点击「免费开通」,进入开通界面完成开通。开通后按实际调用量收费,账单按日生成,从阿里云账户余额中扣除。具体计费口径与单价以官网当前信息为准。
  • 业务素材:一份机器人要回答的问题清单(问题、答案、相似问法),以及一条主流程的对话逻辑草图——用户从哪句话进入、中间要收集哪些信息、什么条件下转人工或结束。
  • 外部接口信息(可选):如果流程里要调用业务系统查询订单、核验身份等,需要提前准备接口地址与参数定义;接口还没就绪也可以先用服务模拟跑通流程。

操作步骤

第一步:创建应用

在客服对话 Agent 控制台点击「创建应用」,填写两项信息即可完成基础创建:

  • 应用名称:按业务需求填写,建议能体现渠道或业务线,例如「售后咨询机器人」。
  • 应用描述:按业务应用场景填写,说明这个 Agent 负责什么、服务哪类用户。

创建完成后进入操作控制台,后续的人设、开场白、知识库、更多设置都在这个界面里配置。

第二步:配置人设与开场白

人设是通过提示词调试机器人的入口。在机器人空间里,每个机器人可以添加人设,在人设中定义角色、工作流、技能和限制要求。配置时有两条捷径:

  • 选择模板:在「选择模板」窗口插入通用模板,按模板要求填入对应的人设限制,适合从零开始的情况。
  • 优化:人设编辑完成后点击「优化」,模型会根据你已输入的内容对人设做改写优化。

机器人开场白是用户打开机器人对话框时机器人主动发起的第一句话。建议在这里把服务范围和引导语写清楚,例如告知用户可以咨询哪些业务、如何转人工。

第三步:配置更多设置

「更多设置」里有模型、通识知识、回复语言和安全四组配置,其中安全配置直接决定线上出问题时的兜底表现。

模型:当前内置伶鹊对话大模型,可以调整温度系数和上下文轮次。温度系数影响回复的发散程度,上下文轮次决定机器人能记住多少轮历史对话。

回复语言有三个选项:

  • 与用户语言相同:根据用户提问的语言回复。
  • 仅中文:无论用户用什么语言提问,都用中文回复。
  • 仅英文:无论用户用什么语言提问,都用英文回复。

安全部分包含三项:

  • 安全拦截:系统检查到输入或输出内容涉及「答案敏感词」时,自动回复「敏感词话术」。
  • 安全预设话术:用户问题包含「用户敏感词」,或模型生成的回复包含敏感内容时,机器人自动使用敏感回复话术。默认话术为「您说的这个问题我不能回答,您可以尝试询问其他问题」。
  • 模型生成异常:系统发生异常或服务超时的情况下,机器人使用的兜底回复话术。

这三段话术建议按业务语气改写,不要直接沿用默认值,否则用户会明显感觉到是模板回复。

第四步:新建可视化流程

流程技能负责「按对话逻辑走分支」的部分。新建流程有两种入口:在「知识库管理 → 流程」中操作,或在配置界面点击「+绑定流程」打开流程列表窗口。

  1. 在流程列表窗口点击「新建流程」,打开新建流程窗口。
  2. 填写流程名称和描述,点击「确认」,得到一个空白流程。
  3. 在列表中找到刚创建的流程,点击「编辑」,进入流程编排页面。
  4. 新建并开启分支,进入流程画布。在开始节点之后添加「分支」节点,设置触发进入后继分支的条件。
  5. 按对话逻辑继续选择节点,把整条对话流程编排完整。

编排完成后点击「测试」,机器人会自动进行流程完整性检测。如果检测报错,按错误提示回到画布调整节点或分支条件,直到检测通过。

第五步:设置调试环境并对话调试

调试前先设置环境,有两项开关:

  • 服务模拟:流程内的 API 插件直接使用 mock 值返回,适用于后端接口还没有准备好的情况。接口就绪后关闭该开关,改为真实调用。
  • 随路参数:在用户发送问题时同时带给机器人的外部参数。典型用法是电话接通时把用户呼入号码作为随路参数传给机器人,后续在 API 插件调用中直接使用该参数。

环境设置好后直接开始对话调试。机器人回复后点击「生成完成」,可以查看机器人输出的内容;对于参数收集类节点,还能看到机器人实际收集到的具体参数信息。这一步是排查「分支没走对」「参数没取到」最直接的手段。

第六步:配置高频问答知识

高频问答库用来沉淀标准问答,和流程技能互补:流程负责多轮引导,问答库负责单轮命中。

  1. 在「知识库管理 → 高频问答」中操作,或在配置界面点击「+绑定高频问答」打开高频问答列表窗口。
  2. 点击「创建高频问答库」,填写高频问答库名称。
  3. 找到新建的库,点击编辑,进入添加高频问答知识的页面。
  4. 点击「新增高频问答」逐条添加,或点击「导入高频问答」批量导入。
  5. 每条知识按要求填写问题、答案类型、问题答案、生效时间、相似问法,点击「提交」完成新增。

相似问法值得多花时间:同一件事用户会有多种说法,把常见变体都填进去,命中率会明显提升。生效时间则用于活动类问答的定时上下线。

第七步:绑定知识库并验证效果

知识库建好后需要绑定到机器人上才会生效。在配置界面点击「绑定」,把对应的流程技能和高频问答知识库绑定到当前 Agent。绑定成功后,在左侧对话测试窗直接提问验证效果,确认命中答案与预期一致。

第八步:查看调用量与获取 API

在「调用量」界面可以查看 token 的消耗量,用于评估用量与成本。在「API」界面,对话 Agent 的调试信息会同步到接口中,可以直接复制当前代码进行调用,接入自有渠道。具体接口字段与鉴权方式以控制台展示和官网当前文档为准。

一个完整示例

下面以「售后工单查询机器人」为例,把上面的步骤串成一条可跑通的路径。

1. 创建应用:应用名称填「售后工单查询机器人」,应用描述填「面向已购用户的售后咨询,支持工单进度查询与转人工」。

2. 写人设:在机器人空间添加人设,说明角色是售后客服、只回答售后相关问题、查询工单前必须先收集订单号、无法处理时引导转人工。编辑完成后点击「优化」让模型润色。

3. 写开场白:例如「您好,我可以帮您查询售后工单进度。请提供您的订单号,或直接描述遇到的问题。」

4. 配安全话术:把安全预设话术改成业务语气,并填写模型生成异常时的兜底话术,例如「系统繁忙,请稍后再试,或回复人工转接客服」。

5. 建流程:新建流程「工单查询」,描述填「收集订单号并查询工单状态」。进入画布后,在开始节点后添加分支节点,按用户意图分成「查询进度」「申请售后」「其他」三条分支。查询进度分支下接参数收集节点取订单号,再接 API 插件节点调用工单查询接口;申请售后分支引导用户描述问题;其他分支兜底回复。

6. 调试环境:接口未就绪时打开「服务模拟」,让 API 插件返回 mock 值;如果渠道能提供用户标识,把呼入号码等作为随路参数传入,供插件调用时使用。

7. 流程测试:点击「测试」跑完整性检测,按提示修正分支条件。然后在对话调试中依次输入「查一下我的工单」「订单号是 xxx」「我要退货」,每次回复后点击「生成完成」,检查分支走向和参数收集结果是否符合预期。

8. 建问答库:创建高频问答库「售后常见问题」,新增若干条,例如问题「怎么申请退款」、答案类型选择对应类型、填写问题答案、设置生效时间、补充「退款怎么弄」「我要退钱」等相似问法,逐条提交。

9. 绑定与验证:把「工单查询」流程和「售后常见问题」问答库绑定到机器人,在左侧对话测试窗分别测试流程类问题和单轮问答类问题。

10. 取接口:在 API 界面复制调用代码,接入实际渠道;在调用量界面观察 token 消耗。

注意事项

  • 计费方式:开通后按实际调用量收费,账单按日生成并从阿里云账户余额扣除。单价、免费额度与计费细则以官网当前信息为准,上线前先确认预算口径。
  • 流程必须先过完整性检测:编排完成后点击「测试」,机器人会自动检测流程完整性;检测不通过时不要急着绑定上线,按错误提示逐项修正。
  • 服务模拟只是临时手段:开启服务模拟时 API 插件返回 mock 值,流程看起来能跑通但不代表真实接口可用。接口就绪后务必关闭该开关重新验证。
  • 随路参数要在调用侧传:随路参数依赖用户发消息时一并传入,渠道侧没有传值,流程里就取不到,相关分支会走偏。
  • 知识库需要绑定才生效:流程技能和高频问答库创建完成后,都要在配置界面点击「绑定」关联到当前 Agent,否则测试窗里不会命中。
  • 安全话术影响用户体验:安全拦截、安全预设话术、模型生成异常三类话术都会直接展示给用户,默认话术偏通用,建议按业务语气改写。
  • 回复语言是全局设置:选择「仅中文」或「仅英文」后,机器人不再跟随用户语言,面向多语言用户时优先选「与用户语言相同」。
  • 模型参数会影响稳定性:温度系数与上下文轮次可调,但调整后需要重新跑一遍对话调试,确认分支判断和参数收集没有退化。