获取 AI Agent 服务状态

在与 AI Agent 进行实时语音通话时，可能需要获取智能体实例的状态或实时变化消息以便在业务端及时进行后续处理或保证业务的稳定性。您可以通过主调接口或者监听相应的服务端回调来获取这些状态消息。

状态消息包括以下类型：

• 智能体实例状态：包括空闲中、聆听中、思考中、讲话中等。可通过服务端主调接口查询。
• 服务端异常事件：包括 AI Agent 服务错误、实时音视频 RTC 相关错误、大语言模型（LLM）相关错误、文本转语音（TTS）相关错误（例如 TTS 并发超限等）等。

快速实现

获取智能体实例状态

调用查询智能体实例状态接口（ QueryAgentInstanceStatus ），传入对应的 AgentInstanceId ，服务端将返回智能体实例当前的状态。

监听服务端异常事件

请提供接收异常时间的回调的地址并联系 ZEGO 技术支持进行配置。

当服务端有异常事件时，服务端会将异常事件信息通过您配置的回调通知到您。其内容示例如下：

{
    "AppId": 1234567,
    "AgentInstanceId": "1912124734317838336",
    "Data": {
        "Code": 1001,
        "Message": "AI Agent 通用错误"
    },
    "Event": "Exception",
    "Nonce": "7450395512627324902",
    "Signature": "fd9c1ce54e85bd92f48b0a805e82a52b0c0c6445",
    "Timestamp": 1745502313000
}

更多详细信息请参考 通用回调 和 异常事件错误码文档。