You need to enable JavaScript to run this app.
导航
实时音视频
  • 文档首页
    • /实时音视频/实时对话式 AI/API 参考/事件和错误码
事件和错误码
最近更新时间：2025.11.19 13:09:05首次发布时间：2025.11.03 20:51:14
复制全文
我的收藏
有用
有用
无用
无用

你可以通过回调机制实现对智能体任务状态和智能体状态进行监控，并获取错误信息，以快速定位问题。

VoiceChat 事件

当监听 VoiceChat 事件以接收智能体任务状态及报错信息时，返回的事件信息如下所示。

参数名类型描述示例值
AppIdString音视频应用的唯一标识。661e****543cf
BusinessIdString业务标识。biz1
RoomIdString房间 ID，房间的唯一标识。room1
TaskIdString智能体任务 ID。task1
UserIDString说话人 UserId。user1
RoundIDInt64对话轮次。从 0 开始计数。0
EventTimeInt64该事件在 RTC 服务器上发生的 Unix 时间戳 (ms)。1611736812853
EventTypeInt64任务状态类型。
  • 0：智能体任务状态发生变化。
  • 1：智能体任务出现错误。
0
RunStageString状态详情。
  • taskStart：任务开始。
  • taskStop：任务结束。
  • beginAsking：房间用户开始说话。
  • asrFinish：房间用户结束说话。
  • llmOutput：大模型已生成并输出首个 token。
  • answerStart：智能体开始说话。
  • answerFinish：智能体说话完成。
  • interrupted：智能体说话被打断。
  • reasoningStart：大模型开始深度思考。
  • asr：ASR 处理阶段。
  • llm：LLM 处理阶段。
  • tts：TTS 处理阶段。
  • preParamCheck：参数校验错误。
llmOutput
ErrorInfoErrorInfo任务错误详细信息。仅在 EventType 为 1 时出现。-

ErrorInfo

参数名类型描述示例值
ErrorcodeInt错误状态码。详细定义请参见错误码1001
ReasonString错误详细原因。
  • quota exceeded for types [...]：依赖服务配额超限。通常是 ASR、TTS 或 LLM 的免费额度耗尽，或购买的资源包已用完。
  • requested resource not granted：资源未授权或未开通。RTC 服务没有权限调用配置的 AI 服务，或者该 AI 服务本身未成功开通。

错误码

下表汇总了在执行以下操作时可能返回的错误码，以帮助你定位和解决问题：

错误码描述可能原因及解决方案

1000001

任务初始化失败

原因：系统内部错误，导致任务无法启动。
方案：请稍后重试。若问题持续，请联系技术支持。

1000002未知参数原因：StartVoiceChat 请求中包含了未定义的参数字段。
方案：请仔细核对请求参数是否与 StartVoiceChat 文档 一致，移除或修正错误参数。
1003001ASR 实例化失败原因：ASR 服务配置不正确或内部错误。
方案：检查 ASRConfig 中的 Provider 和 ProviderParams 是否正确填写。
1003002ASR 请求失败原因：向 ASR 服务发送请求时失败。
方案：检查网络连接。若问题持续，请联系技术支持。
1003003ASR 响应读取失败原因：从 ASR 服务接收响应时发生网络错误或超时。
方案：检查网络稳定性。
1003004ASR 响应解析失败原因：ASR 服务返回的数据格式不符合预期。
方案：如果使用自定义 ASR，请检查其返回格式是否符合协议。
1003005ASR 重连失败次数过多原因：与 ASR 服务的连接多次中断且无法恢复。
方案：检查 ASR 服务的稳定性及网络状况。
1003006ASR 建联失败原因：无法与 ASR 服务建立连接。
方案：1. 确认 ASR 服务已开通。 2. 检查 ASRConfig.ProviderParams 中的 AppId、AccessToken 等鉴权信息是否正确且有效。 3. 检查网络防火墙策略。
1004001LLM 实例化失败原因：LLM 服务配置不正确或内部错误。
方案：检查 LLMConfig 中的 Mode、EndPointId、APIKey 等参数是否正确。
1004002LLM 请求失败原因：向 LLM 服务发送请求时失败。
方案：检查网络连接。若问题持续，请联系技术支持。
1004003LLM 响应读取失败原因：从 LLM 服务接收响应时发生网络错误或超时。
方案：检查网络稳定性。
1004004LLM 响应处理失败原因：LLM 服务返回的数据格式不符合预期。
方案：如果使用第三方 LLM，请检查其返回格式是否符合[接口标准](1399966)。
1004005LLM 建立连接失败原因：无法与 LLM 服务建立连接。
方案：1. 确认 LLM 服务已开通。 2. 检查 LLMConfig 中的 URL、APIKey 等鉴权信息是否正确。 3. 检查网络防火墙策略。
1004006Function Calling 请求失败原因：调用 FunctionCallingConfig.ServerMessageUrl 配置的业务方 URL 失败。
方案：检查业务方服务是否正常，URL 是否可公网访问。
1004007Function Calling 响应请求失败原因：业务方服务返回了非 2xx 的 HTTP 状态码。
方案：检查业务方服务逻辑，确保对回调请求能正确响应。
1004008安抚语处理失败原因：在 Function Calling 过程中，播放安抚语失败。
方案：检查 TTS 配置是否正确。
1004009MCP 获取工具失败原因：向 MCP Server 请求工具列表失败。
方案：检查 MCP Server 地址是否正确，服务是否可用。
1004010MCP 调用工具失败原因：调用 MCP 工具时发生错误。
方案：检查 MCP Server 内部工具的实现逻辑。
1005001TTS 实例化失败原因：TTS 服务配置不正确或内部错误。
方案：检查 TTSConfig 中的 Provider 和 ProviderParams 是否正确填写。
1005002TTS 请求失败原因：向 TTS 服务发送请求时失败。
方案：检查网络连接。若问题持续，请联系技术支持。
1005003TTS 响应读取失败原因：从 TTS 服务接收响应时发生网络错误或超时。
方案：检查网络稳定性。
1005004TTS 响应处理失败原因：TTS 服务返回的数据格式不符合预期。
方案：如果使用自定义 TTS，请检查其返回格式是否符合协议。
1005005TTS 建连失败原因：无法与 TTS 服务建立连接。
方案：1. 确认 TTS 服务已开通。 2. 检查 TTSConfig.ProviderParams 中的 appid、token 等鉴权信息是否正确且有效。 3. 检查网络防火墙策略。
1006001数字人建联失败原因：无法与数字人服务建立连接。
方案：检查 AvatarConfig 中的 AvatarAppID、AvatarToken 等参数是否正确。
1006002数字人服务内部错误原因：数字人服务侧发生未知错误。
方案：请联系技术支持。