这篇文章用于帮助你自己判断问题和整理需求。不同服务器、代码框架和第三方平台配置可能不同，生产环境修改前应先备份并验证。
基本链路
- Telegram Update → Bot 服务 → 用户状态/知识库 → 模型 API → 格式化回复。
每个用户上下文要隔离
- 不要把不同 user_id 的历史混在一起，群聊还要考虑 chat_id 和 thread。
控制上下文成本
- 只保留必要历史，或对旧消息做摘要，不要无限把所有聊天发给模型。
工具调用必须白名单
- 如果 AI 可以查询余额、订单或执行动作，工具参数必须在程序端校验，不能把模型输出当作可信命令。
常见问题
AI 回复能支持语音吗？
可以额外接语音识别和语音合成，但会增加延迟和成本。
一个 Bot 可以给不同用户不同 AI 人设吗？
可以，把系统提示词和用户配置按 user_id 保存。