例程与 Webhook
按计划运行智能体,在一个会话中收集它们的报告,或从外部事件触发工作。
例程
例程可以运行一次、按重复间隔运行,或在选定的工作日运行。每次运行都会使用所选机器人的模型、权限、工具和计算机配置启动一次全新的执行。

运行回执会区分排队中、进行中、等待中、已完成、已错过、失败和已取消的工作。当本地例程到期时,MengBot 必须处于运行状态。
结果会送达机器人的聊天
每次运行都在自己的会话中独立进行,不会打扰你,只有结果会送到机器人的聊天中:一条来自机器人的消息,上方有一小行文字说明该自动化及其运行时间。你可以像回复其他消息一样回复它;机器人知道它的自动化发现了什么。如果一次运行没有需要告诉你的内容,它会保持安静:没有消息、没有未读圆点、没有通知,自动化的卡片会显示 Nothing new。
当一次运行需要你时,它会在该聊天中询问。以文字形式提出的问题会在消息上显示 needs you;你可以在那里回答,或回复 👍 或 👎。运行所等待的选择或审批也会出现在聊天中,在那里回答,或回复 👍 或 👎,即可让运行继续。它需要的登录、连接或密钥会在聊天中指明,并附有 See run 链接。当一次运行无法完成时,聊天会说明一次,并给出需要修复的内容。
不会有任何内容落在你自己对话的中间:如果你在运行完成时正在与机器人聊天,它的消息会等待,并在机器人回复你之后立即出现。
运行在其消息中链接的文件可以从聊天中打开,就像在运行自己的会话中一样。使用消息上的 See run 查看运行的完整会话,然后使用 Back to results 返回。Run logs 保留执行历史,包括失败和等待中的运行。后台运行会话不会出现在常规侧边栏和移动端会话选择器中。
在例程的编辑器中,使用 Post results to 选择一个现有会话,或保留为 The bot's main thread:你最后写入的对话,也是隐藏会话时你看到的唯一对话。你可以像其他会话一样,将结果会话移入文件夹,例如 OMB management。在 My Cloud 上,由外部事件启动或由他人编写的自动化会报告到自己的聊天中,因此你写入的聊天始终只属于你,并且可以继续使用你借给 My Cloud 的 Mac。
机器人可以在聊天中自行安排、更改、暂停、恢复和删除自己的例程,无需询问,每次更改都会显示为一行并带有 Undo(参见机器人所做的更改)。为其他机器人创建的例程会先询问,除非该对话具有 Full access。
如果没有选择会话,每次运行都会在运行开始时报告到机器人的主会话,无论例程是在哪里创建的,因此结果会跟随你到你所在的对话。更改目标只影响未来的运行,不影响较早运行留下的消息。如果你删除了结果会话,其隐藏的执行会话会变为可见,以便你仍能检查它们的工作并响应审批。
记住上次运行
默认情况下,每次运行都从头开始。对于基于上次结果继续的工作,例如 QA 检查、监控或后续跟进,请在例程的指令下开启 Remember the last run。此后每次运行都会以上次运行的报告(最多 2,000 个字符)开始,因此机器人知道之前发现了什么。该功能适用于由一个机器人运行的重复例程;团队目标尚不支持它。你也可以在聊天中要求机器人开启它。
应用启动时运行
如果你的计算机在例程到期时经常处于关机状态,请打开例程的 Advanced 选项并开启 Also run when MengBot starts。此后每次打开 MengBot 时,例程都会运行一次,同时仍按其计划运行。其运行日志会将这些运行显示为 On startup。如果 MengBot 在启动时已经在补运行某个例程,该例程只会运行一次,而不是两次;错过超过 12 小时的发生时间将由启动运行覆盖,而不会报告为错过。切换到另一个工作区再切回,或 MengBot 从崩溃中恢复,都不算再次打开应用。暂停例程也会停止其启动运行。该功能适用于重复例程,你也可以在聊天中要求机器人开启它。
清除文件夹的未读圆点
右键单击文件夹或打开其 … 菜单,然后选择 Mark folder as read。这会清除未读圆点,而无需打开每个会话。它不会回答审批、关闭问题或停止任何正在运行的工作。
Webhook 触发器
Webhook 通过外部 HTTP 请求启动同一个排队任务执行器。它们独立于计划,默认使用 127.0.0.1:8800 上的专用接收器。
接收器仅暴露健康检查和密钥 hook 路由。它不会暴露更广泛的 MengBot API。
首选 Bearer 身份验证,因为它可以让密钥不出现在 URL 和大多数访问日志中。对于无法设置请求头的发送方,可以使用能力 URL。
自行设置 Webhook 的机器人
当机器人在聊天中创建 Webhook 自动化时,它会在结果中获得私有地址,并且之后可以再次请求该地址,因此它可以自己将地址粘贴到其他应用的设置中,而无需你使用 Copy address。只有该自动化所属的机器人才能获取它,或者能够访问该机器人的 Chief of Staff 才能获取(在共享工作区中具有不同受众的机器人不能获取),并且只能在你主导的对话中获取:绝不会在由 Webhook 或应用事件启动的运行中获取,也绝不会在由访客主导的 My Cloud 对话中获取。该地址保留在该工具结果中;聊天记录、步骤详情和日志会将其遮蔽显示,Automations 页面会隐藏密钥,直到你按下 Show。Copy address 复制的地址与机器人拥有的地址相同,因此复制永远不会破坏设置;Replace address 会生成新地址,旧地址将停止工作。
访问本地 Webhook
在 My Cloud 上无需设置:Webhook 使用工作区自己的地址。Webhooks 面板会显示 https:// 加上工作区的主机名,后跟 /hooks/ 和端点,并且只有这些 hook 路径会传递给接收器。托管工作区也是如此。
在桌面应用中,接收器仅在此计算机上监听。要接受来自公共互联网的事件,请仅通过配置严格的 relay 或 tunnel 代理 Webhook 接收器。不要暴露主 harness 端口。
MengBot 必须保持运行
本地例程和 Webhook 投递不是托管作业。关闭桌面应用会停止本地执行器和接收器。My Cloud 会在你的计算机离线时继续运行它们。