logo
当前页

StartListening

2026-02-05
POST

https://aigc-aiagent-api.zegotech.cn/

对讲机模式下,智能体开始聆听。对讲机模式开启请参考创建智能体实例的 AdvancedConfig.CommunicationMode 参数说明。

Request

Query Parameters

    Action string必填

    可选值: [StartListening]

    接口原型参数

    https://aigc-aiagent-api.zegotech.cn?Action=StartListening

    AppId uint32必填

    💡公共参数。应用 Id,由 ZEGO 分配的用户唯一凭证。可从 ZEGO 控制台 获取。

    SignatureNonce string必填

    💡公共参数。16 位 16 进制随机字符串(8 字节随机数的 hex 编码)。生成算法可参考 签名示例

    Timestamp int64必填

    💡公共参数。当前 Unix 时间戳,单位为秒。生成算法可参考 签名示例,最多允许 10 分钟的误差。

    Signature string必填

    💡公共参数。签名,用于验证请求的合法性。请参考签名机制生成。

    SignatureVersion string必填

    可选值: [2.0]

    默认值: 2.0

    💡公共参数。签名版本号。

Body

required
    AgentInstanceId string必填

    Agent 实例的唯一标识,全局唯一。

    Sequence int64

    客户端自己定义的跟随请求有序增加的序列号。每个用户/设备独立递增。AI Agent 后台只处理 Sequence 最新的请求。如果不传,则按 AI Agent 后台接收顺序处理,由于网络问题可能会导致用户说话的顺序和后台接收的顺序不一致。

Responses

开始聆听成功
Schema
    Code integer

    返回码,0 表示成功,其他值表示失败。详情请参考 返回码 说明。

    Message string

    请求结果说明

    RequestId string

    请求 ID

上一篇

插入消息到智能体实例上下文列表

下一篇

智能体结束聆听

当前页

返回到顶部