在开放办公区、展厅、客厅这种地方，旁边人随口一句话就可能被智能体当成指令。用户正说到一半，同事在两米外聊天，智能体转头回答同事去了——这个问题在 Demo 里不存在，一到真实环境就非常明显。 选择性注…

用一个通用提示词同时干分诊、报价、下单、售后，结果通常是四件事都干得含糊——售前的话术混进售后，退款问题被当成销售机会。 更清楚的做法是拆角色：分诊客服先识别需求，售前顾问回答套餐和购买问题，创建订单…

翻译智能体和问答智能体有个根本区别：它绝不能回答用户说的话。 用户说「我们周五开会你能参加吗」，普通助手会回答「可以」；翻译助手必须原样译成英文。这个「不许回答」的约束贯穿全篇。识别语言、系统提示、T…

把几十个业务函数一股脑塞给模型，出问题几乎是必然的：选错工具、参数张冠李戴、执行了本不该执行的操作。工具列表越长，模型判断越容易飘。 更稳的做法是按场景只暴露当下该用的那几个。用智能家居演示最直观：人…

页面关了，事情还得继续。审计、告警、计费、跨系统联动这些事不能指望用户的浏览器一直开着。 所以分工是清楚的：客户端事件负责更新当前页面，服务端 Webhook 负责剩下那些不能丢的部分，由云端主动推给…

文本产品出问题，你还能在前端把内容藏起来。语音不行——模型的输出会直接进 TTS，用户先听到了，你再隐藏字幕已经没有意义。 所以过滤必须往前放，放到 Custom LLM 网关这一层：进模型之前先脱敏…

max_history 只管当前这条命的事——会话一停，智能体就把你忘干净了。想让用户下次打进来还被记得，得在停止前把记忆取出来存好，新会话创建时再注入回去。 这件事技术上不难，难在做得安全。所以下面…

网页加载两秒，用户会等；语音对话沉默两秒，用户会以为断线了，然后开始「喂？喂？」。 这是语音场景特有的问题，解法是两个小配置：填充语在模型思考期间说一句「稍等，我看一下」，告诉用户系统还在干活；优雅退…

客服场景经常要中途换角色：用户升级成 VIP、流程走到售后阶段、过了工作时间要切成留言模式。如果每次改提示词都得停掉智能体重建一个，用户会听到一段明显的断线和重连——这个体验损失，比换角色带来的收益大…

「智能体不说话」是语音开发里最难查的一类问题。可能是 RTC 没连上、ASR 没出字、LLM 超时、TTS 挂了，也可能什么都正常，只是客户端忘了播放远端音轨——五种原因，用户侧的表现一模一样，都是一…