OpenBot Responsibilities指南:如何给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 |
| 转发邮件到生成的收件地址 | |
| 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 的详情对话框,你会看到四类信息:
- 状态行:
Active、Paused · Nothing starts it until you resume it或Completed,并显示"Starts on ..."列出所有有效触发源(responsibility-dialog.tsx) - Progress:Bot 主动汇报的最新进度(markdown 渲染)
- Last result:最近一次运行的结论
- 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 一节),你回答后运行即恢复。
相关文件速查
- 数据模型与校验:server/src/responsibilities/types.ts
- 运行引擎(队列、租约、结算):server/src/responsibilities/engine.ts
- Bot 侧职责工具:server/src/responsibilities/tools.ts
- 数据库存储与事件摄取:server/src/responsibilities/store.ts
- 触发器定义与路由:server/src/responsibilities/triggers.ts、server/src/responsibilities/trigger-routes.ts
- GitHub / Slack 集成:server/src/responsibilities/github.ts、server/src/responsibilities/slack.ts
- 页面入口:app/src/routes/_authed/_app/bots.$agentId.responsibilities.tsx
- 列表 / 新建 / 详情 / 触发器组件:app/src/components/responsibilities/
- 前端 API 封装:app/src/lib/responsibilities.ts
- 数据库 schema:server/src/db/schema/responsibilities.ts
- 相关文档:docs/routines.md、docs/architecture.md
小结
用一句话概括 Responsibilities 的使用姿势:在 /bots/:id/responsibilities 写清目标与成功标准 → 按需挂上 GitHub、Slack、定时等触发器 → 用 Runs 列表与 Progress 跟踪每次运行 → 用暂停/完成随时收放。它把一个"聊天机器人"变成了可以交代长期工作、自己开工、自己汇报、全程留痕的 AI 同事。