文本驱动指令(WebSocket 长连接)

最近更新时间:2025-07-09 18:20:11

我的收藏

接口说明

创建长连接通道 后,可以通过 WebSocket 长连接发送文本驱动数智人。
注意:
发送文本间隔必须大于1s。

请求参数

参数名称
类型
必选
描述
ReqId
String
单次驱动的唯一标识, 32位的 UUID(不包含‘-’)。
注意:
每次发送都新生成一个 ReqId。
SessionId
String
会话唯一标识。
Command
String
SEND_TEXT:发送文本。
Data
Data
数据对象

Data
(发送文本)
名称
类型
必选
描述
Text
String
要播报的文本内容,缺省值:字符串最长4000字节。
Interrupt
Boolean
打断标记,会打断当前数智人的播报。
说明:
当 Text 参数不为空的时候, 这个参数不生效, 总是会打断当前播报然后播放 Text 的内容。
当 Text 参数为空的时候, 这个参数生效, 设置为 true 时会打断当前播报然后进入静默状态。
注意:
需要等到 WebSocket 下行消息返回 TextStart 标记后才可发送打断请求。
ChatCommand
String
对话指令类型 ,当数智人项目绑定客服对话或 腾讯云智能体开发平台 时生效。
NotUseChat:客服对话或智能体开发平台配置的问答知识库不生效,数智人播报发送的内容。
传空或不传:客服对话或智能体开发平台配置的问答知识库生效,数智人播报问答知识库中的答案内容。
ChatRoundId
String
对话轮次 ID,推荐使用 UUID。缺省值:""
使用腾讯云智能体开发平台对话服务的数智人项目需要传入此字段,用于区分多轮对话。
CloudAiVisitorBizId
String(64)
腾讯云智能体开发平台的访客 ID。
VideoSeiInfo
String
需要在视频流 SEI 中携带的信息,字符串内容为 JSON 格式。发送后会在视频流播报本次响应时在 SEI 中携带。
当前仅支持 2D 形象,视频流中信息说明请参见 视频流嵌入信息说明
SmartActionEnabled
bool
是否开启智能动作,缺省值:false。为 true 并且输入的文本或者话术增强后的文本没有动作标签则会生成智能动作。

请求示例


{
"Header": {},
"Payload": {
"ReqId": "d7aa08da33dd4a662ad5be508c5b77cf",
"SessionId": "m318552187863054171",
"Command": "SEND_TEXT",
"Data": {
"Text": "您好,我是人工合成的数智人"
}
}
}