接收智能体任务状态及报错信息--实时音视频-火山引擎

文档中心

导航

接收智能体任务状态及报错信息

最近更新时间：2025.11.19 11:47:51首次发布时间：2025.08.20 14:29:02

在实时对话式 AI 场景下，你可以通过服务端回调来获取智能体任务的状态变化（如任务开始/结束）和任务错误信息，从而实现精细化的任务监控和故障排查。

应用场景

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

实现方式

前往 RTC 控制台-功能配置，选择回调设置。
单击 添加配置，按页面指引填写相关参数，其中回调事件选择 VoiceChat。
如无特殊需求则无需配置业务标识，否则可能导致无法正常收到回调消息。

配置完成后，当智能体任务状态变更或发生错误时，配置的 URL 将会收到推送事件回调消息（JSON 格式）。回调消息和错误码的详情，请参看事件和错误码。