通过 Webchat 面板测试智能体的文本对话
Webchat 测试的优势
与浏览器内通话测试相比,Webchat 测试面板有一个独特的优势:它会在对话过程中展示底层发生了什么——话题匹配结果、RAG 召回的内容、工具调用(function call),这些在语音测试里看不到的细节在 Webchat 里一目了然。
这使得 Webchat 成为最适合调试和排错的测试方式:如果你发现某个问题(话题没被召回、Flow 跳错了步骤、工具调用参数不对),用 Webchat 重放一遍就能直接看到系统的"内心活动"。
操作入口
在 Agent Studio 主页面,点击顶部工具栏的聊天气泡图标,即可打开 Webchat 面板。面板会以侧边栏形式出现,你可以在测试过程中保持其他 Studio 配置面板可见。
Webchat 面板里能看到什么
在对话过程中,系统会以卡片形式穿插显示以下技术细节:
- Topic matching(话题匹配):当智能体通过 RAG 召回了某个知识话题时,会显示匹配到的话题名称和相关性评分。
- Tool calls(工具调用):当智能体触发了 Flow、外部 API 或其他动作时,会显示调用了什么工具、传了什么参数、返回了什么结果。
- Model output(模型输出):LLM 生成的原始文本(如果和最终展示给用户的回复不同——比如经过了后处理——会同时显示原始和最终两个版本)。
这些技术细节可以通过面板里的 Settings 图标(齿轮)切换开关——调试时打开、演示时关闭。
适合 Webchat 测试的场景
| 场景 | 为什么选 Webchat |
|---|---|
| 验证话题召回是否正确 | 直接看匹配结果和评分 |
| 调试 Flow 多步逻辑 | 每个步骤的触发条件和状态都可见 |
| 测试工具 / API 调用 | 调用参数和返回值完全展开 |
| 多语言智能体测试 | 切换语言更方便、不用变发音 |
| 让非技术同事一起测试 | 文字界面对所有人友好 |
Webchat vs 真实部署的 Webchat Widget
需要注意:Agent Studio 里的 Webchat 测试面板和你将来嵌入到客户网站上的 Webchat Widget 是两个不同的东西。前者是开发调试界面,显示了很多技术细节;后者是最终用户看到的简洁聊天窗口,可以通过 Studio 的 Web Widgets 配置项定制外观。两者共享同一个智能体逻辑,测试通过后 Widget 直接复用。