问题描述
调用 StartVoiceChat 返回 200，但智能体出现以下任一异常情况：
- 智能体未加入房间。
- 智能体加入房间后无响应，例如没有欢迎语。
- 智能体加入房间后有欢迎语，但后续语音沟通无反应。
- 智能体加入房间后，听不到智能体的声音。
可能原因
- 若你首次接入遇到该问题：
导致上述现象的可能原因如下：- 音频设备问题：比如本地麦克风或扬声器配置不当或故障。
- 服务配置问题：ASR、TTS、LLM 等服务未开通或参数配置错误。
- 接口参数设置问题：StartVoiceChat 接口缺少必填参数、填写错误或参数大小写错误。
- 权限问题：跨服务授权未开启，RTC 没有权限调用其他 AI 服务。
- 若之前智能体运行正常，你再次调用 StartVoiceChat 接口时遇到该问题：
请查看 ASR、TTS、LLM 等服务试用或购买额度是否已用完，或已达限额。
问题排查
若你首次接入遇到该问题，可以参考以下步骤进行排查：
步骤1：检查音频设备
进入实时对话式 AI Web 体验 Demo进行 AI 对话：
- 如果无法和智能体进行正常对话，则可能是音频输入设备问题，可按照如下方法排查：
- Web 端：请参看 Web 排查无声问题。
- Native 端：请参看 Native 排查无声问题。
- 如果可以和智能体进行正常对话，则可能是智能体接口设置问题，请继续执行后续排查步骤。
步骤2：检查跨服务授权
前往跨服务授权查看是否已开通跨服务授权。若显示未开通可按照提示一键开通。
步骤3：检查智能体配置
- 请确保账号已开通 ASR、TTS、LLM 服务，正确获取并配置了对应核心参数。
注意
- 若 ASR、TTS 或 LLM 使用的是火山引擎的服务，请检查是否在使用免费版。如在使用免费版请前往控制台确认免费版额度是否用完。如已开通正式版，请确认是否购买资源包。
- 详细参数说明，请参考StartVoiceChat。
可使用无代码跑通 Demo 快速检验以下核心参数是否正确填写。如无代码跑通 Demo 无法正常运行，则证明参数填写错误，请对参数值进行逐一排查。
如参数均正确，但智能体仍无法正常运行，请前往使用的在线推理点模型限流是否设置为 0。
| 服务名称 | 核心参数 | |
|---|---|---|
ASR | 火山引擎流式语音识别 | |
火山引擎流式语音识别大模型 | ||
TTS | 火山引擎语音合成 | |
火山引擎语音合成大模型流式输入流式输出 | ||
火山引擎声音复刻大模型非流式输入流式输出 | ||
火山引擎声音复刻大模型流式输入流式输出 | ||
MiniMax |
| |
LLM | 火山方舟平台 | 自定义推理点 EndPointID 或智能体应用 ID。前往火山方舟控制台获取。仅支持自定义推理接入点，不支持预置推理接入点。创建应用时仅支持使用自定义推理接入点，不支持预置推理接入点。 |
Coze 平台 |
| |
| 第三方大模型 | URL：第三方大模型 URL。 | |
- 检查 StartVoiceChat 接口请求参数是否正确并完整填写。
- 确保所有必填参数是否填写。
- 检查以下参数的规范性：
- RoomId、TaskId、TargetUserId、UserId：是否按照参数赋值规范填写，不得出现中文字符。
- RoomId：是否与房间内客户端 SDK 进房时的使用的 RoomId 保持一致
- TargetUserId：是否与房间内客户端 SDK 进房时使用的 UserId 保持一致。
若按照以上步骤排查后智能体依然无法正常工作，请联系技术支持提供 OpenAPI 接口请求的 RequestId 进行排查。
调用 StartVoiceChat 返回 ！200 状态码时，如 401，请查看对应报错进行进行处理。
例如报错信息提示 InvalidAuthorization，则证明使用 Token 无效。可前往控制台 Token 校验检查 Token 是否有效。