接收回调

注意

回调服务不能保证完全可靠，请慎重考虑使用回调方案构建核心业务流程的风险。

描述

通过本回调，您可以监听用户与智能体对话过程中所发生的事件，包含 ASR 结果、LLM 结果、异常事件、智能体被打断事件、用户说话行为、智能体说话行为。

说明

要接收不同类型的回调结果，请在创建智能体实例时，配置相应的 CallbackConfig 参数为 1：

说明

回调的相关参数，ZEGO 会在之后的迭代计划中，持续优化更新（例如：新增字段、或新增某些字段的参数取值）。开发者在接入时，请避免将代码写死，造成后期更新后，无法兼容新版本。

参数	类型	描述
AppId	Number	ZEGO 给开发者 APP 的唯一标识。
Event	String	事件通知类型。 ASRResult：回调 ASR 结果。 LLMResult：回调 LLM 结果。 Exception：异常事件。 Interrupted：智能体被打断。 UserSpeakAction：回调用户说话行为。 AgentSpeakAction：回调智能体说话行为。
Nonce	String	随机数，用于检验串计算。
Timestamp	Number	回调发送时的 Unix 时间戳（毫秒），用于检验串计算。
Signature	String	检验串，验证回调发送方身份。
AgentInstanceId	String	智能体实例的唯一标识。
AgentUserId	String	智能体的用户 ID。
RoomId	String	房间 ID。
Sequence	Number	回调序号，保证有序性，不保证连续性。
Data	Object	事件详细信息。本参数结构，请参考 Data。

根据 Event 取值不同，Data 包含的参数不同。

ASRResult

LLMResult

Exception

Interrupted

UserSpeakAction

AgentSpeakAction

以下展示各 Event 的回调示例。

ASRResult

LLMResult

Exception

Interrupted

UserSpeakAction

AgentSpeakAction

为提高数据安全性，建议开发者在收到 ZEGO 服务端发出的回调时，进行本地签名计算，并与 signature 进行对比，判断该请求是否合法。

校验的使用流程如下：

参数说明如下：

参数	说明
callbacksecret	服务端校验密钥。在 ZEGO 控制台注册项目时生成，可在 “控制台 > 项目配置 > 项目信息 > 配置信息” 中查看。
timestamp	Unix 时间戳。
nonce	随机数。

使用示例

当您收到回调后，请返回 HTTP status code 为 2XX （例如 200），表示接收成功。返回其他，都表示接收失败。

如果 ZEGO 服务器没有收到响应，或收到的 HTTP status code 不为 2XX（例如 200），都会尝试重试，最多进行 5 次重试。每次重试请求与上一次请求的间隔时间分别为 2s、4s、8s、16s、32s。若第 5 次重试后仍然失败，将不再重试，该回调丢失。