logo
当前页

查询智能体实例状态


描述

本接口用于在语音对话过程中查询智能体的运行状态信息。

接口原型

  • 请求方法:POST
  • 请求地址:https://aigc-aiagent-api.zegotech.cn?Action=QueryAgentInstanceStatus
  • 传输协议:HTTPS
  • 调用频率限制:10 次/秒

请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表请参考 调用方式 - 公共请求参数

参数类型是否必选描述
AgentInstanceIdString智能体实例的唯一标识。

请求示例

  • 请求地址 URL:

    Untitled
    https://aigc-aiagent-api.zegotech.cn?Action=QueryAgentInstanceStatus
    &<公共请求参数>
    
    1
    Copied!
  • 请求消息体:

    Untitled
    {
        "AgentInstanceId": "1907616178474336256"
    }
    
    1
    Copied!

响应参数

参数类型描述
CodeNumber返回码。0 表示成功,其他值表示失败。如需了解错误码及响应处理建议,请参考 返回码
MessageString请求结果的说明信息。
RequestIdString请求 ID。
DataObject返回数据。
└StatusString智能体运行状态:
  • IDLE:空闲
  • LISTENING:聆听中
  • THINKING:思考中
  • SPEAKING:讲话中

响应示例

Untitled
{
    "Code": 0,
    "Message": "success",
    "RequestId": "1898302332764950528",
    "Data": {
        "Status": "IDLE"
    }
}
1
Copied!

Previous

主动调用 TTS

Next

打断智能体实例