个人微信API接口 + AI 应用实践：从用户消息识别到智能任务处理

把 AI 接到微信上很多人以为就是用户发消息→AI 回复一步搞定。实际落地时用户消息识别到智能任务处理不是一步到位的而是经过消息感知→意图识别→任务规划→执行反馈4 个阶段Eyun API 和 AI 各承担不同阶段——一步到位的写法只能应付简单闲聊一旦要处理建工单、查订单这类有副作用的任务就撑不住。理清这 4 个阶段的分工才能把 AI 真正用起来下面按阶段说清楚 Eyun 负责什么、AI 负责什么。Webhook 回调和 sendText 的规范可参考 Eyun 开发文档。一、消息感知阶段Eyun 当耳朵阶段实现用户发消息 → Webhook 回调 JSON{eventType, fromUser, content, msgId}→ 5 秒内返回 200 → 异步投递content到 AI 处理队列。按照 Eyun 开发文档的回调规范5 秒内必须返回 200 否则重试 3 次。Webhook 回调是消息感知的唯一入口。此阶段 AI 不参与。大白话用户说了句话Eyun 把这句话送过来——它是耳朵。二、意图识别阶段AI 当大脑阶段实现从队列取content→ AI 模型规则引擎或大模型理解用户意图 → 输出意图分类如QueryOrder查询订单 /CreateTicket创建工单 /Chat闲聊 实体提取orderId12345、问题描述退款。如果需要上下文调消息记录接口拉取历史消息让 AI 有记忆。此阶段 AI 主导历史数据由接口提供。大白话AI 看看用户这句话想干什么——是查东西、办事情还是随便聊聊——AI 是大脑。三、任务规划阶段AI 当指挥官阶段实现意图CreateTicket→ 拆解为步骤 1调工单系统 API 建工单 步骤 2调 sendText 回复工单号 步骤 3工单处理完后调 sendText 推送结果通知。按照开发文档规范sendText 需要传wId、toUser、content三个必填参数。此阶段 AI 负责任务拆解sendText 作为任务步骤之一。在 Eyun 平台 开通 wId 即可调用。大白话AI 想好了先建工单→再告诉用户工单号→等处理完了再通知用户——AI 是指挥官。四、执行反馈阶段Eyun 当嘴巴和手阶段实现步骤 1 调工单 API 建工单 → 步骤 2 调 sendText 回复用户工单已创建编号 T001 → 步骤 3 等工单处理完后调 sendText 推送工单 T001 已处理完成。Eyun 的错误码体系保证执行可靠性1002刷新 Token /1004退避 3 秒。步骤之间建议加幂等校验避免重试导致重复建工单。此阶段 sendText 负责反馈执行AI 负责任务编排调度。大白话按计划一步步干活每干完一步用微信告诉用户进度——Eyun 是嘴巴和手。五、4 阶段对比处理阶段做什么Eyun 角色AI 角色关键技术点大白话说明消息感知接收用户消息唯一入口不参与Webhook 5秒返回200耳朵意图识别理解用户想干啥提供历史数据主导意图分类实体提取大脑任务规划拆解任务步骤sendText 作为步骤主导步骤拆解指挥官执行反馈执行并反馈sendText 反馈编排调度错误码 1002/1004嘴巴和手六、4 阶段 AI 应用框架代码import queue, time; msg_queue queue.Queue() def on_webhook(j): # 阶段1 感知 msg_queue.put(j[content]); return , 200 # 5秒返回200否则重试3次 def recognize_intent(content, client): # 阶段2 识别AI 主导 history client.call(fetchHistory, {wxid: u1, range: 1h}) # 拉历史让AI有记忆 return ai_model.predict(content, history) # {type:CreateTicket,...} def plan_tasks(intent): # 阶段3 规划AI 拆步骤 return [create_ticket, reply_no, notify] if intent[type] CreateTicket else [chat_reply] def execute(tasks, client, to_user): # 阶段4 执行 for t in tasks: if t create_ticket: ticket_no call_ticket_api() elif t reply_no: client.call(sendText, {wId: client.wId, toUser: to_user, content: f工单已创建编号{ticket_no}}) elif t notify: client.call(sendText, {wId: client.wId, toUser: to_user, content: 工单已处理完成}) time.sleep(3 if client.last_error 1004 else 0) # 1004退避3秒七、结尾4 个阶段清晰地划分了分工——Eyun 负责消息感知阶段 1 耳朵和结果反馈阶段 4 嘴巴和手AI 负责意图识别阶段 2 大脑和任务规划阶段 3 指挥官。这种分工意味着换 AI 模型不影响感知和反馈接口不变换接口假设升级也不影响 AI 的识别和规划逻辑。从趋势看AI 能力越强意图识别和任务规划越智能但 4 阶段链路的基础架构不变。落地建议先用规则引擎跑通阶段 2 的意图识别成本低、可控验证整条链路通了再逐步换成大模型。Webhook 回调和 sendText 的参数规范详见 Eyun 开发文档在 Eyun 平台开通 wId 即可开始。