AI 播报时获取 MetaInfo
2026-02-05
功能简介
使用 MetaInfo 可以实现 AI 播报到关键词或关键节点时通知业务服务服务的能力。基于本能力，可以实现用户真正听到某些节点或关键信息时，处理特殊的业务逻辑，例如：
- AI 数字人智能伴学场景中，数字人老师分身回应学生:"你说的对，老师给你点赞。"当 AI 开始播报"点赞"时，驱动数字人做对应的点赞动作。
- AI 电商主播直播，当说到“上链接”的那一刻，则业务侧基于回调通知，触发展示出购物链接或弹窗。
注意
由于需要保证语音播报和指令下发时机的对齐，所以对 TTS 厂商是有一定要求的。目前只支持以下 TTS 厂商：
- MiniMax: MiniMax TTS
- ByteDance: 火山引擎单向流式 TTS。
可参考 配置 TTS 文档了解如何设置 TTS 厂商。
实现当 AI 说话到固定节点时外抛 MetaInfo
前提条件
- 开通 AI Agent 服务，并按快速开始完成基本流程。
- 根据功能简介要求，配置 TTS 厂商为 MiniMax 或 ByteDance。
1
配置包裹符号以及 MetaInfo 格式
通过配置创建智能体实例接口的 AdvancedConfig.LLMMetaInfo 参数，指定 MetaInfo 的包裹符号以及格式。
| 参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
| BeginCharacters | string | 标记元数据在文本中的起始符号。即该符号开始往后，直到遇到 EndCharacters 符号为止，中间的内容为元数据。不可为空或纯空格，注意不要使用常见字符及分句符号。 | [[ |
| EndCharacters | string | 标记元数据在文本中的结束符号。即该符号开始往前，直到遇到 BeginCharacters 符号为止，中间的内容为元数据。不可为空或纯空格，注意不要使用常见字符及分句符号。 | ]] |
| SendMetaKeys | string array | 指定 MetaInfo 中发送 key 的范围，比如：["emotion", "action"]。 重要说明 只有此范围的 key 和 value，才会通过房间信令或者回调给业务方发送消息。 消息类别： - 房间消息 Cmd = 102 - 服务端回调 "AgentInstanceMetaInfo" | ["emotion", "action"] |
我们以指定 LLM 文本中“[[”和“]]”包裹的文本为元数据作为例子说明，配置示例如下：
示例
"LLMMetaInfo" : {
"BeginCharacters": "[[",
"EndCharacters": "]]",
"SendMetaKeys":["action"]
}配置完成后，当 AI 说包含“[[”和“]]”包裹的文本时，AI Agent 服务会将其中 key 为“action”的元数据通过房间信令或者回调给业务方。
2
让 AI 说包含 MetaInfo 的文本
注意
MetaInfo必须是一个JSON对象形式的字符串。
有两种方式可以让 AI 说包含 MetaInfo 的文本：
3
获取 MetaInfo
获取 MetaInfo 有两种方式：
- 客户端通过实时音视频（RTC）房间信令获取 MetaInfo。
- 服务端通过回调获取 MetaInfo。