主题
BYOC 入门指南
设置 LangSmith BYOC 数据平面，从在组织中启用 BYOC 到创建工作区以及进行私有连接。
开始之前，请查看前提条件。
默认情况下，LangChain 会为你的数据平面创建 VPC。若要自行创建和管理网络，请在创建下面的 IAM 角色和数据平面之前，遵循AWS 上的自带 VPC。
Enable BYOC on your organization
在 aws.smith.langchain.com 上的 AWS 中创建 LangSmith 组织，或复用现有组织。
将你的组织 ID 发送给 LangChain 团队以启用 BYOC。
Create the IAM role
LangChain 提供 IAM 角色的外部 ID。导航到 Settings > Data Planes，使用 Data Planes 标题旁的复制按钮进行复制。
使用复制的外部 ID 在你的 AWS 账户中应用 langsmith-byoc-role Terraform 模块。这会创建 LangChain 用于预置和管理数据平面的跨账户角色。该角色的信任策略必须在其 ExternalId 条件中使用此值。
对于 BYOVPC，设置 allow_vpc_creation_permissions = false，并在 vpc_ids 中提供你的 VPC ID。请参阅创建降权限的 IAM 角色。
NOTE
LangChain 建议使用专用于 LangSmith BYOC 的全新 AWS 账户。
Create the data plane
导航到 Settings > Data Planes，使用以下参数创建数据平面：
- 名称：小写字母、数字和连字符，最多 24 个字符。
- AWS 区域：受支持区域之一。
- AWS IAM 角色 ARN：你在上一步创建的角色 ARN，LangSmith 将在你的账户中扮演该角色。
- 网络配置：对于 LangChain 管理的 VPC，提供从
/16到/18的私有 RFC 1918 CIDR 范围。对于 BYOVPC，提供 VPC 和子网 ID 而不是 CIDR 范围。 - 负载均衡器访问：默认私有，这使入口负载均衡器只能从你的 VPC 访问。将其设置为 Public 可使负载均衡器面向互联网。
Wait for provisioning
LangChain 代表你预置基础设施。数据平面会从 Requested 依次变为 Provisioning，再到 Active。
对于 BYOVPC，LangSmith 会在预置前验证你的 VPC 和子网，然后在你的 VPC 内创建工作负载基础设施。
NOTE
数据平面的端到端预置大约需要 60 到 90 分钟。
在 Settings > Data Planes 中跟踪其状态。如果数据平面转换为 Provisioning Failed，请联系 LangChain 团队。
Set up private connectivity
数据平面默认预置有私有终端节点，因此你需要私有连接才能访问它，例如 Tailscale、AWS PrivateLink 或 VPC 对等连接。
在 Settings > Data Planes 下找到 API URL。如果前端无法访问你的数据平面，LangSmith 会提示你切换到某个可访问数据平面上的工作区，该工作区可以是 Cloud 工作区。
Create workspaces
名为 dp-<data_plane_name> 的工作区会在新数据平面内自动预置。在数据平面可访问之前，它无法被访问。
你可以在数据平面中创建额外的工作区。创建每个工作区时选择目标数据平面：一个工作区恰好属于一个数据平面，而一个数据平面可以容纳许多工作区。
WARNING
创建工作区时请仔细选择正确的数据平面。工作区创建后无法移动到其他数据平面。