Skip to main content
本文档提供了工作空间组织操作的完整参考表格,以及哪些角色可以执行这些操作。 列表中包含 LangSmith 中的 API 操作,以及:
  • 哪些系统角色可以执行每项操作。
  • 所需的特定权限字符串。
  • 关于部分访问权限或特殊情况的说明。
有关 LangSmith 基于角色的访问控制(RBAC)系统、角色定义和权限概念的概述,请参阅基于角色的访问控制

目录

组织级操作工作空间级操作
核心管理:
组织设置:组织信息和配置
工作空间:工作空间管理
组织成员:成员管理
角色与权限:自定义角色
核心资源:
项目:整理追踪记录和运行
运行记录:单个执行追踪
数据集:用于评估的测试数据集
示例:数据集中的单个示例
实验:对比实验
安全与认证:
单点登录与认证:单点登录设置
SCIM:身份预配置
访问策略:基于属性的访问控制
监控与分析:
规则:自动化运行规则
告警:用于监控的告警规则
反馈:对输出的评分和标签
标注队列:人工审核队列
图表:自定义可视化
计费与账户:
计费与支付:订阅管理
API 密钥:组织级密钥
开发与配置:
提示词:提示词模板(LangChain Hub)
部署:部署配置
MCP 服务器:模型上下文协议服务器
分析:
图表与仪表板:组织级可视化
用量与分析:用量追踪和 TTL 设置
工作空间管理:
工作空间设置:成员、设置
标签:元数据标签系统
批量导出:数据导出操作
补充信息:

图例

  • 允许:拥有此角色的用户可以执行此操作
  • 不允许:拥有此角色的用户不能执行此操作
  • 部分:用户拥有有限访问权限(参见说明)

组织级操作

组织级操作由组织角色控制,该角色独立于 RBAC 功能。更多信息请参阅基于角色的访问控制指南。

组织设置

操作组织管理员组织操作员组织用户组织查看者所需权限
查看组织信息organization:read
查看组织仪表板organization:read
更新组织信息organization:manage
查看计费信息organization:read
查看公司信息organization:read
设置公司信息organization:manage

工作空间

组织级的工作空间管理操作。
操作组织管理员组织操作员组织用户组织查看者所需权限
列出所有工作空间organization:read
创建工作空间organization:manage

组织成员

操作组织管理员组织操作员组织用户组织查看者所需权限说明
查看组织成员organization:read
查看活跃组织成员organization:read
查看待加入组织成员organization:read
邀请成员加入组织organization:manage组织操作员只能邀请组织用户和组织查看者
批量邀请成员organization:manage组织操作员只能邀请组织用户和组织查看者
添加基础认证成员organization:manage组织操作员只能添加组织用户和组织查看者
移除组织成员organization:manage组织操作员不能移除组织管理员
更新组织成员角色organization:manage组织操作员只能修改组织用户和组织查看者
删除待加入组织成员organization:manage组织操作员不能删除待加入的组织管理员邀请

角色与权限

操作组织管理员组织操作员组织用户组织查看者所需权限
列出组织角色organization:read
列出可用权限不适用(用户级)
创建自定义角色organization:manage
更新自定义角色organization:manage
删除自定义角色organization:manage

单点登录与认证

操作组织管理员组织操作员组织用户组织查看者所需权限
查看 SSO 设置organization:read
创建 SSO 设置organization:manage
更新 SSO 设置organization:manage
删除 SSO 设置organization:manage
查看登录方式organization:read
更新允许的登录方式organization:manage
设置默认 SSO 预配置organization:manage

SCIM

用于用户预配置的跨域身份管理系统。
操作组织管理员组织操作员组织用户组织查看者所需权限
列出 SCIM 令牌organization:read
获取 SCIM 令牌organization:read
创建 SCIM 令牌organization:manage
更新 SCIM 令牌organization:manage
删除 SCIM 令牌organization:manage

访问策略

用于细粒度权限的基于属性的访问控制策略。
操作组织管理员组织操作员组织用户组织查看者所需权限
列出访问策略organization:read
获取访问策略organization:read
创建访问策略organization:manage
删除访问策略organization:manage
将访问策略附加到角色organization:manage

计费与支付

操作组织管理员组织操作员组织用户组织查看者所需权限
创建 Stripe 设置意向organization:manage
处理支付方式创建organization:manage
更改付款计划organization:manage
创建 Stripe 结账会话organization:manage
确认结账完成organization:manage
创建 Stripe 账户链接organization:manage

API 密钥

操作组织管理员组织操作员组织用户组织查看者所需权限
列出组织范围的服务密钥organization:read
创建组织范围的服务密钥(工作空间范围)*organization:pats:create
创建组织范围的服务密钥(组织范围)*organization:pats:create + organization:manage
列出个人访问令牌organization:read
创建个人访问令牌organization:pats:create
删除个人访问令牌organization:read
* 组织操作员和组织用户只能为他们担任工作空间管理员的工作空间创建工作空间范围的服务密钥。组织范围的服务密钥需要组织管理员角色。

组织图表与仪表板

操作组织管理员组织操作员组织用户组织查看者所需权限
列出组织图表organization:read
按 ID 获取组织图表organization:read
创建组织图表organization:manage
更新组织图表organization:manage
删除组织图表organization:manage
渲染组织图表organization:read
获取组织图表分区organization:read
创建组织图表分区organization:manage
更新组织图表分区organization:manage
删除组织图表分区organization:manage
渲染组织图表分区organization:read

用量与分析

操作组织管理员组织操作员组织用户组织查看者所需权限
查看组织用量organization:read
查看细粒度计费用量organization:read
将细粒度用量导出为 CSVorganization:read
查看 TTL 设置organization:read
更新 TTL 设置organization:manage

工作空间级操作

这些操作由工作空间级角色和权限控制。
要了解每个角色的含义及其总体能力,请参阅基于角色的访问控制指南。

项目

项目用于组织来自您的 LLM 应用的追踪记录和运行。
操作工作空间管理员工作空间编辑者工作空间查看者所需权限
创建新项目projects:create
查看项目列表projects:read
查看项目详情projects:read
查看预构建仪表板projects:read
查看项目元数据(前 K 个值)projects:read
更新项目元数据(名称、描述、标签)projects:update
创建筛选视图projects:create
查看筛选视图projects:read
查看特定筛选视图projects:read
更新筛选视图projects:update
删除筛选视图projects:delete
删除项目projects:delete
删除多个项目projects:delete
获取洞察任务(测试版)projects:read
获取特定洞察任务(测试版)projects:read
创建洞察任务(测试版)projects:read + rules:create
更新洞察任务(测试版)projects:update
删除洞察任务(测试版)projects:delete
获取洞察任务配置(测试版)rules:read
创建洞察任务配置(测试版)rules:create
自动生成洞察任务配置(测试版)rules:create
更新洞察任务配置(测试版)rules:update
删除洞察任务配置(测试版)rules:delete
从洞察任务获取运行聚类(测试版)projects:read
从洞察任务获取运行记录(测试版)projects:read

运行记录

来自您的 LLM 应用的单个执行追踪和跨度。
操作工作空间管理员工作空间编辑者工作空间查看者所需权限
从 SDK 发送追踪(包括单个运行、批量、多部分和 OTEL)runs:create
查看特定运行记录runs:read
查看线程预览runs:read
查询/列出运行记录runs:read
查看运行统计信息runs:read
查看分组的运行统计信息runs:read
按表达式分组运行记录runs:read
从自然语言生成筛选查询runs:read
预取运行记录runs:read
更新运行记录(PATCH)runs:create
查看运行记录共享状态runs:read
公开共享运行记录runs:share
取消共享运行记录runs:share
按追踪 ID 或元数据删除运行记录runs:delete

规则

基于运行条件触发操作的自动化运行规则。
操作工作空间管理员工作空间编辑者工作空间查看者所需权限
列出所有运行规则rules:read
创建运行规则rules:create
更新运行规则rules:update
删除运行规则rules:delete
查看规则日志rules:read
获取最后应用的规则rules:read
手动触发规则rules:update
触发多个规则rules:update

告警

用于监控运行条件的告警规则。
操作工作空间管理员工作空间编辑者工作空间查看者所需权限
创建告警规则runs:read
更新告警规则runs:read
删除告警规则runs:read
获取告警规则runs:read
列出告警规则runs:read
测试告警操作runs:read

数据集

包含用于评估的示例的测试数据集。
操作工作空间管理员工作空间编辑者工作空间查看者所需权限
创建数据集datasets:create
列出数据集datasets:read
查看数据集详情datasets:read
更新数据集元数据datasets:update
删除数据集datasets:delete
上传 CSV 数据集datasets:create
克隆数据集datasets:update
获取数据集版本datasets:read
获取数据集版本列表datasets:read
比较数据集版本差异datasets:read
更新数据集版本(标签)datasets:update
下载数据集(OpenAI 格式)datasets:read
下载数据集(OpenAI 微调格式)datasets:read
下载数据集(CSV)datasets:read
下载数据集(JSONL)datasets:read
查看数据集共享状态datasets:read
公开共享数据集datasets:share
取消共享数据集datasets:share
获取索引信息datasets:read
索引数据集datasets:update
同步数据集索引datasets:update
移除数据集索引datasets:update
搜索数据集datasets:read
生成合成示例datasets:update
获取数据集拆分datasets:read
更新数据集拆分datasets:read
运行游乐场实验(批量)prompts:read + datasets:read + projects:create
运行游乐场实验(流式)prompts:read + datasets:read + projects:create
运行工作室实验datasets:read + projects:create
工作空间编辑者拥有部分访问权限,因为他们不能创建项目,这限制了他们创建新实验的能力。

示例

数据集中的单个示例。
操作工作空间管理员工作空间编辑者工作空间查看者所需权限
统计示例数量datasets:read
查看特定示例datasets:read
列出示例datasets:read
创建新示例datasets:update
批量创建示例datasets:update
更新单个示例datasets:update
批量更新示例datasets:update
批量更新示例(多部分)datasets:update
从 CSV 上传示例datasets:update
从 JSONL 上传示例datasets:update
删除单个示例datasets:update
批量删除示例datasets:update
查看带有运行记录的示例datasets:read
查看带有运行记录的分组示例datasets:read
验证单个示例datasets:read
批量验证示例datasets:read

实验

用于评估 LLM 输出的对比实验。
操作工作空间管理员工作空间编辑者工作空间查看者所需权限
查看对比实验projects:read
创建对比实验projects:create
删除对比实验projects:delete
查看带有运行记录的示例datasets:read
查看带有运行记录的分组示例datasets:read
查看分组实验datasets:read
查看反馈差异datasets:read
上传实验结果datasets:create + datasets:update + projects:create + runs:create
获取实验视图覆盖datasets:update
创建实验视图覆盖datasets:update
更新实验视图覆盖datasets:update
删除实验视图覆盖datasets:update
工作空间编辑者拥有部分访问权限,因为他们不能创建项目,这限制了他们创建新实验的能力。

反馈

对 LLM 输出的评分、标签和修正。
操作工作空间管理员工作空间编辑者工作空间查看者所需权限
列出反馈公式feedback:read
获取反馈公式feedback:read
创建反馈公式feedback:create
更新反馈公式feedback:update
删除反馈公式feedback:delete
查看特定反馈feedback:read
列出反馈feedback:read
创建反馈feedback:create
即时创建反馈feedback:create
更新反馈feedback:update
删除反馈feedback:delete
批量导入反馈feedback:create
创建反馈导入令牌feedback:create
列出反馈导入令牌feedback:create
使用令牌创建反馈(无需认证)不适用(基于令牌)
列出反馈配置feedback:read
创建反馈配置feedback:create
更新反馈配置feedback:update

标注队列

用于 LLM 输出的人工审核队列。
操作工作空间管理员工作空间编辑者工作空间查看者所需权限
列出标注队列annotation-queues:read
获取标注队列annotation-queues:read
创建标注队列annotation-queues:create
更新标注队列annotation-queues:update
删除标注队列annotation-queues:delete
填充标注队列annotation-queues:update
从队列获取运行记录annotation-queues:read
从队列获取运行记录(按索引)annotation-queues:read
获取运行记录的队列annotation-queues:read
获取队列总大小annotation-queues:read
获取队列总归档数annotation-queues:read
获取队列大小annotation-queues:read
将运行记录添加到队列annotation-queues:update
更新队列中的运行记录annotation-queues:update
从队列中删除运行记录annotation-queues:update
批量从队列中删除运行记录annotation-queues:update
创建身份标注队列运行状态annotation-queues:update
导出归档运行记录annotation-queues:read

提示词

LangChain Hub 中的提示词模板和链。
操作工作空间管理员工作空间编辑者工作空间查看者所需权限
列出提示词仓库prompts:read
查看提示词仓库prompts:read
创建提示词仓库prompts:create
复刻提示词仓库prompts:create
更新提示词仓库prompts:update
删除提示词仓库prompts:delete
列出提交记录prompts:read
查看提交记录prompts:read
推送提交prompts:update
列出仓库标签prompts:read
获取所有标签prompts:read
创建标签prompts:tag
更新标签prompts:tag
删除标签prompts:tag
查看事件prompts:read
列出评论prompts:read
创建评论prompts:read
删除评论prompts:read
切换点赞状态prompts:read
优化提示词prompts:update
列出优化任务prompts:read
创建优化任务prompts:create
更新优化任务prompts:update
删除优化任务prompts:delete
调用提示词画布prompts:update
列出快捷操作prompts:read
创建快捷操作prompts:read
删除快捷操作prompts:read
更新快捷操作prompts:read
某些提示词操作支持对共享提示词的公共访问。

图表

自定义可视化和仪表板。
操作工作空间管理员工作空间编辑者工作空间查看者所需权限
列出图表charts:read
按 ID 获取图表charts:read
创建图表charts:create
更新图表charts:update
删除图表charts:delete
渲染图表charts:read
列出图表分区charts:read
按 ID 获取图表分区charts:read
创建图表分区charts:create
更新图表分区charts:update
删除图表分区charts:delete
渲染图表分区charts:read

部署

LangSmith 部署配置。
操作工作空间管理员工作空间编辑者工作空间查看者所需权限
创建部署deployments:create
查看部署deployments:read
更新部署deployments:update
删除部署deployments:delete

工作空间设置与管理

操作工作空间管理员工作空间编辑者工作空间查看者所需权限
查看工作空间信息workspaces:read
查看工作空间统计信息workspaces:read
更新工作空间(名称、描述)workspaces:manage
删除工作空间workspaces:manage
查看工作空间成员workspaces:read
查看活跃工作空间成员workspaces:read
查看待加入工作空间成员workspaces:read
添加成员到工作空间workspaces:manage-members
批量添加成员workspaces:manage-members
更新工作空间成员角色workspaces:manage-members
移除工作空间成员workspaces:manage-members
删除待加入工作空间成员workspaces:manage-members
查看用量限制workspaces:read
查看共享实体workspaces:read
批量取消共享实体workspaces:manage

标签

操作工作空间管理员工作空间编辑者工作空间查看者所需权限
列出标签键workspaces:read
获取标签键workspaces:read
创建标签键workspaces:manage
更新标签键workspaces:manage
删除标签键workspaces:manage
列出标签值workspaces:read
获取标签值workspaces:read
创建标签值workspaces:manage
更新标签值workspaces:manage
删除标签值workspaces:manage
列出标签workspaces:read
列出资源的标签workspaces:read
批量列出资源的标签workspaces:read
列出标签关联workspaces:read
创建标签关联workspaces:manage
删除标签关联workspaces:manage###批量导出
操作工作空间管理员工作空间编辑者工作空间查看者所需权限
列出批量导出workspaces:read
获取批量导出workspaces:read
创建批量导出workspaces:manage
取消批量导出workspaces:manage
获取批量导出目标位置workspaces:read
获取批量导出目标位置详情workspaces:read
创建批量导出目标位置workspaces:manage
获取筛选后的导出运行记录workspaces:read

MCP 服务器

用于扩展功能的模型上下文协议服务器。
操作工作空间管理员工作空间编辑者工作空间查看者所需权限
列出 MCP 服务器workspaces:read
获取 MCP 服务器workspaces:read
创建 MCP 服务器workspaces:read
更新 MCP 服务器workspaces:read
删除 MCP 服务器workspaces:read

用户级操作

以下操作对所有已认证用户开放,无需特定的工作空间或组织权限:
  • 查看自己的用户资料
  • 更新自己的用户资料
  • 列出用户所属的组织
  • 创建新组织
  • 列出待处理的工作空间邀请
  • 删除待处理的工作空间邀请
  • 接受待处理的工作空间邀请
  • 列出待处理的组织邀请
  • 删除待处理的组织邀请
  • 接受待处理的组织邀请

权限继承

组织到工作空间

  • 组织管理员 自动拥有所有工作空间中的完整权限。
  • 组织操作者 只有在被显式添加到工作空间并赋予工作空间级角色(或自己创建工作空间)时,才能获得工作空间访问权限。
  • 组织普通用户组织查看者 只有在被显式添加到工作空间并赋予工作空间级角色时,才能获得工作空间访问权限。
有关角色定义的详细信息,请参阅组织角色工作空间角色

工作空间角色独立性