otari多团队协作:组织、工作空间与成员权限管理的完整实践

原创2026-10-30 16:36:181,353 阅读

otari多团队协作:组织、工作空间与成员权限管理的完整实践

otari 是一款开源的 OpenAI 兼容 LLM 网关,一个端点接入 40+ 模型服务商,并内置虚拟密钥、预算与用量跟踪。它的多团队协作能力由三层结构支撑:组织(Organization)、工作空间(Workspace)与成员角色(Role),让你把不同团队、不同应用隔离在同一套网关上。本文将带你完整走通 otari 多团队协作的组织、工作空间与成员权限管理实践。

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 添加成员

典型用法:一个组织下建“生产环境”“开发测试”“数据标注”三个工作空间,各自独立的密钥和预算,互不干扰。

otari仪表盘:工作空间切换器、支出概览、API Keys与成员管理面板

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 告知预算重置时间,客户端可优雅退避。

实践建议:一个中型团队怎么落地

  1. 建一个组织,按业务线建 2~3 个工作空间(生产 / 开发 / 实验)
  2. 角色分配:项目负责人给 Admin,普通开发者给 Member,财务或审计人员给 Viewer
  3. 每人一把密钥,绑定到自己的用户与工作空间,并配上按用户预算
  4. 关键应用用服务密钥(service key),按最终用户维度细分成本
  5. 配置邮箱域自动加入,新同事入职当天即可自助登录
  6. 每周查看组织级用量视图,把超支团队的工作空间预算收紧

相关文档与源码路径

想深入某一层,可以从这些文件入手:

掌握"组织定边界、工作空间归资源、角色定权限"这套三层模型,你就能在 otari 上把多团队的 LLM 用量管得清清楚楚。

登录后查看全文
otari