以编程方式使用文档

本页提供了全面的参考表 workspace 和 组织 操作的完整参考,以及哪些角色可以执行这些操作。

列表包括LangSmith中的API操作以及:

  • - 哪些系统角色可以执行每个操作。
  • - 所需的具体权限字符串。
  • - 关于部分访问或特殊情况的说明。

目录

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

附加信息:

图例

  • - ✓ **允许**: 具有此角色的用户可执行此操作
  • - ✗ **不允许**: 具有此角色的用户无法执行此操作
  • - ⚠ **部分**: 用户拥有受限访问权限(参见注释)

组织级操作

组织设置

操作组织管理员组织操作员组织用户组织查看者所需权限
查看组织信息✓✓✓✓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
List available permissions✓✓✓✓N/A (user-level)
创建自定义角色✓✓✗✗organization:manage
更新自定义角色✓✓✗✗organization:manage
删除自定义角色✓✓✗✗organization:manage

SSO和身份验证

操作组织管理员组织操作员组织用户组织查看者所需权限
查看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

访问策略

用于细粒度权限的基于属性的访问控制(ABAC)策略。

操作组织管理员组织操作员组织用户组织查看者所需权限
列出访问策略✓✓✓✓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:manage
列出个人访问令牌 (PAT)✓✓✓✗organization:read
创建个人访问令牌 (PAT)✓✓✓✗organization:pats:create
删除个人访问令牌 (PAT)✓✓✓✗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
导出详细使用情况为 CSV✓✓✓organization:read
查看工作区追踪保留设置✓✓✓✓organization:read
Set workspace default trace tier (base/extended)✓✓✗✗organization:manage
设置工作区扩展保留时长(企业版)✓✓✗✗organization:manage

工作区级操作

这些操作由以下内容控制 工作区级角色和权限.

项目

项目用于组织来自 LLM 应用程序的追踪和运行。

操作工作区管理员工作区编辑者工作区查看者所需权限
创建新项目✓✗✗projects:create
查看项目列表✓✓✓projects:read
查看项目详情✓✓✓projects:read
查看预置仪表板✓✓✓projects:read
查看项目元数据(Top K 值)✓✓✓projects:read
更新项目元数据(名称、描述、标签)✓✓✗projects:update
增加项目追踪保留期(基础 → 扩展)✓✓✗projects:increase-trace-tier*
减少项目追踪保留期(扩展 → 基础)✓✓✗projects:decrease-trace-tier*
创建筛选视图✓✗✗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
Query/list runs✓✓✓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
运行 Playground 实验(批处理)✓⚠✗prompts:read + datasets:read + projects:create
运行 Playground 实验(流式)✓⚠✗prompts:read + datasets:read + projects:create
运行 Studio 实验✓⚠✗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
Create feedback with token (no auth required)✓✓✓N/A (token-based)
列出反馈配置✓✓✓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 部署 configurations.

操作工作区管理员工作区编辑者工作区查看者所需权限
创建部署✓✓✗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:manage
查看使用限制✓✓✓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

批量导出

操作工作空间管理员工作空间编辑者工作空间查看者所需权限
列出批量导出✓✓✓bulk-exports:read
获取批量导出✓✓✓bulk-exports:read
获取批量导出运行记录✓✓✓bulk-exports:read
获取批量导出运行✓✓✓bulk-exports:read
创建批量导出✓✗✗bulk-exports:manage
取消批量导出✓✗✗bulk-exports:manage
获取批量导出目标✓✓✓bulk-exports:read
获取批量导出目标项✓✓✓bulk-exports:read
创建批量导出目标✓✗✗bulk-exports:manage
更新批量导出目标✓✗✗bulk-exports:manage
获取筛选后的导出运行记录✓✓✓bulk-exports:read

MCP 服务器

用于扩展功能的模型上下文协议服务器。

操作工作空间管理员工作空间编辑者工作空间查看者所需权限
列出 MCP 服务器✓✓✓workspaces:read
获取 MCP 服务器✓✓✓workspaces:read
创建 MCP 服务器✓✓✓workspaces:read
更新 MCP 服务器✓✓✓workspaces:read
删除 MCP 服务器✓✓✓workspaces:read

Fleet

Fleet 工作空间管理操作。

操作工作空间管理员工作空间编辑者工作空间查看者所需权限
查看 Fleet 管理区域(使用量、消费)✓✗✗fleet:read-admin-config
管理 Fleet 消费限制✓✗✗fleet:write-admin-config

用户级操作

以下操作对所有已认证用户可用,无需特定的工作空间或组织权限:

  • - 查看自己的用户资料
  • - 更新自己的用户资料
  • - 列出用户所属的组织
  • - 创建新组织
  • - 列出待处理的工作空间邀请
  • - 删除待处理的工作空间邀请
  • - 接受待处理的工作空间邀请
  • - 列出待处理的组织邀请
  • - 删除待处理的组织邀请
  • - 接受待处理的组织邀请

权限继承

从组织到工作空间

  • - 组织管理员 自动拥有所有工作空间的完整权限。
  • - 组织操作员 仅在通过工作空间级角色明确添加到工作空间时(或在他们创建的工作空间中)才能获得工作空间访问权限。
  • - 组织用户 和 组织查看者 仅在通过工作空间级角色明确添加到工作空间时才能获得工作空间访问权限。

有关详细的角色定义,请参阅 组织角色 和 工作空间角色.

工作空间角色独立性

  • - 用户可以在不同的工作空间拥有不同的工作空间角色。
  • - 一个用户可能是 工作空间管理员 在一个工作空间中,而在另一个工作空间中是一个 工作空间查看者 。