2026-09-06 17:04:11 +08:00
|
|
|
云端硬件对话智能体测试程序使用说明
|
2026-08-29 21:56:51 +08:00
|
|
|
|
2026-09-06 17:04:11 +08:00
|
|
|
1. 将 ZIP 完整解压到普通文件夹，不要直接在压缩包内运行。
|
|
|
|
|
2. 双击“启动云端测试设备.cmd”，或运行 hardware-agent-tester-0.3.2-windows-x64.exe。
|
|
|
|
|
3. 首次运行允许 Windows 麦克风访问。
|
|
|
|
|
4. 填写平台设备信息和 Hardware ID；火山 Instance ID、Product Key、Device Name 由平台自动下发。
|
|
|
|
|
5. Product Secret 只配置在平台密钥服务中，测试程序不会要求输入；平台代设备注册后只下发本设备的一机一密。
|
|
|
|
|
6. 根据火山控制台中的 Bot 类型选择“通用 LLM”或“豆包端到端语音”。选错会导致 session.update 校验失败。
|
|
|
|
|
7. 点击“检测、鉴权并准备设备”，13项验收区开始记录证据。
|
|
|
|
|
8. 检测通过后点击“开始硬件智能体通话”。只有收到火山 session.updated 且平台确认 ACTIVE 后才会开放麦克风。
|
|
|
|
|
9. 完成双方对话后点击结束；也可以从平台停止通话，程序会在 session_updated 回执中收到 stop_session 并自动结束。
|
|
|
|
|
10. 点击“导出测试报告”，将 JSON 报告交给开发人员验收。
|
2026-08-29 21:56:51 +08:00
|
|
|
|
2026-09-06 17:04:11 +08:00
|
|
|
平台维护中心必须把本设备设置为 volc_hardware_agent + low_load，并绑定与火山产品关联的真实 Bot ID。公网平台尚未部署 v3 路由时会返回 404，此时不能进行真实测试。
|
2026-08-29 21:56:51 +08:00
|
|
|
|
2026-09-06 17:04:11 +08:00
|
|
|
网络需要允许 HTTPS 443 和 WSS 到：
|
|
|
|
|
- 平台服务器
|
|
|
|
|
- ai-gateway.vei.volces.com
|
2026-08-29 21:56:51 +08:00
|
|
|
|
2026-09-06 17:04:11 +08:00
|
|
|
`iot-cn-shanghai.iot.volces.com`只需要平台服务器访问，设备无需访问动态注册地址。
|
2026-08-29 21:56:51 +08:00
|
|
|
|
2026-09-06 17:04:11 +08:00
|
|
|
安全提示：Product Secret 永不到达设备。平台下发的一机一密会使用当前 Windows 用户的 Safe Storage 加密保存，导出的测试报告不包含任何密钥。
|
2026-08-29 21:56:51 +08:00
|
|
|
|
2026-09-06 17:04:11 +08:00
|
|
|
当前测试 EXE 未配置商业代码签名证书，Windows 可能提示“未知发布者”。请先用随包 SHA-256 文件核对完整性；正式外发版本应使用甲方或发布主体的代码签名证书签名。
|
