官方 LangSmith Terraform 提供程序 允许您以代码方式管理 LangSmith 组织和工作区资源——包括工作区、自定义角色、组织和工作区成员、评估器、运行规则以及警报规则。它是 使用 API 管理组织 的基础设施即代码(Infrastructure-as-Code)对应方案。
在开始之前,阅读以下内容可能会有所帮助:

安装与配置

将提供程序添加到您的 Terraform 配置中并锁定版本:
然后运行 terraform init 以下载该提供程序。

认证

该提供程序解析凭据的方式与 LangSmith SDK 和 CLI 相同。建议优先使用环境变量或配置文件,而不是硬编码 api_key:
  • 环境变量— LANGSMITH_API_KEY、LANGSMITH_ENDPOINT(API URL)、LANGSMITH_WORKSPACE_ID。
  • 配置文件— 设置 profile(或 LANGSMITH_PROFILE)以使用 LangSmith CLI 配置文件。
  • 提供程序参数— api_key、api_url、workspace_id、profile。
在 LangSmith 设置中创建 API 密钥或服务密钥。有关可用密钥类型,请参阅认证方法。
组织范围的操作——创建工作区和邀请组织成员——需要一个具有组织管理员权限的、组织范围的服务密钥。要定位工作区范围的资源(如工作区成员资格、评估器和运行规则),请设置 workspace_id(或 LANGSMITH_WORKSPACE_ID)。

示例

创建工作区

管理角色与成员

使用数据源查找内置角色,然后进行分配。以下示例邀请一位用户加入组织,并授予其对工作区的管理员权限:
您也可以定义自定义工作区角色,例如通过克隆现有角色的权限:

自动化评估器、运行规则与警报

该提供程序管理的内容不仅仅是账户。您可以将在线代码评估器、应用它们的运行规则以及警报与您的工作区一同进行代码化管理:

资源参考

完整的资源与数据源列表——包括所有参数和属性——已在 Terraform 注册表上发布并保持同步:

Terraform 注册表上的 LangSmith 提供程序

浏览所有资源和数据源的完整参考文档。