OpenBot Responsibilities指南:如何给AI同事设定长期目标并跟踪进度

原创2026-10-30 10:47:421,982 阅读
文章标签:人工智能AI 应用AI AgentAgent 编排Agent 沙箱工具调用浏览器控制本地部署AI 技能后端前端桌面应用移动开发认证鉴权单点登录可观测性任务调度云原生

OpenBot Responsibilities指南:如何给AI同事设定长期目标并跟踪进度

OpenBot 是一款开源 AI 同事平台,每个 Bot 都有自己的浏览器、文件与工具。其中 Responsibilities(职责) 功能允许你给 AI 同事设定长期目标:写清指令与成功标准,再让 GitHub、Slack、定时任务等事件自动触发它开工,之后随时跟踪进度、查看每次运行结果。本指南将带你从零完成"设定目标 → 配置触发 → 跟踪进度"的完整流程。

Responsibilities 是什么?为什么需要它

普通对话里给 Bot 一个任务,是一次性的;而 Responsibility 是一个持久目标(standing goal):它绑定到某个对话,长期存在,可以被事件反复触发,Bot 会在你不在场时继续推进。

📌 与 Routines(定时例程)的区别:

对比项 Responsibility Routine
本质 长期目标,有成功标准 周期性定时任务
触发方式 手动、事件、Webhook 等多种触发器 仅时间计划
进度跟踪 内置 progress 与 runs 记录 无独立进度
生命周期 active / paused / completed 三态 开关启停

状态定义见 server/src/responsibilities/types.ts:一条 Responsibility 是 active、paused 或 completed;而它的每次运行(run)会经历 queued → running → succeeded / failed / skipped,如果 Bot 中途等你审批,则进入 waiting。

三步给 AI 同事设定长期目标

第 1 步:进入 Responsibilities 页面

在应用内打开某个 Bot 的页面,访问路由 /bots/:id/responsibilities 即可。页面副标题写着它的使命:

Review this Bot's ongoing goals, what triggered each run, and its results.

页面路由定义在 app/src/routes/_authed/_app/bots.$agentId.responsibilities.tsx。列表标题为 Goals,空列表时会提示"Work you give this Bot to keep doing shows up here"(见 responsibilities.tsx)。

第 2 步:创建 Responsibility

点击右上角 New responsibility 按钮,弹出表单,需要填写:

  • Conversation:目标所在对话(Bot 会在这个对话里干活并汇报)
  • Bot:从该对话中挑选要指派任务的 AI 同事
  • Title:目标名称,最多 160 字,例如 "Keep the customer report up to date"
  • Instruction:具体指令,最多 6000 字——这是 Bot 每次运行时的行动依据
  • Success criteria:成功标准,最多 3000 字——这是 Bot 判断"目标完成"的刻度,例如 "The report contains the current quarter's graph and a source link"
  • Event source / Event type:选"Run when asked"表示仅手动触发;选 GitHub、Slack、Schedule 或 Connected app 则可填事件类型(如 GitHub 的 issues.opened)

表单实现见 new-responsibility-dialog.tsx。💡 建议:把 Instruction 写成可重复执行的动作,把 Success criteria 写成可验证的结果,Bot 汇报进度时才会言之有物。

第 3 步:让目标跑起来

创建后,你可以直接在详情页点 Run now 立即开工,也可以等触发器事件自动启动。每次运行都会以你的身份、在你的对话里执行,结果回复落回该对话。

8 种触发方式:让 AI 同事自动开工

Responsibilities 支持最丰富的自动化能力来自它的事件源(event source)与触发器(trigger)。

创建时可订阅的事件源(types.ts):manual、slack、github、schedule、connector、webhook、linear、sentry、pagerduty、email。

详情页可追加的触发器(triggers.tsx):

触发器类型 典型用法
Webhook 任何系统 POST JSON 到生成的 URL 即可触发
GitHub 在仓库 Settings → Webhooks 里指向 OpenBot 的地址,如 issue 打开、PR 合并
Linear Linear Settings → API → Webhooks 配置
Sentry / PagerDuty 错误告警、值班通知直达 Bot
Email 转发邮件到生成的收件地址
Slack 按"被 @、包含短语、加表情、任意消息"四种模式触发

以 GitHub 为例:先在 Connections 页面连接 GitHub 并选择仓库(可开始 responsibility 事件的仓库列表见 docs/configuration.md),再为目标添加 GitHub 触发器,把 payload URL 与 secret 填进仓库 Webhook 设置即可。触发器生成/轮换密钥的逻辑见 server/src/responsibilities/trigger-routes.ts 与 server/src/responsibilities/bindings.ts。

⚠️ 小提示:暂停的触发器只确认收到投递、不会启动运行("Paused triggers acknowledge deliveries but never start a run"),方便临时静而不拆。

如何跟踪进度与查看运行结果

打开某条 Responsibility 的详情对话框,你会看到四类信息:

  1. 状态行:Active、Paused · Nothing starts it until you resume it 或 Completed,并显示"Starts on ..."列出所有有效触发源(responsibility-dialog.tsx)
  2. Progress:Bot 主动汇报的最新进度(markdown 渲染)
  3. Last result:最近一次运行的结论
  4. Runs 列表:每次运行的状态、时间与回复内容,状态文案对照见 responsibility-dialog.tsx——Queued / Running / Waiting for you / Succeeded / Failed / Skipped;点 View runs 展开,还能直接跳回对话查看上下文

如果某次运行状态是 Waiting for you,说明 Bot 撞到了需要你拍板的动作(如审批请求),按页面提示回答后运行自动恢复。运行队列的领取、租约与结算机制在 server/src/responsibilities/engine.ts;数据落库(responsibilities、runs、events 表)见 store.ts。

控制它何时工作:暂停、立即运行、完成

详情对话框提供三个即时操作,全部立即生效:

  • ⏸ 暂停 / 恢复:拨动 Active 开关。暂停后所有触发器不再启动运行;已暂停的 Bot 即使被触发也会跳过(run 记为 skipped 而非 failed,见 engine.ts)
  • ▶ Run now:立即排入真实运行,Bot 会真正执行并可以发消息、操作电脑
  • ✅ Complete:标记完成,此后任何触发都不再启动它

这些操作对应 API /api/responsibilities/:id/{pause|resume|complete|run},前端封装见 app/src/lib/responsibilities.ts。

Bot 也可以自我管理职责

有意思的是,Bot 在对话中同样能通过被授予的工具管理职责(server/src/responsibilities/tools.ts):

工具 作用
create_responsibility 在对话中直接创建一个持久目标
list_responsibilities 查看名下目标与进度
update_responsibility 修改指令、成功标准或订阅
report_responsibility_progress 汇报进度,仅在成功标准达成时才标记 complete
run_responsibility 无需你打开浏览器即可排入一次运行
pause / resume / complete_responsibility 生命周期管理

也就是说,你可以在聊天里说一句"帮我建个长期任务:每周核对一次报销单据",Bot 就会自己建好目标并持续汇报——身份一律取自签名会话,而非模型参数,防止越权。

安全底线:无人监督时依然可审计

Responsibility 运行属于"Nobody watching"场景。OpenBot 的每次 Bot 动作都经过同一网关:解析目标 → 评估策略 → 写入审计行 → 才真正执行。无人监督的运行会在审计记录中标注 initiator 为 responsibility 及其目标 ID(docs/architecture.md):

the Responsibility's id — One of a Bot's standing Responsibilities was triggered, as its owner, with nobody there.

这意味着:Bot 在后台替你干活时,谁授权、依据哪条规则、结果如何,都能在 /admin/audit 里逐条核对。审批请求还会通过 Slack、Teams、短信或推送送达你的设备(docs/configuration.md 中 OPENTAG_URL 一节),你回答后运行即恢复。

相关文件速查

小结

用一句话概括 Responsibilities 的使用姿势:在 /bots/:id/responsibilities 写清目标与成功标准 → 按需挂上 GitHub、Slack、定时等触发器 → 用 Runs 列表与 Progress 跟踪每次运行 → 用暂停/完成随时收放。它把一个"聊天机器人"变成了可以交代长期工作、自己开工、自己汇报、全程留痕的 AI 同事。

登录后查看全文
OpenBot