协作与团队
一个人用 combo agent 很简单;团队用要理清"谁看得到什么"和"任务怎么接力"。本页讲这些。
1. 三层身份模型
| 层级 | 说明 | 隔离粒度 |
|---|---|---|
| 组织 | 最大单位,通常 = 一家公司 | 顶级隔离 |
| 租户 | 组织下的业务单元,各自独立资源 | Agent / 知识库 / 技能 / 设置 都隔离 |
| 用户 | 可属于多个租户 | 顶部切租户进入对应视图 |
详细技术模型见 核心概念 / 多租户。
2. 跨租户切换
顶部头像 → 切换租户 弹出租户列表,点击即进入该租户资源视图。

切换后整个左侧(会话列表 / 知识库 / 技能 / Agent)都跟着换。当前租户在顶部会一直显示。
你在 A 租户的会话,在 B 租户看不到。如果需要把 A 租户的知识库提供给 B 租户,要把知识库设置里的权限改为共享——但共享仅限本租户内,跨租户不支持自动共享,需要联系 Owner 手动迁移或复制。
3. 团队角色与邀请
进入 个人中心 → 团队 管理本租户成员。
3.1 三种角色
| 角色 | 建租户 | 邀请/踢人 | 计费 | 建 Agent/KB | 用技能 |
|---|---|---|---|---|---|
| Owner | ✓ | ✓ | ✓ | ✓ | ✓ |
| Normal | — | — | — | ✓ | ✓ |
| Invite(待接受) | — | — | — | — | — |
3.2 邀请流程
4. 会话层面的协作
4.1 多会话并行
每个用户可以同时开多个会话,每个会话有独立的:
- Plan Mode 状态
- 消息历史
- 临时附件
- 产出物编辑器状态
在左侧会话列表可以快速切换。系统后台并发运行,互不阻塞。
Plan Mode 是会话级持久化:切回来还是之前那个档位。
4.2 会话归档与清理
| 操作 | 位置 | 效果 |
|---|---|---|
| 重命名 | 会话右键 | 改显示名 |
| 归档 | 会话右键 | 移出主列表到归档区,历史保留 |
| 取消归档 | 归档区右键 | 移回主列表 |
| 删除 | 会话右键 → 删除 | 硬删除,消息 + 临时文件一起删(知识库正式库不受影响) |
| 清空所有会话 | 顶栏辅助菜单 | 危险操作,需要二次确认 |
4.3 会话共享 / 链接分享
点会话标题 → 分享按钮,生成一个带权限的链接:
| 权限 | 说明 |
|---|---|
| 只读链接 | 仅本租户成员可看,不能编辑 / 继续对话 |
| 协作链接 | 本租户成员可看 + 可在同一会话里继续对话 |
| 公开分享(需 Owner 开启) | 任何人(不登录)可看,仅用于演示;无法编辑 |

4.4 会话隔离(Session Scope)
在 Agent 设置 / 会话 Panel 选择:
| 模式 | 团队使用建议 |
|---|---|
| per-sender | 适合"每人一个 Agent 独立用"场景 |
| per-agent | 适合"每个 Agent 一条专用会话" |
| shared | 适合团队接力同一个任务,多成员共用同一条 session,看对方的消息 |
5. 跨会话接力:Graft(超重要)
这是 combo agent 区别于常规聊天产品的关键能力。任务复杂时,你会把它拆成多条独立 session,每条 session 做一件事;后面的 session 通过 graft 引用前面 session 的产出,实现"拼装"。
5.1 动机
一条 session 里把所有事干完的问题:
- 上下文越来越长,压缩丢细节
- 成员无法分工并行
- 中间产物难以独立归档复用
Graft 的解法:把中间产物沉淀为独立 session,后续按需引用。
5.2 架构
5.3 怎么用
在 Session C 的 ChatInput 里:
或者走 /graft 技能菜单手动选源 session,系统自动填入引用。Session C 运行时会按需加载 A、B 的产物上下文,不用你手动复制。
5.4 权限
- 默认:只能 graft 自己的 session 和本租户已共享的 session
- 如果源 session 是协作共享的,其他成员也可 graft
- 跨租户不能 graft(数据隔离硬边界)
5.5 适用场景
| 场景 | 怎么拆 |
|---|---|
| ASPICE 双基线对比 | Session A(v1.14 追溯)+ B(v1.17 追溯)→ C(diff + 影响) |
| 代码审查分工 | Session 每人审一个模块 → 合并 Session 汇总 / 出总报告 |
| 专利撰写 | Session 构思 + 查新 → 独立 Session 写权利要求 → graft 回主说明书 |
6. 知识库协作
| 权限 | 谁看得见 | 谁能编辑 |
|---|---|---|
| 私有 | 仅创建者 | 仅创建者 |
| 租户共享 | 本租户全体成员 | 仅 Owner + 创建者 |
切换权限:在知识库设置 → 权限里修改。详见 知识库。
7. Agent 协作
Agent 创建时可选:
| 可见性 | 说明 |
|---|---|
| 私有 | 仅创建者 |
| 团队可用 | 本租户全体成员可调用 |
| 公开(需 Owner 权限开启) | 跨租户可调用(仅针对对外 API 产品) |
Agent 模板:Owner 可以发布"官方 Agent 模板"到租户级,所有成员可以一键复制为自己的 Agent 并在此基础上微调。
8. 技能协作
user 级技能可以分享为 tenant 级:进入 个人中心 → 技能 → 卡片 → "分享"按钮。
分享后全租户可见可用。分享是单向动作,如需撤回,只能删除技能后本地重装。
9. 审计与合规
团队使用场景下,Owner 需要看到:
- 谁在什么时间调用了什么 Agent
- 调用消耗了多少 token
- 使用了哪些知识库 / 技能
- 生成了什么产出物
审计数据入口:
- 个人中心 → 模型 底部的 Langfuse 卡片:所有 LLM 调用的 trace
- 个人中心 → 事件触发 里的执行历史
- 个人中心 → 定时任务 里的运行历史
- API 审计:参考 / HTTP API 提供
GET /v1/audit/...系列端点
更深入的监控建议 + 合规能力:部署 / 安全与合规
10. 最佳实践
10.1 小团队(5–20 人)
- 1 个租户,所有人在一起
- 每个业务领域建一个团队知识库
- Agent 模板由资深成员创建后公开给团队
- 会话per-sender模式,各自私有
- Graft 用于跨人任务接力
10.2 多业务线大团队(50+ 人)
- 多个租户:按事业部 / 按产品线划分
- 跨租户的公共能力沉淀到 平台 Owner 租户的模板
- 定期做审计报表:Owner 每周看 Langfuse + 执行历史
- Quota:在 Hikari Dashboard 配置单租户/单用户的 token / 会话并发上限
10.3 外部协作(客户 / 供应商)
- 给外部合作方开独立租户
- 通过 API Key 授权特定 Agent,限制只能访问某几个知识库
- 所有对外产物只通过公开分享链接,不直接开账号
11. 下一步
- 回到 Plan Mode / ChatInput 使用细节 → 会话界面
- 设置审计与监控 → 其它设置 / Langfuse
- 部署私有环境 + 团队隔离 → 部署 / 安装