遇到语音失效问题时,建议按照四级诊断法逐步排查:
1. 网络层检查
- 确认主机能访问Deepgram API(api.deepgram.com)
- 测试Livekit服务连通性(telnet对应端口)
- 关闭防火墙临时测试:
sudo ufw disable
2. 凭证验证
- 检查
.env
文件中:- LIVEKIT_API_KEY/Secret是否有效
- DEEPGRAM_API_KEY是否超期
- 在Livekit Cloud控制台确认用量未超限额
3. 服务状态确认
- 运行
docker ps
确保Qdrant容器正常 - 查看Oliva日志:
make logs
观察错误码 - 单独测试Deepgram语音识别:
curl -X POST https://api.deepgram.com/v1/listen
4. 硬件问题排除
- 检查系统麦克风权限设置
- 尝试用
audacity
等工具录制测试 - 更换浏览器或设备交叉验证
如仍无法解决,建议查阅GitHub Issues或提交日志到社区讨论。
本答案来源于文章《Oliva:语音控制的多智能体产品搜索助手》