最近做的企微机器人单轮问答没问题但多轮对话经常断片——客户说那个产品多少钱机器人不知道那个指什么。问题出在上下文管理。这篇重点讲多轮对话背后调了哪些企微接口——消息接收、历史消息拉取、消息发送上下文怎么在这些接口调用之间传递。底层用的是Eyun 平台开放的企微 API统一 POSTJSON鉴权用 App Token 加 appid响应封套{code, data, detail, message, time}code 为 0 成功。消息接收Webhook 拿当前消息客户发消息通过 Webhook 回调到后端。回调体里有fromUin客户、toUin机器人、content消息内容、conversationId会话 ID。会话 ID 是上下文的 key——单聊是客户 uin群聊是 roomId。app.route(/wx-api/webhook/, methods[POST]) def webhook(): payload request.json[data] conv_id payload[conversationId] from_uin payload[fromUin] content payload[content] appid payload[appid] # 拿历史消息做上下文 history get_history(appid, conv_id, limit10) reply_text generate_reply(content, history) send_reply(appid, from_uin, reply_text) return okconversationId必须是 JSON number 类型不能传字符串这是踩过的坑。拉历史消息上下文的原料多轮对话的上下文来自历史消息。调消息模块拉取会话历史def get_history(appid, conversation_id, limit10): resp requests.post( f{BASE}/wx-api/api/message/getHistoryMessageList, headersHEADERS, json{appid: appid, conversationId: conversation_id, limit: limit} ) msgs resp.json()[data][list] return [{from: m[fromUin], content: m[content], time: m[time]} for m in msgs]返回的消息按时间倒序要反转成正序再喂给模型。limit控制上下文长度太长 token 爆。接口字段和分页参数在Eyun 开发文档。上下文窗口只留最近 N 轮历史消息全给模型 token 爆炸要滑动窗口——只留最近 N 轮一来一回算一轮def build_context_window(history, rounds5): # history 是正序 recent history[-rounds*2:] # 每轮2条 return \n.join([f{客户 if m[from]!bot else 机器人}{m[content]} for m in recent])窗口外的关键信息客户提到的产品、订单号提取出来存对话状态不丢。长对话摘要窗口外的处理对话超过窗口怎么办不能简单截断要摘要压缩。用 AI 把旧消息生成摘要存数据库def compress_history(history): old history[:-20] # 窗口外的 if len(old) 5: return text \n.join([m[content] for m in old]) summary llm.summarize(text) return summary上下文 摘要 近期窗口消息。这样既不丢关键信息又不爆 token。指代消解从历史里找那个客户说那个多少钱要从历史消息里找最近提到的实体。从拉到的历史里提取def resolve_reference(current_msg, history): # 从历史里找最近提到的产品/订单 for m in reversed(history): entities extract_entities(m[content]) # 产品名、订单号 if entities: return entities[0] return None指代消解在应用层做企微接口只负责提供历史消息。历史拉得全消解才准。话题切换重新拉历史客户换话题了对了售后电话多少旧上下文不该带。检测到话题切换时上下文只留当前消息历史重新开始累积。话题切换靠意图识别——新消息意图和当前对话意图差异大判定切换。切换后get_history的 limit 设小只留 1-2 条避免旧话题干扰。回复发送调 sendText 回客户生成回复后调消息模块发回去def send_reply(appid, to_uin, text): resp requests.post( f{BASE}/wx-api/api/message/sendText, headersHEADERS, json{appid: appid, to: to_uin, content: text} ) return resp.json()[code] 0to是客户 uin就是回调里的fromUin。回复也会进历史消息下次get_history能拉到形成闭环。持久化对话不能丢对话状态当前意图、已收集槽位、摘要存数据库按 conversationId 存。服务重启、客户隔几天回来都能恢复def load_dialog_state(conversation_id): return db.get(fdialog:{conversation_id}) def save_dialog_state(conversation_id, state): db.set(fdialog:{conversation_id}, state, ex30*86400) # 30天过期不持久化服务重启客户对话全断。30 天无活动清空控制存储成本。写在最后多轮对话上下文管理这套东西本质是用好企微的消息接口——Webhook 收当前消息、getHistoryMessageList 拉历史做上下文、sendText 发回复。上下文管理窗口、摘要、指代、切换在应用层做接口负责提供数据。接口路径、参数、会话 ID 规范在Eyun 开发文档里。把接口调对、上下文管好多轮对话就不跑偏。凭证和接入地址在Eyun 企业微信 API 平台开通。