Skip to content

企业微信机器人进阶 ​

接好企业微信机器人之后的用法:在群里 @ 它、用 /stop 和 /clear 控制它、互相收发图片和文件、长回复和忙碌时的表现,以及让数字人主动给群发消息。

这一页的操作大多在企业微信里进行,相关设置在 Halo 的 设置 › 消息通道 里。

开始之前 ​

在群里用 ​

  • 把机器人加进群,@ 它再说话。企业微信只把 @ 机器人的消息转给它,没 @ 的消息它看不到。
  • 群里每条消息都带着发消息人的身份,数字人知道是谁说的。
  • 回复默认引用你那条消息(引用回复(群聊))。关掉后回复不带引用,流式传输 也会跟着关掉。
  • 群里的人分主人和访客:访客默认只能聊天和使用记忆;主人和访客的消息被合在一起处理时,按访客的权限执行。见 主人与访客权限。
  • 群在 Halo 里默认显示成一串 ID;配好 姓名解析 后会显示群名。也可以到数字人的 能力与设置 › 消息与通知 › 可联系的联系人 里给它 重命名,比如「销售群」,之后说「发到销售群」它就知道是哪个。

聊天里的命令 ​

发送作用机器人回复
/stop(也可以用 /halo-stop、/halo-cancel)停下正在做的事Generation stopped.(没有在做的事时是 No active generation to stop.)
/clear(也可以用 /halo-clear、/halo-reset)清空这个聊天的上下文,重新开始Context cleared. Starting a fresh conversation.
  • 命令不区分大小写;群里先 @ 机器人再发命令也行。机器人的回复只有英文。
  • /clear 只清空聊天上下文,数字人的记忆和提醒都还在。

它忙的时候再发消息 ​

它正在回复时你接着发的消息不会丢:

  • 能马上用上的,会回「✏️ 已加入正在进行的处理」,它在这一轮里就会看到。
  • 其余的会回「✏️ 已收到补充消息」(之后再发的会回「✏️ 又收到补充」),等这一轮做完,它先发一句「(上一轮回应已结束)」,再把这些补充合在一起处理。

收发图片和文件 ​

  • 它能收文字、图片、图文混排、语音(企业微信转好的文字)、文件和视频。引用一条带图片或文件的消息再 @ 它,引用里的图片和文件也会交给它。
  • 想要它发文件,直接说,比如「把报告发给我」。图片按图片发,其他按文件发。
  • 图片最大 10 MB(更大的按文件发),文件最大 20 MB;超过上限时发送会失败,它会尝试压缩或拆分后再发。
  • 它只能发自己工作区里或临时文件夹里的文件。

长回复和进度 ​

  • 一条企业微信消息最多约 2 万字节。更长的回复会拆成几条,标上 (1/3) 这样的序号,最多 10 条;再多的部分会提示「(内容过长,其余部分请在 Halo 里查看)」。
  • 流式传输(默认关):打开后,回复会边写边显示在一条消息里;群里要同时开着 引用回复(群聊)。企业微信限制一条流式消息最长 10 分钟,超过后,这条消息会写明「任务仍在进行中,后续进度会以新消息推送」,之后的进度最多每 2 分钟发一条。
  • 处理中提示(默认开):5 秒内还没回复时,先发「已收到,正在处理…」;开着 流式传输 时,这句话会马上出现在正在写的回复里,不另发一条。
  • 对方最后一条消息后 24 小时内,回复会引用原消息;超过 24 小时,回复和文件改为直接发出,不带引用。群里关了 引用回复(群聊) 时,回复始终不引用。

让数字人主动给群发消息 ​

给机器人发过消息的人和群,会成为这位数字人的联系人,它可以主动给他们发消息,见 主动发给联系人。

常见用法:

  • 每天定时汇报:给数字人设运行计划,在它的 系统提示词 里写明「每次运行后,把结论发到销售群」。
  • 结果自动同步:在 可联系的联系人 里给群打开 自动同步运行结果,每次运行成功后把最终回复发到群里。
  • 别的数字人也往这个群发:在那位数字人的 可联系的联系人 里点 从已有会话添加,见 借用别的数字人的机器人。

网络短暂断开时,回复会先排队,最多等 2 分钟,连上后补发;这时主动推送会失败,数字人会收到连接已断开的提示,自动同步运行结果 也会跳过这一次。

用手机远程让它干活 ​

主人可以在企业微信里随时让数字人在 Halo 所在的电脑上干活:写脚本并运行、操作浏览器、整理文件,再把结果发回来。

主人的指令按完整权限执行

数字人会直接运行命令、修改和删除文件,中间不会逐步确认。只在私聊里这样用,确认 权限控制 已打开、主人用户 ID 里只有你,并在 系统提示词 里写明不能做的事。

遇到问题 ​

在群里说话,它没反应 ​

  1. 确认 @ 了机器人。
  2. 回复范围 不是 仅私信。
  3. 机器人有主人。还没有时,先私聊它一句。

更多情况见 机器人不回复。

让它发文件,提示 File export denied ​

要发的文件不在它的工作区里,也不在临时文件夹里。先让它把文件存到自己的工作区,再发。

回复到一半就停了 ​

发 /stop 让它停下,再重新发一次请求;也可以在 Halo 里打开数字人的 IM 会话 看它做到了哪一步。

下一步 ​

基于 MIT 协议开源 · Open source under the MIT license