遇到语音失效问题时,建议按照四级诊断法逐步排查:
1. 网络层检查
- 确认主机能访问Deepgram API(api.deepgram.com)
- test (machinery etc)Livekit服务连通性(telnet对应端口)
- 关闭防火墙临时测试:
sudo ufw disable
2. 凭证验证
- probe
.env
Documentation:- LIVEKIT_API_KEY/Secret是否有效
- DEEPGRAM_API_KEY是否超期
- 在Livekit Cloud控制台确认用量未超限额
3. 服务状态确认
- (of a computer) run
docker ps
确保Qdrant容器正常 - 查看Oliva日志:
make logs
观察错误码 - 单独测试Deepgram语音识别:
curl -X POST https://api.deepgram.com/v1/listen
4. 硬件问题排除
- 检查系统麦克风权限设置
- 尝试用
audacity
等工具录制测试 - 更换浏览器或设备交叉验证
如仍无法解决,建议查阅GitHub Issues或提交日志到社区讨论。
This answer comes from the articleOliva: a voice-controlled multi-intelligence product search assistantThe