LangSmith 云版

​

先决条件

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

​

创建新部署

1. 在左侧导航面板中，选择 Deployments，其中包含现有部署列表。
2. 在右上角，选择 + New Deployment 以创建新部署。
3. 在 `Create New Deployment` 面板中，填写必填字段。
4. 部署详情
5. 选择 `Import from GitHub` 并按照 GitHub OAuth 工作流程安装并授权 LangChain 的 `hosted-langserve` GitHub 应用程序访问选定的仓库。安装完成后，返回 `Create New Deployment` 面板，并从下拉菜单中选择要部署的 GitHub 仓库。注意：安装 LangChain `hosted-langserve` GitHub 应用程序的 GitHub 用户必须是组织或账户的所有者。
6. 为部署指定名称。
7. 指定所需的 `Git Branch`。部署链接到分支。创建新版本时，将部署链接分支的代码。该分支稍后可以在部署设置中更新。
8. 指定LangGraph API 配置文件的完整路径，包括文件名。例如，如果文件 `langgraph.json` 位于仓库的根目录，只需指定 `langgraph.json`。
9. 勾选/取消勾选 `Automatically update deployment on push to branch` 复选框。如果勾选，当更改推送到指定的 `Git Branch` 时，部署将自动更新。此设置稍后可以在部署设置中启用/禁用。
10. 选择所需的 `Deployment Type`。
11. `Development` 部署适用于非生产用例，并配置了最少的资源。
12. `Production` 部署每秒可处理多达 500 个请求，并配置了具有自动备份的高可用存储。
13. 确定部署是否应 `Shareable through Studio`。
14. 如果未勾选，则部署只能通过工作区的有效 LangSmith API 密钥访问。
15. 如果勾选，则任何 LangSmith 用户都可以通过 Studio 访问部署。将提供指向部署的 Studio 直链，以便与其他 LangSmith 用户共享。
16. 指定 `Environment Variables` 和 secrets。请参阅环境变量参考以配置部署的其他变量。
17. 敏感值，例如 API 密钥（例如 `OPENAI_API_KEY`），应指定为 secrets。
18. 也可以指定其他非秘密环境变量。
19. 将自动创建一个与部署同名的新 LangSmith `Tracing Project`。
20. 在右上角，选择 `Submit`。几秒钟后，将出现 `Deployment` 视图，新部署将排队等待配置。

​

创建新版本

1. 在左侧导航面板中，选择 Deployments，其中包含现有部署列表。
2. 选择要为其创建新版本的现有部署。
3. 在 `Deployment` 视图中，在右上角，选择 `+ New Revision`。
4. 在 `New Revision` 模态框中，填写必填字段。
5. 指定LangGraph API 配置文件的完整路径，包括文件名。例如，如果文件 `langgraph.json` 位于仓库的根目录，只需指定 `langgraph.json`。
6. 确定部署是否应 `Shareable through Studio`。
7. 如果未勾选，则部署只能通过工作区的有效 LangSmith API 密钥访问。
8. 如果勾选，则任何 LangSmith 用户都可以通过 Studio 访问部署。将提供指向部署的 Studio 直链，以便与其他 LangSmith 用户共享。
9. 指定 `Environment Variables` 和 secrets。现有 secrets 和环境变量将预填充。请参阅环境变量参考以配置版本的其他变量。
10. 添加新的 secrets 或环境变量。
11. 删除现有 secrets 或环境变量。
12. 更新现有 secrets 或环境变量的值。
13. 选择 `Submit`。几秒钟后，`New Revision` 模态框将关闭，新版本将排队等待部署。

​

查看构建和服务器日志

1. 从 `Revisions` 表中选择所需的版本。面板从右侧滑开，默认选中 `Build` 选项卡，其中显示了该版本的构建日志。
2. 在面板中，选择 `Server` 选项卡以查看该版本的服务器日志。服务器日志仅在版本部署后可用。
3. 在 `Server` 选项卡中，根据需要调整日期/时间范围选择器。默认情况下，日期/时间范围选择器设置为 `Last 7 days`。

​

查看部署指标

1. 在左侧导航面板中，选择 Deployments，其中包含现有部署列表。
2. 选择要监控的现有部署。
3. 选择 `Monitoring` 选项卡以查看部署指标。查看所有可用指标的列表。
4. 在 `Monitoring` 选项卡中，根据需要使用日期/时间范围选择器。默认情况下，日期/时间范围选择器设置为 `Last 15 minutes`。

​

中断版本

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

​

删除部署

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

​

部署设置

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

​

添加或删除 GitHub 仓库

1. 从 GitHub 个人资料中，导航到 `Settings` > `Applications` > `hosted-langserve` > 点击 `Configure`。
2. 在 `Repository access` 下，选择 `All repositories` 或 `Only select repositories`。如果选择了 `Only select repositories`，则必须显式添加新仓库。
3. 点击 `Save`。
4. 创建新部署时，下拉菜单中的 GitHub 仓库列表将更新以反映仓库访问权限的更改。

​

IP 地址白名单