如何部署到 LangGraph Cloud

LangGraph Cloud 在 LangSmith 中可用。要部署 LangGraph Cloud API，请导航到 LangSmith UI。

先决条件

1. LangGraph Cloud 应用程序从 GitHub 仓库部署。配置 LangGraph Cloud 应用程序并上传到 GitHub 仓库，以便将其部署到 LangGraph Cloud。
2. 验证 LangGraph API 是否在本地运行。如果 API 未成功运行（即 langgraph dev），则部署到 LangGraph Cloud 也会失败。

创建新部署

从 LangSmith UI 开始...

1. 在左侧导航面板中，选择 LangGraph 平台。LangGraph 平台视图包含现有 LangGraph Cloud 部署的列表。
2. 在右上角，选择 + 新建部署 以创建新部署。
3. 在 创建新部署 面板中，填写必填字段。
   1. 部署详情
      1. 选择 从 GitHub 导入，然后按照 GitHub OAuth 工作流程安装并授权 LangChain 的 hosted-langserve GitHub 应用程序访问所选仓库。安装完成后，返回 创建新部署 面板，然后从下拉菜单中选择要部署的 GitHub 仓库。注意：安装 LangChain 的 hosted-langserve GitHub 应用程序的 GitHub 用户必须是组织或帐户的所有者。
      2. 为部署指定名称。
      3. 指定所需的 Git 分支。部署链接到一个分支。创建新修订时，将部署链接分支的代码。分支可以在 部署设置 中稍后更新。
      4. 指定 LangGraph API 配置文件的完整路径，包括文件名。例如，如果文件 langgraph.json 位于仓库的根目录中，则只需指定 langgraph.json。
      5. 选中/取消选中复选框以 在推送到分支时自动更新部署。如果选中，则在将更改推送到指定的 Git 分支 时，部署将自动更新。此设置可以在 部署设置 中稍后启用/禁用。
   2. 选择所需的 部署类型。
      1. 开发 部署用于非生产用例，并使用最少的资源进行配置。
      2. 生产 部署每秒最多可以处理 500 个请求，并使用具有自动备份的高可用性存储进行配置。
   3. 确定部署是否应 通过 LangGraph Studio 共享。
      1. 如果未选中，则只有拥有工作区的有效 LangSmith API 密钥才能访问部署。
      2. 如果选中，则任何 LangSmith 用户都可以通过 LangGraph Studio 访问部署。将提供 LangGraph Studio 的直接 URL，以便与其他 LangSmith 用户共享。
   4. 指定 环境变量 和密钥。请参阅 环境变量参考 以配置部署的其他变量。
      1. 敏感值（例如 API 密钥 (例如 OPENAI_API_KEY)）应指定为密钥。
      2. 还可以指定其他非密钥环境变量。
   5. 将自动创建一个新的 LangSmith 追踪项目，其名称与部署名称相同。
4. 在右上角，选择 提交。几秒钟后，将出现 部署 视图，并且新部署将排队等待配置。

创建新修订

在创建新部署时，默认情况下会创建一个新修订。可以创建后续修订以部署新的代码更改。

从 LangSmith UI 开始...

1. 在左侧导航面板中，选择 LangGraph 平台。LangGraph 平台视图包含现有 LangGraph Cloud 部署的列表。
2. 选择现有部署以创建新修订。
3. 在 部署 视图中，在右上角，选择 + 新建修订。
4. 在 新建修订 模态框中，填写必填字段。
   1. 指定 LangGraph API 配置文件的完整路径，包括文件名。例如，如果文件 langgraph.json 位于仓库的根目录中，则只需指定 langgraph.json。
   2. 确定部署是否应 通过 LangGraph Studio 共享。
      1. 如果未选中，则只有拥有工作区的有效 LangSmith API 密钥才能访问部署。
      2. 如果选中，则任何 LangSmith 用户都可以通过 LangGraph Studio 访问部署。将提供 LangGraph Studio 的直接 URL，以便与其他 LangSmith 用户共享。
   3. 指定 环境变量 和密钥。现有密钥和环境变量已预先填充。请参阅 环境变量参考 以配置修订的其他变量。
      1. 添加新密钥或环境变量。
      2. 删除现有密钥或环境变量。
      3. 更新现有密钥或环境变量的值。
5. 选择 提交。几秒钟后，新建修订 模态框将关闭，新修订将排队等待部署。

查看构建和服务器日志

构建和服务器日志可用于每个修订。

从 LangGraph 平台 视图开始...

1. 从 修订 表中选择所需的修订。面板从右侧滑出，默认情况下选择 构建 选项卡，其中显示修订的构建日志。
2. 在面板中，选择 服务器 选项卡以查看修订的服务器日志。服务器日志仅在修订部署后可用。
3. 在 服务器 选项卡中，根据需要调整日期/时间范围选择器。默认情况下，日期/时间范围选择器设置为 过去 7 天。

中断修订

中断修订将停止修订的部署。

未定义的行为

中断的修订具有未定义的行为。这仅在您需要部署新修订并且您已经有一个修订“卡住”在进行中时才有用。将来，此功能可能会被删除。

从 LangGraph 平台 视图开始...

1. 从 修订 表中，选择所需修订的行右侧的菜单图标（三个点）。
2. 从菜单中选择 中断。
3. 将出现一个模态框。查看确认消息。选择 中断修订。

删除部署

从 LangSmith UI 开始...

1. 在左侧导航面板中，选择 LangGraph 平台。LangGraph 平台视图包含现有 LangGraph Cloud 部署的列表。
2. 选择所需部署的行右侧的菜单图标（三个点），然后选择 删除。
3. 将出现 确认 模态框。选择 删除。

部署设置

从 LangGraph 平台 视图开始...

1. 在右上角，选择齿轮图标（部署设置）。
2. 将 Git 分支 更新为所需分支。
3. 选中/取消选中复选框以 在推送到分支时自动更新部署。
   1. 分支创建/删除和标签创建/删除事件不会触发更新。只有推送到现有分支才会触发更新。
   2. 快速连续推送到分支不会触发后续更新。将来，此功能可能会更改/改进。

添加或删除 GitHub 仓库

安装并授权 LangChain 的 hosted-langserve GitHub 应用程序后，可以修改该应用程序的仓库访问权限，以添加新仓库或删除现有仓库。如果创建了新仓库，则可能需要显式添加它。

1. 从 GitHub 个人资料中，导航到 设置 > 应用程序 > hosted-langserve > 单击 配置。
2. 在 仓库访问权限 下，选择 所有仓库 或 仅选择仓库。如果选择 仅选择仓库，则必须显式添加新仓库。
3. 单击 保存。
4. 创建新部署时，下拉菜单中的 GitHub 仓库列表将更新以反映仓库访问权限更改。

IP 地址白名单

从 2025 年 1 月 6 日之后创建的 LangGraph 平台 部署的所有流量都将通过 NAT 网关。此 NAT 网关将具有多个静态 IP 地址，具体取决于您部署的区域。请参阅下表，查看要加入白名单的 IP 地址列表

美国	欧盟
35.197.29.146	34.13.192.67
34.145.102.123	34.147.105.64
34.169.45.153	34.90.22.166
34.82.222.17	34.147.36.213
35.227.171.135	34.32.137.113
34.169.88.30	34.91.238.184
34.19.93.202	35.204.101.241
34.19.34.50	35.204.48.32

评论