Skip to content

如何部署到 LangGraph Cloud

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

先决条件

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

创建新部署

从 LangSmith UI 开始...

  1. 在左侧导航面板中，选择 LangGraph Cloud。LangGraph Cloud 视图中显示现有的 LangGraph Cloud 部署列表。
  2. 在右上角，选择 + 新部署 创建新部署。
  3. 在 创建新部署 面板中，填写必填字段。
    1. 部署详情
      1. 选择 从 GitHub 导入 并按照 GitHub OAuth 工作流程安装并授权 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. 如果被勾选，该部署将通过 LangGraph Studio 供任何 LangSmith 用户访问。将提供直接 URL 以便与其他 LangSmith 用户共享。
    4. 指定 环境变量 和密钥。请参见 环境变量参考 配置部署的其他变量。
      1. 像 API 密钥（例如 OPENAI_API_KEY）这类敏感值应被指定为机密。
      2. 还可以指定额外的非机密环境变量。
    5. 名为的新的 LangSmith 跟踪项目 将自动创建，名称与部署相同。
  4. 在右上角选择 提交。几秒钟后，部署 视图将出现，新部署将排队等待配置。

创建新修订版本

当 创建新部署 时，会默认创建一个新修订版本。可以创建后续修订版本以部署新的代码更改。

从 LangSmith UI 开始...

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

查看构建和部署日志

每个修订版本都有构建和部署日志可用。

从 LangGraph Cloud 视图开始...

  1. 从 修订版本 表中选择所需的修订版本。一个面板从右侧滑动打开，默认选择 构建 标签，并显示该修订版本的构建日志。
  2. 在面板中，选择 部署 标签以查看该修订版本的部署日志。
  3. 在 部署 标签内，根据需要调整日期/时间范围选择器。默认情况下，日期/时间范围选择器设置为 最近 15 分钟。

中断修订版本

中断修订版本将停止该修订版本的部署。

未定义行为

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

从 LangGraph Cloud 视图开始...

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

删除部署

从 LangSmith UI 开始...

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

部署设置

从 LangGraph Cloud 视图开始...

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