获取 AI 对话任务状态及报错信息--实时音视频-火山引擎

文档中心

实时音视频

请输入

进阶功能

获取 AI 对话任务状态及报错信息

调用 StartVoiceChat 接口启动任务后，你可以通过服务端回调，实时获取任务的状态变化（如任务开始、结束）和任务错误信息，从而实现精细化的任务监控和故障排查。

应用场景

监听任务状态
通过监听 AI 对话任务状态，捕获用户结束说话、AI 回答完毕等关键节点，以便添加自定义业务逻辑，例如记录任务时长、更新客户端 UI 状态或触发下游数据分析流程等。
分析服务端耗时
通过比对不同状态回调的时间戳，分析 ASR、LLM、TTS 各个核心处理阶段的耗时，为性能体验优化提供数据支持。
排查任务错误原因
当 AI 对话任务发生异常时，回调会提供错误码和错误信息，帮助你快速定位问题根源。

前往配置页面：
- AI 音视频互动方案：前往功能配置，选择回调设置。
- 实时对话式 AI：前往实时对话式 AI-功能配置，选择回调设置。
单击 添加配置，按页面指引填写相关参数，其中回调事件选择 VoiceChat。
如无特殊需求则无需配置业务标识，否则可能导致无法正常收到回调消息。

配置完成后，当 AI 对话任务状态变更或发生错误时，配置的 URL 将会收到 VoiceChat 事件（JSON 格式）。事件详情，请参看事件和错误码。

最近更新时间：2026.01.23 14:05:56

这个页面对您有帮助吗？

有用

无用