LangChain 团队怎么用：多人共享、权限与账单入口

LangChain 的多人协作落在它的 LangSmith 平台上（调试、追踪与评估的托管服务），本文只讲团队真正要用的三件事：把人邀进来、把权限分对、找到账单入口。所有”哪个设置属于组织、哪个属于工作区”的判断都按官方 Administration 文档的作用范围表逐项对齐，不掺未核到的套餐名额与价格。

截至 2026-11-02 抓取，官方 Administration 概览覆盖权限、账单与使用量限制三块规则；本文的每一步都给出可直接粘贴的地址与验证标志。

前置条件（3 项可执行）

1. 能登录 LangSmith：打开 https://smith.langchain.com，用账号正常进入控制台。首次登录会自动创建一个组织，后续所有”组织级/工作区级”设置都挂在它下面。
2. 知道自己是组织管理员：进入 https://smith.langchain.com/settings/organization，能看到组织设置项即具备管理视角；套餐与计费在这一层（见下表）。
3. 区分两个层级：官方作用范围表把设置分成组织级与工作区级两列，先看懂这张表，后面每一步才知道自己在哪一层操作。

先看懂作用范围表：组织级 vs 工作区级

官方 Administration 文档给出的范围表（本文按其列示，未列项表示官方未归类；RBAC 行的官方原名是 Workspace RBAC: Assigning Workspace Roles，权限策略细节见 access-policies 锚点）：

这张表是本文的操作主线：要人和权限去工作区，要钱去组织。个人版与团队版的套餐名额、单价等信息官方定价页才有时效值，本文不写死数字。

3 步完成团队初始化

1. 账单与套餐入口（组织级）

进入 https://smith.langchain.com/settings/billing。按作用范围表，套餐与计费、积分、发票都是组织级设置——升级、查积分、下载发票都在这一页完成。官方定价页 https://langchain.com/pricing 展示当前套餐差异与按用户数计费的说明；页面上的套餐按钮与价格以你打开时的实时显示为准（本文不写死”点哪个按钮升级”，因为官方文档未给出该按钮的固定文案）。官方 billing 指南里与团队最相关的四节是：Set up billing for your account（账号账单初始化）、Enforce spend limits（用使用量限制与数据保留管控花费）、Set spend limit for workspace（按工作区设花费上限）、Invoice email（发票邮件配置）——按这四节的标题就能在页面左侧目录里直接定位，逐项核对当前配置。

2. 邀请成员并分配角色（工作区级）

官方范围表对邀请写了两层，按成员是否已在组织里选路径：新人先组织后工作区——组织层用 Invite User to Organization 把人拉进组织（https://smith.langchain.com/settings/organization 的成员管理），已在组织内的人再用 Invite User to Workspace 拉进具体工作区（https://smith.langchain.com/settings/workspaces → 目标工作区 → 成员管理 → 邀请，输入邮箱发送）。两层都做完，成员才真正可用；权限按官方表走 RBAC：分配工作区角色——进工作区后给成员绑定该工作区的角色。权限粒度的官方规则（access-policies，2026-09-15 更新）：内置角色保持原有权限；此后新建的自定义角色需要显式勾选权限（例如模型价格相关的 model-price-map 独立成勾选项），导出类权限也有独立项（bulk-exports:read / bulk-exports:manage），不必连带授予更宽的 workspaces:manage。

3. 设置使用量上限（工作区级）

在工作区设置里找数据保留、使用量上限（官方表所列的两项），按月度上限配置。配套的接入开关是官方 Getting started 原话：Set LANGSMITH_TRACING=true and your API key——即先开追踪开关再配密钥：

export LANGSMITH_TRACING=true
# 再按官方接入说明配置你的 API key（组织的 API 密钥在工作区层发放）

常见卡点与官方解法

卡点 1：自定义角色改了权限却不生效

官方 access-policies 的规则是：内置角色的权限在更新中保持不变，而此后创建的自定义角色必须显式授予新权限（model-price-map 在自定义角色编辑器里是独立勾选项）。所以现象是”老角色正常、新建角色缺权限”。解法：进入角色编辑器，把需要的权限逐项勾选保存，再重试对应操作；服务用的密钥如果只需要导出，用 bulk-exports 两项即可，别为省事直接给 workspaces:manage。

卡点 2：用量到顶收到 429

官方报错原文（Administration 文档 Usage limits 节）：This 429 is the result of reaching your usage limit as configured by your organization admin，并说明该限制在 UTC 每个自然月月初开始的固定窗口内评估、次月月初重置。解法：确认上限配在了预期的工作区层；固定窗口意味着月中调高上限不会追补已消耗的额度，需要在下个窗口前评估是否调整套餐。

卡点 3：账单明细对不上

官方 LangSmith billing 指南 与 invoice 说明原话：On your LangSmith invoice, you will see two metrics that we charge for（发票上有两个计费指标）。解法：组织层进入 https://smith.langchain.com/settings/billing 核对积分与发票；指标的当前口径与单价以定价页与账单页实时显示为准，本文不转述未核到的金额。

成功验证标志

1. 被邀请人在工作区成员列表里出现，且已绑定角色（组织层页面看不到成员绑定，那是工作区层的设置）。
2. 使用量上限页显示已配置的月度数值，且 LANGSMITH_TRACING=true 已在接入环境生效（追踪数据开始上报）。
3. 组织层 billing 页能看到套餐、积分与发票三个入口（组织级设置的三项）。

官方入口与后续文档

• 管理概览（权限、账单、使用量限制的总规则）：https://docs.langchain.com/langsmith/administration-overview
• 组织与工作区操作参考（本文范围表出处）：https://docs.langchain.com/langsmith/organization-workspace-operations
• 定价页（套餐差异与计费口径）：https://langchain.com/pricing
• 控制台账单页：https://smith.langchain.com/settings/billing

参考来源

• LangSmith Administration – Docs by LangChain：权限、账单、使用量限制与 429 官方原文的出处。
• Organization and workspace operations reference：组织级/工作区级作用范围表的出处。
• LangChain 官方定价页：套餐与计费口径。
• LangSmith 控制台 billing 页：账单、积分、发票入口。