otari多团队协作:组织、工作空间与成员权限管理的完整实践
otari多团队协作:组织、工作空间与成员权限管理的完整实践
otari 是一款开源的 OpenAI 兼容 LLM 网关,一个端点接入 40+ 模型服务商,并内置虚拟密钥、预算与用量跟踪。它的多团队协作能力由三层结构支撑:组织(Organization)、工作空间(Workspace)与成员角色(Role),让你把不同团队、不同应用隔离在同一套网关上。本文将带你完整走通 otari 多团队协作的组织、工作空间与成员权限管理实践。
为什么需要多层级的权限设计
很多团队把 OpenAI 密钥直接发给每个开发者,结果面临三个问题:
- 成本失控:谁花了多少钱无法精确到人和项目
- 无法隔离:所有团队共享一个密钥、一个预算
- 离职即事故:人员变动后密钥仍在流转
otari 的答案是把“谁、在哪个团队、用哪把钥匙、花多少钱”拆成四个独立维度:
| 维度 | otari 的实现 |
|---|---|
| 谁 | 身份(Identity)+ 成员角色 |
| 哪个团队 | 组织 + 工作空间 |
| 用哪把钥匙 | 绑定固定用户与工作空间的 API 密钥 |
| 花多少钱 | 按用户 / 按作用域的预算(Budget) |
otari 三层多团队协作结构
1. Organization:租户边界
组织是整个多租户的隔离边界。一个组织拥有自己的工作空间、成员、服务商密钥、定价覆盖、护栏策略和组织级用量视图。核心实现位于 organization_service.py,数据模型定义在 tenancy.py 中:组织拥有 workspace 行,用户通过 organization_member 和 workspace_member 两张关系表加入组织与工作空间。
创建组织后,你可以为不同业务线(如 AI 产品部、数据团队)各建一个组织,实现彻底的租户隔离。
2. Workspace:团队的资源单元
工作空间是日常协作的核心单元。API 密钥、用量记录、模型别名、路由策略、MCP 服务器和工具策略都在工作空间维度解析。路由见 workspaces.py:
POST /workspaces创建工作空间GET /workspaces/{id}/members列出成员POST /workspaces/{id}/members添加成员
典型用法:一个组织下建“生产环境”“开发测试”“数据标注”三个工作空间,各自独立的密钥和预算,互不干扰。
3. 成员角色:四级权限体系
组织成员和工作空间成员共用同一套四级角色(定义见 tenancy.py):
| 角色 | 权限说明 |
|---|---|
| Owner | 完全管理权,含组织级管理 |
| Admin | 管理大部分组织或工作空间资源 |
| Member | 使用工作空间,读取被允许的资源 |
| Viewer | 只读:能查看计给自己的 API 密钥,但无法创建、修改或删除,也不能使用 Playground |
两个容易踩坑的细节:
- 密钥归属工作空间:认证请求的 API 密钥决定其工作空间,调用方不能通过 header 切换到别的工作空间
- 降级即断密钥:把某人改为 Viewer,或将其移出工作空间,会自动关闭其自建的密钥;只有部署操作员(Operator)能重新开启
成员加入的 3 种方式
成员入口路由集中在 organizations.py,覆盖三种加入方式:
方式一:邀请链接(最常用)
POST /organizations/me/member-invitations(路由)邀请指定邮箱并选择角色与目标工作空间。支持粘贴多个邮箱批量邀请(bulk 接口,上限 100 个)。配置了邮件服务时自动发送接受链接;未配置时仪表盘直接展示链接供手动分享——这意味着没有 SMTP 也能完成团队组建。邀请链接一次性有效、有有效期,且可以重新签发(Reissue)来找回丢失的链接。
方式二:直接加入花名册
POST /organizations/me/members(路由)可以立即激活成员,无需接受邀请。新地址需通过注册、"忘记密码"或第三方登录完成首次登录。适合内部系统对接场景。
方式三:邮箱域自动加入
owner 或 admin 可以申请公司邮箱域名(/organizations/me/domains,路由)。验证方式是在域名根发布一条 TXT 记录:
otari-domain-verification=<token>
域名证明后,任何用已验证邮箱登录的用户自动以申请时指定的角色(仅限 member 或 viewer)加入组织。这条路径刻意不授予管理权限——证明域名控制权不等于对个人做决定。适合大规模团队免逐一邀请。
预算与用量:按工作空间精准归因
多团队协作的核心诉求是"钱算得清"。otari 的用量归因规则:
- 用量计入认证 API 密钥绑定的工作空间,再按登录身份的会员关系过滤可见范围
- 组织视图看全组织用量,工作空间视图看本团队用量
- 支持两种预算:按用户预算(每个用户独立限额)和按作用域预算(限组织/工作空间/成员/密钥,可细化到单个服务商)
被拒的请求返回 403 与 budget_exceeded 错误码,并附带 Retry-After 告知预算重置时间,客户端可优雅退避。
实践建议:一个中型团队怎么落地
- 建一个组织,按业务线建 2~3 个工作空间(生产 / 开发 / 实验)
- 角色分配:项目负责人给 Admin,普通开发者给 Member,财务或审计人员给 Viewer
- 每人一把密钥,绑定到自己的用户与工作空间,并配上按用户预算
- 关键应用用服务密钥(service key),按最终用户维度细分成本
- 配置邮箱域自动加入,新同事入职当天即可自助登录
- 每周查看组织级用量视图,把超支团队的工作空间预算收紧
相关文档与源码路径
想深入某一层,可以从这些文件入手:
- 权限与身份体系文档:docs/access-control.md
- 仪表盘导航说明(工作空间视图 / 组织视图 / 部署视图):docs/dashboard.md
- 组织管理路由:organizations.py
- 工作空间路由:workspaces.py
- 邀请流程路由:invitations.py
- 组织服务实现:organization_service.py
- 工作空间服务实现:workspace_service.py
- 租户数据模型:tenancy.py
掌握"组织定边界、工作空间归资源、角色定权限"这套三层模型,你就能在 otari 上把多团队的 LLM 用量管得清清楚楚。

