TRTC AI 电商客服

要解决什么问题

电商客服往往要同时处理订单查询、退换货、商品咨询、物流和优惠等话术，还要在网页里接上实时语音（麦克风进房、ASR、LLM、TTS）。若自己从零拼 TRTC 房间、OpenAPI 与前端 SDK，容易在 UserSig、StartAIConversation、自定义消息类型和结束流程上踩坑。

本技能面向「有明确搭建/集成意图」的场景：从零生成可运行的客服 Web 项目，或在现有前后端里按栈接入同一套控制面。

技能如何工作

架构上分三层：媒体面用 WebRTC 音频连接用户与 TRTC 房间内的 AI Bot；控制面由前端经 Flask 的 POST /action 中转 TRTC OpenAPI；数据面走 TRTC 自定义消息（如字幕 10000、AI 状态 10001、文字输入 20000、打断 20001）。后端不直接调 LLM，只负责签发 UserSig 与转发控制请求，对话推理在 TRTC 云端 AI Bot 内完成。

路径 A（新项目）：脚手架按商城名称生成后端、前端、鉴权与启动脚本；交互式配置区域、CAM 密钥、TRTC 凭据与 LLM（文档建议 TokenHub + 兼容 OpenAI 的模型）；验证进房、欢迎语与语音/文字回复后，可按 env.yaml 调整三语 SystemPrompt、欢迎/告别语、TTS、Mock 订单或数字人。

路径 B（存量项目）：先确认语言栈与集成范围，再按 references/ 输出对应语言的 join / Start / Stop / Farewell / Transfer 等 Action 处理逻辑与前端进房、字幕代码。

适用边界与注意

• 用户仅讨论客服概念、或只要通用文字 Chatbot、不需要语音/电商场景时，不必触发本技能。
• env.yaml 含密钥，勿提交仓库；生产环境应对 /action 做鉴权，非 localhost 部署需 HTTPS（WebRTC 要求）。
• 故障排查可对照文档中的 FAQ：进房失败、仅有字幕无语音、LLM/TTS 配置与超时等。