智能体回调

编辑文档更新于 2025-09-21 11:59:40

描述

本接口为智能体的回调参数

接口请求地址

请求方式：POST/JSON
传输协议：HTTPS
请求 URL：

回调的地址通过设置回调地址接口来设置

回调参数

名称	位置	类型	必选	说明
agent_id	body	string	是	智能体ID
app_id	body	string	是	应用ID
room_id	body	string	是	房间号
agent_type	body	string	是	智能体类型
event_type	body	string	是	事件类型 - 1: 通知回调 - 2: 退出回调 - 3: 错误回调
event_timestamp	body	string	是	none
module	body	string	是	none
event_code	body	string	是	none
message	body	string	是	none

回调参数示例

{
  "agent_id": "c26251a6-4509-4ed1-a4a8-e5dcbe2abcde",
  "app_id": "ADF1FADADFAD",
  "room_id": "741699",
  "agent_type": 1,
  "event_type": 1,
  "event_timestamp": 1756988006,
  "module": "asr",
  "event_code": 1000,
  "message": "asr connect success"
}

回调预期返回

客户在成功处理回调后，应当返回 http 状态码 200 表示处理成功

回调失败重试

如果回调失败，BRTC 会继续重试三次。

event_code 说明

AIAgentEvent - 事件通知回调

表示 Agent 正常运行过程中的关键连接事件。

`event_code`	`event_type`	事件描述
`1000`	1	ASR 服务连接成功
`3000`	1	TTS 服务连接成功

AIAgentClose - Agent 关闭回调

表示 Agent 被关闭，可能由用户主动停止或系统触发。

`event_code`	`event_type`	事件描述	备注
`5000`	2	用户通过 API 主动停止
`5010`	2	因 `taskIdleTimeout` 触发停止	任务空闲超时
`5011`	2	定时检测发现任务已停止	由 vConsole 检测，MCU 无需处理
`5020`	2	因发生错误导致 Agent 停止	所有错误退出统一使用此码（可扩展）

AIAgentFail - Agent 错误回调

错误码	错误场景	来源
100001	无效的智能体参数配置	BRTC
100002	ASR 服务连接超时	BRTC
100003	TTS 服务连接超时	BRTC
100004	LLM 服务请求参数无效	BRTC
100005	LLM 服务请求失败	BRTC
100000009	ASR 服务连接超时，地址有误或 token 失效	BRTC
300000009	TTS 服务连接超时，地址有误或 token 失效	BRTC
140000010	试用期已结束，并且未开通商用版、或账号欠费	aliyun
340001000	检查是否开通服务	aliyun
140000001	用户使用了不合理的参数或者调用逻辑。例如：Token 过期或者非法	aliyun
140000002	无效或者错误的报文消息。	aliyun
140000003	用户传递的参数有误，一般常见于 RESTful 接口调用	aliyun
140000005	并发请求过多	aliyun
140000009	错误的消息头或传输的语音 WAV 头不合法	aliyun
140020105	使用了不存在的 Appkey	aliyun
140020106	调用时传递的 Appkey 和 Token 并非同一个账号 UID 所创建，导致不匹配	aliyun
100000403	使用的 Token 无效，例如 Token 不存在或者已过期	aliyun
141000002	账号错误,没有设置正确的 appkey	aliyun
141000003	无法获取该 Appkey 的路由信息	aliyun
150000000	受机器负载、网络等因素导致的异常	aliyun
150000001	受机器负载、网络等因素导致的异常	aliyun
152010001	受机器负载、网络等因素导致的异常	aliyun
140000004	请求建立链接后，长时间没有发送任何数据，超过 10s 后，服务端会返回此错误信息	aliyun
140270002	无效的音频	aliyun
140270003	音频解码失败	aliyun
143040001	实时记录同一个会议，同时建立多次链接时会触发。或并发超过最大值。	aliyun
340000001	设置了错误的发音人名称	aliyun
340000004	请求建立链接后，长时间没有发送任何数据，超过 10s 后服务端会返回此错误信息	aliyun
340010003	没有设置有效的待合成文本文字	aliyun
341020001	语音合成调用客户端错误	aliyun
351020001	受机器负载或网络等因素导致的异常，通常为偶发出现	aliyun
340001001	音色克隆数量超限，目前默认 1000 个	aliyun
340001002	音色名前缀不满足规则：不为空，不超过 10 个字符，仅包含数字和字母	aliyun
340002004	音频格式错误，解码失败，目前支持 wav，mp3，m4a，aac	aliyun
340003000	音频内无足够的有效语音	aliyun
340003001	音频信噪比太低	aliyun
350000000	服务错误，一般可通过重试解决	aliyun