核心概念

各部分负责什么

名称 作用
安卓客户端 读取企微页面、执行发消息和群操作等动作
WorkTool 服务 管理机器人连接、指令和回调
Console 提供配置页面、规则、AI 接入及自动化任务
回调 将消息、事件或结果推送到指定接收地址
回复引擎 根据规则处理输入;模型引擎生成回复,回调类型引擎把处理交给第三方

机器人 ID 用于关联这些部分。Console 中的显示名称便于识别,不会替代机器人 ID。

消息、事件和执行结果

  • 消息:群聊或私聊收到的内容,用于回复、转发和监控。
  • 事件:例如机器人入群、群改名、通过好友申请成功,用于触发事件任务。
  • 执行结果:已下发指令的成功或失败反馈,用于判断操作有没有完成。
  • 在线状态通知:机器人上线、下线通知,可单独发送到企微群机器人,也可通过事件回调接收 JSON。

收到“群改名事件”不等于某条改名指令成功回执;二者用途不同。

三种任务

类型 触发方式 适合用途
指令任务 用户立即下发 测试、临时发送或群管理
定时任务 到达指定时间 每日提醒、周期操作
事件任务 收到匹配的新事件 欢迎好友、建群拉人、入群说明

事件任务可以包含多个动作,按列表顺序组成指令。顺序执行不代表事务:后续失败不会撤销前面已经完成的动作。

名称、备注和上下文

群名称、群备注、联系人名称和联系人备注不是同一字段。消息匹配会优先使用回调提供的备注,再使用名称。任务中引用事件字段时,应选择实际有值的字段;新通过的好友通常没有备注。

轻量上下文按机器人与会话区分,默认最多读取最近 20 条、保留 15 天。名称变动可能影响会话关联;它不是永久知识库,也不保证模型记住所有历史。

成功的含义

HTTP 请求成功、任务提交成功、客户端执行成功是三个阶段。看见“已提交”后,可继续用消息 ID 查询执行结果,并核对企微实际页面。避免因为结果尚未返回就重复下发建群等操作。