主题
自带云(BYOC)
在你自己的云环境中部署 LangSmith 服务并存储数据,而由 LangChain 来运营、扩缩容和升级基础设施。
NOTE
BYOC 仅适用于 Enterprise 计划的客户。
自带云(BYOC)让你在自己的云环境中部署 LangSmith 服务并存储数据,而由 LangChain 来运营、扩缩容和升级基础设施。BYOC 适合那些要求对其数据拥有完全主权,但又不想承担预置和管理基础设施开销的组织。
BYOC 采用责任分离模型:控制平面运行在 LangChain 的云中,数据平面则完全运行在你的云环境中。有关 LangChain 管理什么与你管理什么的详细信息,请参阅 BYOC 责任共担模型。
开始使用
要部署 LangSmith BYOC,请联系我们的销售团队。在 LangChain 团队为你的组织启用 BYOC 后,请按照入门指南创建你的第一个数据平面。
区域和云服务商
BYOC 已在 AWS 上正式发布(GA)。计划于 2026 年下半年支持更多云服务商。
你可以在以下任何 AWS 区域部署 LangSmith BYOC:
| 地区 | AWS 区域 |
|---|---|
| 美国 | us-east-1, us-east-2, us-west-1, us-west-2 |
| 加拿大 | ca-central-1 |
| 欧盟 | eu-central-1, eu-west-1, eu-west-2, eu-west-3, eu-north-1 |
| 亚太 | ap-south-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-southeast-1, ap-southeast-2 |
无论你将数据平面放置在何处,控制平面都运行在 us-east-2。如果你在美国境外预置数据平面,你的敏感应用数据会留在该区域,而控制平面元数据则保留在美国:
| 控制平面(美国) | 数据平面(你的区域) |
|---|---|
| 用户、角色、计费、组织配置、SSO 配置、API keys | 追踪、实验、数据集、洞察运行、标注队列、工作区密钥,以及所有其他敏感应用数据 |
可用功能
支持以下功能:
- 可观测性:追踪、项目、仪表盘和告警。
- 评估:数据集、实验、评估器和标注队列。
- 洞察:自动分析追踪,以揭示用量模式、常见智能体行为和失败模式。
- LangSmith Chat:从你的工作区内部署分析追踪、线程、提示词和评估。
- 提示词工程:提示词和提示词提交。
- LangSmith Deployment:LangSmith Deployment 控制平面运行在你数据平面的集群内,因此智能体管理层和你的智能体都运行在你的 VPC 中。
- 沙箱:通过 CLI 和 SDK 的使用方式与 Cloud 完全相同,只是你需要指向你数据平面的终端节点。
- LLM 网关:使用一个 LangSmith API key 调用各服务商的模型,集中强制执行支出、速率限制和数据保护策略。
- LangSmith MCP:将兼容 MCP 的客户端连接到 LangSmith 以查询数据。
- Fleet:从模板、连接器和渠道构建并运行零代码智能体。
- SmithDB:专为追踪数据打造的可观测性后端,持久化到你账户中的 S3。
- 引擎:自动检测、诊断和解决生产追踪中发现的反复出现的问题。引擎使用 LangSmith Intelligence 服务进行模型相关工作。有关详细信息,请参阅自托管 Engine 架构。
以下功能已规划但尚未支持:
- Managed Deep Agents:由 LangChain 托管的深度智能体,带连接器、渠道和调度。
- LLM 身份认证代理:为模型调用强制执行你自己的身份认证流程,从而绝不会将服务商凭据暴露给最终用户。
前置条件
在 LangChain 能够预置数据平面之前,你需要具备以下条件:
- AWS 上的 LangSmith 组织:在 aws.smith.langchain.com 创建一个,然后将你的组织 ID 发送给 LangChain 团队以启用 BYOC。
- 一个 AWS 账户:LangChain 建议使用专用于 LangSmith BYOC 的全新账户,但这不是必需的。
- 一个受支持的区域:从上面列出的 AWS 区域中选择一个。
- 一个 IAM 角色和外部 ID:LangChain 提供外部 ID。使用 Settings > Data Planes 中 Data Planes 标题旁的按钮复制它,然后用此值应用
langsmith-byoc-roleTerraform 模块,以创建 LangChain 为预置和管理你的数据平面而承担的角色。你必须使用此模块。