b300b469dc
- Revised site name and description for clarity and detail. - Updated navigation structure to better reflect the organization of content. - Improved changelog entries for better readability and consistency. - Migrated assistant configuration and prompt guidelines to new documentation paths. - Enhanced core concepts section to clarify the roles and capabilities of assistants and engines. - Streamlined workflow documentation to provide clearer guidance on configuration and usage.
3.9 KiB
3.9 KiB
测试调试
本指南介绍如何测试和调试 AI 助手，确保其行为符合预期。
测试面板
在助手详情页，点击 测试 按钮打开测试面板。
功能介绍
| 功能 | 说明 |
|---|---|
| 文本对话 | 直接输入文字进行测试 |
| 语音测试 | 使用麦克风进行语音对话 |
| 查看日志 | 实时查看系统日志 |
| 事件追踪 | 查看 WebSocket 事件流 |
测试用例设计
基础功能测试
| 测试项 | 输入 | 预期结果 |
|---|---|---|
| 问候响应 | "你好" | 友好的问候回复 |
| 功能介绍 | "你能做什么？" | 准确描述能力范围 |
| 开场白 | 连接后自动 | 播放配置的开场白 |
业务场景测试
根据助手定位设计测试用例：
场景：产品咨询助手
测试用例 1：常见问题
- 输入："产品有哪些功能？"
- 预期：准确列出主要功能
测试用例 2：价格询问
- 输入："多少钱？"
- 预期：提供价格信息或引导方式
测试用例 3：超出范围
- 输入："帮我写一首诗"
- 预期：礼貌拒绝并引导回业务话题
边界测试
| 测试项 | 输入 | 预期结果 |
|---|---|---|
| 空输入 | "" | 提示用户输入内容 |
| 超长输入 | 1000+ 字符 | 正常处理或提示过长 |
| 特殊字符 | "<script>alert(1)</script>" | 安全处理，不执行 |
| 敏感内容 | 不当言论 | 拒绝回复并提示 |
日志分析
查看日志
在测试面板的 日志 标签页，可以看到：
- ASR 识别结果
- LLM 推理过程
- TTS 合成状态
- 工具调用记录
常见日志
[ASR] transcript.final: "你好，请问有什么可以帮你"
[LLM] request: messages=[...]
[LLM] response: "您好！我是..."
[TTS] synthesizing: "您好！我是..."
[TTS] audio.start
[TTS] audio.end
事件追踪
在 事件 标签页查看完整的 WebSocket 事件流：
{"type": "session.started", "timestamp": 1704067200000}
{"type": "input.speech_started", "timestamp": 1704067201000}
{"type": "transcript.delta", "data": {"text": "你"}}
{"type": "transcript.delta", "data": {"text": "好"}}
{"type": "transcript.final", "data": {"text": "你好"}}
{"type": "assistant.response.delta", "data": {"text": "您"}}
{"type": "assistant.response.final", "data": {"text": "您好！..."}}
{"type": "output.audio.start"}
{"type": "output.audio.end"}
性能指标
关注以下性能指标：
| 指标 | 说明 | 建议值 |
|---|---|---|
| TTFB | 首字节时间 | < 500ms |
| 识别延迟 | ASR 处理时间 | < 1s |
| 回复延迟 | LLM 推理时间 | < 2s |
| 合成延迟 | TTS 处理时间 | < 500ms |
常见问题排查
助手不响应
-
检查连接状态
- 确认 WebSocket 连接成功
- 查看是否收到
session.started事件
-
检查模型配置
- 确认 LLM 模型 API Key 有效
- 测试模型连接是否正常
-
查看错误日志
- 打开浏览器开发者工具
- 检查 Console 和 Network 标签
回复质量差
-
优化提示词
- 增加更明确的指令
- 添加示例和约束
-
调整温度参数
- 降低 temperature 提高一致性
- 适当值通常在 0.3-0.7
-
补充知识库
- 上传相关文档
- 提高检索相关性
语音问题
-
ASR 识别不准
- 检查麦克风权限
- 尝试更换 ASR 引擎
- 添加热词提高识别率
-
TTS 不播放
- 检查浏览器自动播放限制
- 确认 TTS 配置正确
自动化测试
使用自动化测试功能进行批量测试：
- 进入 自动化测试 页面
- 创建测试任务
- 配置测试用例
- 运行测试并查看报告
详见 自动化测试。