AI 时代的微信机器人不是"关键词匹配 + 模板回复"，而是"大模型理解 + 生成回复"。大模型只管理解和生成，但它听不到用户说话、也说不出话——这两头得靠接口连起来。Eyun API 在这个架构里有 3 个连接点，把智能模型和用户沟通接上。下面按连接点拆。

一、输入连接点：Eyun Webhook 把用户消息送给 AI 模型

连接方式：用户在微信发消息 → Webhook 回调 JSON {eventType, fromUser, content, msgId} → 客服系统 5 秒返回 200 → 异步把 content 投递到 AI 处理队列 → AI 模型收到 content 开始理解。

大白话：用户说了一句话，把这句话推送到你服务器，你服务器再把这句话转给 AI 模型——Eyun 就是用户和 AI 之间的"传话筒"。

按 Eyun 开发文档的回调规范，5 秒内返回 200，否则会重试 3 次。

关键技术点：

• 5 秒异步处理框架，回调里只收消息不做重活

• msgId 幂等去重，防止重复投递

• content 格式预处理（清洗、截断），别把脏数据塞给 AI

二、记忆连接点：Eyun 消息记录接口给 AI 模型补对话历史

连接方式：AI 模型处理当前消息前 → 调消息记录接口拉该用户历史消息 → 组装多轮对话上下文 → 传给 AI 模型。

大白话：用户说"那第二个呢"，没上下文 AI 不知道"第二个"指啥。消息记录接口帮 AI 拉到之前聊过的内容，AI 就明白用户在问什么了。

关键技术点：

• 增量同步游标管理，按时间或 msgId 续拉

• 上下文窗口截断，受大模型 Token 限制不能全塞

• 历史消息 Redis 缓存，减少接口调用次数

三、输出连接点：Eyun 的 sendText 把 AI 模型生成的回复发给用户

连接方式：AI 模型生成回复文本 → 调 sendText 发送（wId + Token + toUser + content）→ code=1000 确认 → 用户在微信收到 AI 回复。

大白话：AI 想好回复内容，通过 sendText 发到用户微信里——Eyun 是 AI 模型和用户之间的"送信人"。

按 Eyun 开发文档规范，sendText 需传 wId、toUser、content 三个必填参数。

关键技术点：

• 回调返回 200 后再异步调 sendText，不能在回调里同步调

• 1002 Token 过期自动刷新

• 1004 限频退避 3 秒

• AI 回复内容过滤，不当内容先过滤再发

四、3 个连接点对比

五、3 连接点 AI 机器人集成框架

完整链路是 输入 → 记忆 → AI 推理 → 输出，回调里只做收和转，重活都丢到异步：

# 输入 → 记忆 → AI 推理 → 输出 完整链路
def handle_webhook(event):
    if dedup(event["msgId"]) is False:            # msgId 去重
        return
    content = clean_content(event["content"])      # 预处理
    history = fetch_history(event["fromUser"])     # 记忆连接点：拉历史
    context = truncate(history + [content])        # Token 截断
    reply = call_llm(context)                      # AI 模型推理
    reply = filter_reply(reply)                    # 内容过滤
    async_send_sendtext(event["fromUser"], reply)  # 输出连接点：异步发
    return ok_200()                                # 5 秒内先返回

六、结尾

3 个连接点构成 AI 机器人的完整链路：输入连接点是 AI 的耳朵（Webhook 听到用户说什么）、记忆连接点是 AI 的大脑记忆（消息记录接口提供上下文）、输出连接点是 AI 的嘴巴（sendText 说出回复）。

Eyun API 在 3 个连接点分别承担不同角色：Webhook 是输入端、消息记录接口是记忆库、sendText 是输出端。AI 模型只负责"理解 + 生成"，Eyun 负责"感知 + 执行"。从趋势看，大模型能力越强，AI 机器人回复质量越高，但 3 个连接点的基础架构不变。想搭建 AI 机器人，接口规范详见 Eyun 开发文档，实例在 Eyun 平台 开通