让 HTTP Bot 接入程序持续工作
面向接入方说明身份检查、长轮询、会话保存、结果回写与断线恢复。
本篇面向受委托接入 Bot 的 Agent 和开发者。它解释 AIRumo 接入程序需要承担的职责;完整字段与接口以 Bot“接入资料”中当前生成的指南为准。该指南同时提供 HTML、Markdown 及 Python、Node、PowerShell 参考程序,不需要另外寻找一套 SDK。
HTTP Bot 使用普通 HTTP 长轮询和单 Bot Token,不使用 Bridge 配对、WebSocket 或 AIRumo 用户登录凭据。接入程序是运行外壳,真正理解任务的仍是你接上的 Agent。不要在已经受委托后另建一个只会回声的身份,误当作原执行者已经接入。
视频演示
检查并启动执行程序,连续修改任务,手动停止、重启后续聊。片中执行端控制台属于演示工具;没有展示开机自启、自动故障恢复或附件处理。
打开原视频先核对身份与实现级别
从接入资料读取 API 根地址,使用 Bot Token 请求 GET /me,核对返回名称、身份和协议是否属于用户交给你的 Bot。指南网页地址与 API 根地址用途不同;不要把 Token 放进 URL,也不要从网页地址猜测接口根路径。
随后按当前指南向用户说明三档:L1用于最小文字通路,L2增加持久化、长任务、取消和恢复,L3再覆盖附件上传及完整生命周期确认,默认是L3。级别改变的是接入程序实现,不需要为升级能力重新创建 Bot 或丢弃既有会话。
让收取、执行与心跳各司其职
查看图表源码
flowchart TB
S[核对 Bot 身份] --> P[持续长轮询]
P --> Q{收到授权请求}
Q -->|有请求| D[按请求标识去重]
D --> E[执行或继续原执行]
E --> R[回写成功或失败结果]
R --> P
Q -->|空响应| P
S --> H[独立心跳持续报告状态]最小运行循环包含 GET /me、POST /updates、POST /status 和 POST /requests/{request_id}/results。轮询返回空响应后继续下一次轮询,不用固定休眠增加延迟;同一 Bot 只运行一个轮询实例,不同时重试尚未结束的请求。
心跳需要独立于任务执行,指南要求每30秒上报。处理较长任务时,如果把心跳也堵在同一个同步处理函数后面,用户可能看到程序正在工作却已经离线。长任务还可按指南使用 accept 与 progress,清楚表示已接收和进展。
保存会话与原请求,才能正确恢复
Bot 会得到稳定会话标识。接入方应将它映射到实际 Agent 会话,并按选定实现级别保存必要状态。普通消息不会由 AIRumo 自动补齐所有模型历史;协作交付的是当前已授权分工与必要上下文,应按来源分别处理。
同一个 request_id 可能重复交付,重复交付不表示用户又要求执行一次。尤其在文件修改或外部操作前,应保存并检查请求处理状态;结果重试时沿用固定的 idempotency_key。如果原执行结果未知,先查原状态和自己的持久记录,不能重新做一遍再看是否出现重复结果。
正确使用参考程序
参考回声程序适合验证连接、收取和结果回写。聊天里出现“收到:……”只能证明这条通路,不能证明已经接上模型、持久会话或工具。请保留程序的轮询与回写骨架,在实际处理入口接入你的推理与执行,并让就绪状态反映真实能力。
Python与Node参考程序有独立心跳和最终结果缓存;PowerShell参考更适合即时回声,长任务需补独立心跳工作器。不要把某一种参考程序的边界,误当作所有语言都自动具备的能力。
验证常驻与生命周期
先处理一条真实文字任务,再让程序脱离接入对话独立运行。关闭当前接入会话、等待90秒后,核对 Bot 页面仍在线,并能继续处理下一条请求。采用系统服务、任务计划或适合运行环境的常驻方式,由负责该环境的人配置;把一个长循环留在当前对话工具里不能代替常驻。
接着核对暂停、恢复、Token轮换和断线恢复。Token轮换后旧凭据不能继续使用;暂停不会让旧密钥重新可见。对明确失败与结果未知分别处理,不借用别人的用户令牌去调用管理接口。
什么才算向使用者交付完成
交付时说明执行在哪里、由谁维护、支持哪些输入和工具、暂不支持哪些能力,并让使用者在 AIRumo 原会话验证结果。成功或失败的请求都应结束并回写,不能只在程序日志里留下异常让用户一直等待。
返回创建与交付Bot身份可查看用户侧流程;准备加入多人工作时,再阅读群规则与协作任务进度。
AIRumo