官网友情链接 wechatapi.net

个人微信二次开发进入AI Agent以后，机器人会调用越来越多外部工具。

查询订单。

查询物流。

生成报表。

创建售后。

检查账号状态。

有些接口几百毫秒返回。

有些接口可能需要几十秒甚至几分钟。

如果机器人始终同步等待：

客户会感觉卡住。

模型调用也可能超时。

所以AI微信机器人需要设计“异步工具结果回写”。

WechatApi 可以作为个人微信API接入层，把客户问题和后续消息持续接入系统。本地Agent系统则把慢工具请求转换成异步任务，先记录任务，再在结果到达以后判断是否仍然需要给客户回复。

一、快工具和慢工具分开

查询套餐：

500ms。

同步。

生成大型报表：

30秒。

异步。

不要所有工具统一一个模式。

二、一个具体例子

客户：

“帮我查一下上个月的使用明细。”

工具预计：

20秒。

机器人先回复：

“我正在帮您查询，结果出来后发给您。”

创建：

tool_job T100。

会话状态：

waiting_tool。

20秒后结果返回。

系统再检查：

客户是否仍在当前话题；
人工是否接管；
任务是否取消。

通过后发送结果。

三、WechatApi 在这里的位置

WechatApi负责：

第一次确认消息；
最终结果消息；
客户期间的新消息。

Agent系统负责：

慢工具生命周期。

四、tool_job状态

pending；
running；
completed；
failed；
cancelled；
expired。

结果不能只靠一个callback直接发客户。

必须先写任务状态。

五、客户期间换话题

客户等待工具时说：

“不用了。”

系统把T100：

cancel_requested。

如果工具本身无法取消。

结果返回后也不再发送。

这就是异步回写必须检查当前业务状态。

六、人工接管

客服看到客户着急。

人工接管。

工具结果稍后回来。

系统可以：

作为内部参考展示给客服。

不自动发。

避免机器人抢话。

七、结果关联原始问题

tool_job保存：

conversation_id；
topic_id；
source_message_id。

最终结果知道自己属于哪个问题。

不会串会话。

八、工具重复回调

外部服务可能callback两次。

使用：

tool_job_id + result_version

幂等。

只处理一次。

九、工具结果过期

客户查询：

“现在物流在哪？”

任务30分钟后才返回。

即使结果技术成功，也可能已经过时。

设置：

result_deadline。

过期后：

重新查询或人工。

十、结果格式校验

外部工具返回：

null；
错误结构。

不能直接让模型生成。

先做：

schema validation。

异常进入工具失败流程。

十一、客户后续补充

工具正在查订单A。

客户又说：

“我说的是订单B。”

原任务T100应该取消。

新建T101。

不能结果回来后仍然发A。

十二、异步结果进入AI还是模板

如果结果结构简单：

直接模板生成。

例如：

“到期时间2026-12-01。”

不一定需要再调用大模型。

复杂报告才需要AI解释。

节省成本。

十三、失败策略

第一次失败可重试。

多次失败：

人工。

客户侧表达：

“查询暂时没有成功，我帮您转人工确认。”

不能无限让客户等。

十四、数据看板

异步工具数量；
平均耗时；
取消；
过期；
人工接管；
工具成功率。

可以发现慢系统。

十五、SLA

waiting_tool属于独立状态。

客服SLA是否暂停要根据业务。

如果工具是企业内部系统：

客户仍然在等企业，服务时间继续。

十六、权限

工具结果回写前重新检查：

当前客户是否仍有权限获取。

例如订单后来转移主体。

不能只用任务创建时权限。

十七、日志

工具请求；
参数版本；
开始；
完成；
会话变化；
最终是否发送。

完整可追踪。

十八、总结

个人微信二次开发中的AI工具调用如果全部同步等待，会让慢接口直接拖垮客户响应体验。

WechatApi 可以保持微信会话持续接入。

本地Agent系统通过异步tool_job，把慢查询、报表、外部系统处理从即时回复链路拆开。

结果回来以后再根据当前客户状态、话题、人工接管和时效决定是否发送。

真正成熟的AI微信机器人，不是所有工具都必须“当场返回”，而是慢任务可以后台完成，同时客户会话仍然保持清晰、可取消、可转人工、不会发送已经过期的结果。