Skip to main content
这是将应用程序部署到 LangSmith 云端的综合设置和管理指南。它涵盖两种部署方法：LangSmith UI（从连接的 GitHub 仓库部署）和 langgraph deploy CLI 命令（直接从本地机器构建和推送）。
如果您想快速上手，请先尝试快速入门指南。
在开始设置之前，请查看云端概览页面以了解云端托管模型。

​
先决条件

​
创建新部署

选择适合您工作流程的部署方法——LangSmith UI 连接到 GitHub 仓库并支持推送时自动部署，而 langgraph deploy CLI 命令则直接从本地项目目录构建和部署。
需要一次性设置：GitHub 组织所有者或管理员必须在 LangSmith UI 中完成 OAuth 流程，以授权 hosted-langserve GitHub 应用。每个工作空间只需执行一次。在初始 OAuth 授权之后，所有具有部署权限的开发人员都可以创建和管理部署，而无需 GitHub 管理员访问权限。
从 LangSmith UI 开始，在左侧导航面板中选择 Deployments。在右上角，选择 + New Deployment 以创建新部署：
  1. 在 Create New Deployment 面板中，填写必填字段。对于 Deployment details：
    1. 选择 Import from GitHub 并按照 GitHub OAuth 工作流程安装并授权 LangChain 的 hosted-langserve GitHub 应用以访问选定的仓库。安装完成后，返回 Create New Deployment 面板，并从下拉菜单中选择要部署的 GitHub 仓库。
      安装 LangChain hosted-langserve GitHub 应用的 GitHub 用户必须是组织或账户的所有者。此授权每个 LangSmith 工作空间只需完成一次——后续部署可以由任何具有部署权限的用户创建。
    2. 为部署指定一个名称。
    3. 指定所需的 Git Branch。部署与一个分支相关联。创建新修订版本时，将部署关联分支的代码。稍后可以在部署设置中更新分支。
    4. 指定 LangGraph API 配置文件的完整路径，包括文件名。例如，如果文件 langgraph.json 位于仓库根目录，则指定 langgraph.json。
    5. 使用复选框选择 Automatically update deployment on push to branch。如果选中，当更改推送到指定的 Git Branch 时，部署将自动更新。您可以在部署设置中通过UI启用或禁用此设置。 对于 Deployment Type：
      • 开发部署适用于非生产用例，并配置了最少的资源。
      • 生产部署每秒最多可处理 500 个请求，并配置了具有自动备份功能的高可用存储。
    6. 确定部署是否应 Shareable through Studio。
      1. 如果未选中，部署将仅对工作空间的有效 LangSmith API 密钥可访问。
      2. 如果选中，部署将通过 Studio 对任何 LangSmith 用户可访问。将提供一个指向该部署 Studio 的直接 URL，以便与其他 LangSmith 用户共享。
    7. 指定 Environment Variables 和密钥。要为部署配置其他变量，请参阅环境变量参考。
      1. 敏感值（如 API 密钥，例如 OPENAI_API_KEY）应指定为密钥。
      2. 也可以指定其他非密钥环境变量。
    8. 将自动创建一个新的 LangSmith 追踪项目，其名称与部署相同。
  2. 在右上角，选择 Submit。几秒钟后，将出现 Deployment 视图，新部署将排队等待配置。

​
创建新修订版本

创建新部署时，默认会创建一个新修订版本。您可以创建后续修订版本来部署新的代码更改。
从 LangSmith UI 开始，在左侧导航面板中选择 Deployments。选择一个现有部署以为其创建新修订版本。
  1. 在 Deployment 视图中，在右上角选择 + New Revision。
  2. 在 New Revision 模态框中，填写必填字段。
    1. 指定 API 配置文件的完整路径，包括文件名。例如，如果文件 langgraph.json 位于仓库根目录，则指定 langgraph.json。
    2. 确定部署是否应 Shareable through Studio。
      • 如果未选中，部署将仅对工作空间的有效 LangSmith API 密钥可访问。
      • 如果选中，部署将通过 Studio 对任何 LangSmith 用户可访问。将提供一个指向该部署 Studio 的直接 URL，以便与其他 LangSmith 用户共享。
    3. 指定 Environment Variables 和密钥。现有的密钥和环境变量会预先填充。要为修订版本配置其他变量，请参阅环境变量参考。
      1. 添加新的密钥或环境变量。
      2. 移除现有的密钥或环境变量。
      3. 更新现有密钥或环境变量的值。
  3. 选择 Submit。几秒钟后，New Revision 模态框将关闭，新修订版本将排队等待部署。

​
查看构建和服务器日志

每个修订版本都可以查看构建和服务器日志。
从 Deployments 视图开始：
  1. 从 Revisions 表中选择所需的修订版本。右侧会滑出一个面板，默认选中 Build 选项卡，其中显示该修订版本的构建日志。
  2. 在面板中，选择 Server 选项卡以查看该修订版本的服务器日志。服务器日志仅在修订版本部署后才可用。
  3. 在 Server 选项卡内，根据需要调整日期/时间范围选择器。默认情况下，日期/时间范围选择器设置为 Last 7 days。

​
查看部署指标

部署上线后，您可以从 LangSmith UI 监控其性能。 从 LangSmith UI 开始：
  1. 在左侧导航面板中，选择 Deployments。
  2. 选择一个现有部署进行监控。
  3. 选择 Monitoring 选项卡以查看部署指标。请参阅所有可用指标列表。
  4. 在 Monitoring 选项卡内，根据需要调整日期/时间范围选择器。默认情况下，日期/时间范围选择器设置为 Last 15 minutes。

​
中断修订版本

中断修订版本将停止该修订版本的部署。
未定义行为 中断的修订版本具有未定义的行为。这仅在您需要部署新修订版本，而现有修订版本“卡住”进行中时有用。未来此功能可能会被移除。
从 Deployments 视图开始：
  1. 从 Revisions 表中，在所需修订版本行的右侧选择菜单图标（三个点）。
  2. 从菜单中选择 Interrupt。
  3. 将出现一个模态框。查看确认信息。选择 Interrupt revision。

​
删除部署

从 LangSmith UI 开始：
  1. 在左侧导航面板中，选择 Deployments，其中包含现有部署的列表。
  2. 在所需部署行的右侧选择菜单图标（三个点），然后选择 Delete。
  3. 将出现 Confirmation 模态框。选择 Delete。

​
部署设置

从 Deployments 视图开始：
  1. 在右上角，选择齿轮图标 (Deployment Settings)。
  2. 将 Git Branch 更新为所需分支。
  3. 勾选/取消勾选 Automatically update deployment on push to branch 复选框。
    1. 分支创建/删除和标签创建/删除事件不会触发更新。只有推送到现有分支才会触发更新。
    2. 快速连续推送到一个分支将排队后续更新。一旦构建完成，最新的提交将开始构建，其他排队的构建将被跳过。

​
添加或移除 GitHub 仓库

安装并授权 LangChain 的 hosted-langserve GitHub 应用后，可以修改该应用的仓库访问权限，以添加新仓库或移除现有仓库。如果创建了新仓库，可能需要显式添加。
  1. 从 GitHub 个人资料，导航到 Settings > Applications > hosted-langserve > 点击 Configure。
  2. 在 Repository access 下，选择 All repositories 或 Only select repositories。如果选择 Only select repositories，则必须显式添加新仓库。
  3. 点击 Save。
  4. 创建新部署时，下拉菜单中的 GitHub 仓库列表将更新以反映仓库访问权限的更改。

​
允许列表 IP 地址

2025年1月6日之后创建的所有 LangSmith 部署的流量都将通过 NAT 网关。 此 NAT 网关将根据您部署的区域拥有多个静态 IP 地址。请参考下表以获取需要加入允许列表的 IP 地址：
美国欧盟
35.197.29.14634.90.213.236
34.145.102.12334.13.244.114
34.169.45.15334.32.180.189
34.82.222.1734.34.69.108
35.227.171.13534.32.145.240
34.169.88.3034.90.157.44
34.19.93.20234.141.242.180
34.19.34.5034.32.141.108
34.59.244.194
34.9.99.224
34.68.27.146
34.41.178.137
34.123.151.210
34.135.61.140
34.121.166.52
34.31.121.70
Edit this page on GitHub or file an issue.
Connect these docs to Claude, VSCode, and more via MCP for real-time answers.