Agent 团队 / Agent Teams

Team Runtime 是 OpenCowork 的“多 Agent 协作层”。它和 Task 子代理不是一回事：

• Task 负责启动一个专用子代理
• Team Runtime 负责 lead / worker 协作、消息通信、任务分配和运行状态

相关工具 / Related tools

• TeamCreate
• SendMessage
• TeamStatus
• TeamDelete
• TaskCreate / TaskUpdate / TaskGet / TaskList

运行模型 / Runtime model

Worker 可以使用两种 backend：

• in-process
• isolated-renderer

团队状态 / Team status

Team Runtime 使用 shared types 描述成员、消息和任务：

• Member：working / idle / waiting / stopped
• Task：pending / in_progress / completed
• Message：message / broadcast / shutdown_request / permission_request / plan_approval_request 等

持久化目录 / Persistence directory

每个 team 都会存到：

~/.open-cowork/teams/<sanitized-team-name>/
├── team.json
└── messages.json

其中：

• team.json 存 manifest、成员和任务
• messages.json 存最近消息记录

权限模式 / Permission mode

Team Runtime 支持两种权限模式：

• default
• plan

在 plan 模式下，worker 需要先完成计划审批，再推进实现。

Team events / Event flow

Team 相关事件会把 UI 拉到右侧 team 面板，让你实时看到：

• 成员加入 / 移除
• 任务创建 / 认领 / 完成
• worker 消息
• 运行状态变化

worker 的两种启动方式 / Worker startup modes

1) in-process

轻量，启动快，适合一般协作任务。

2) isolated-renderer

会起一个独立的 BrowserWindow / renderer，适合更重的、需要更强隔离的任务。

什么时候用团队？ / When to use teams?

• 多个子任务天然可以并行
• 你希望 lead 统一汇总结果
• 你想把“任务分派”和“结果回收”分开
• 你要一个长期运行、可追踪的协作结构