让指定智能体实例立即播报文本消息,支持打断设置。
接口说明
使用此接口可以立即指令一个 AI 智能体实例进行语音播报,传入指定的文本内容。用户可选择性地允许此次播报中断当前正在进行的语音播放,默认为允许打断。
注意:
InstanceId必须有效且对应一个存在的智能体实例。Text的内容应符合规范,避免包含敏感或不当信息。若不希望新播报打断当前语音,需明确设置
EnableInterrupt为false。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
ice:SendAIAgentSpeech |
none |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| InstanceId |
string |
是 |
智能体实例 ID。 说明
InstanceId 为智能体实例启动成功后,返回的唯一的 Id。启动智能体接口,请参见StartAIAgentInstance 、 GenerateAIAgentCall 。 |
39f8e0bc005e4f309379701645f4**** |
| Text |
string |
是 |
需要播报的文本内容。根据不同 Type 支持不同的输入类型。长度不超过 1024。 |
Hello, welcome to use our service |
| EnableInterrupt |
boolean |
否 |
这条主动播报是否能打断当前语音。默认值:true。 |
true |
| Type |
string |
否 |
输入类型,可选:
默认 Text。 |
Text |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求 ID |
7B117AF5-2A16-412C-B127-FA6175ED1AD0 |
示例
正常返回示例
JSON格式
{
"RequestId": "7B117AF5-2A16-412C-B127-FA6175ED1AD0"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。