**寻找快速设置?**首先尝试快速入门指南。
先决条件
- LangSmith 应用程序从 GitHub 仓库部署。配置 LangSmith 应用程序并将其上传到 GitHub 仓库以便将其部署到 LangSmith。
- 验证 LangGraph API 在本地运行。如果 API 未成功运行(即
langgraph dev),部署到 LangSmith 也将失败。
创建新部署
从 LangSmith UI 开始:- 在左侧导航面板中,选择 Deployments,其中包含现有部署的列表。
- 在右上角,选择 + New Deployment 以创建新部署。
- 在
Create New Deployment面板中,填写必填字段。 Deployment details- 选择
Import from GitHub并按照 GitHub OAuth 工作流程安装和授权 LangChain 的hosted-langserveGitHub 应用以访问所选仓库。安装完成后,返回Create New Deployment面板并从下拉菜单中选择要部署的 GitHub 仓库。注意:安装 LangChain 的hosted-langserveGitHub 应用的 GitHub 用户必须是组织或账户的所有者。 - 指定部署的名称。
- 指定所需的
Git Branch。部署链接到分支。创建新修订版时,将部署链接分支的代码。可以稍后在部署设置中更新分支。 - 指定 LangGraph API 配置文件的完整路径,包括文件名。例如,如果文件
langgraph.json在仓库的根目录中,只需指定langgraph.json。 - 选中/取消选中
Automatically update deployment on push to branch复选框。如果选中,当更改推送到指定的Git Branch时,部署将自动更新。可以稍后在部署设置中启用/禁用此设置。 - 选择所需的
Deployment Type。 Development部署适用于非生产用例,并配置最少的资源。Production部署可以每秒处理多达 500 个请求,并配置高可用存储和自动备份。- 确定部署是否应为
Shareable through Studio。 - 如果未选中,部署将只能使用工作区的有效 LangSmith API 密钥访问。
- 如果选中,任何 LangSmith 用户都可以通过 Studio 访问部署。将提供部署的 Studio 直接 URL 以与其他 LangSmith 用户共享。
- 指定
Environment Variables和密钥。请参阅环境变量参考以为部署配置其他变量。 - 应将敏感值(例如 API 密钥,如
OPENAI_API_KEY)指定为密钥。 - 还可以指定其他非密钥环境变量。
- 将自动创建与部署同名的新 LangSmith
Tracing Project。 - 在右上角,选择
Submit。几秒钟后,将显示Deployment视图,新部署将排队等待配置。
创建新修订版
当创建新部署时,默认创建新修订版。可以创建后续修订版以部署新的代码更改。 从 LangSmith UI 开始…- 在左侧导航面板中,选择 Deployments,其中包含现有部署的列表。
- 选择要为其创建新修订版的现有部署。
- 在
Deployment视图中,在右上角,选择+ New Revision。 - 在
New Revision模态框中,填写必填字段。 - 指定 LangGraph API 配置文件的完整路径,包括文件名。例如,如果文件
langgraph.json在仓库的根目录中,只需指定langgraph.json。 - 确定部署是否应为
Shareable through Studio。 - 如果未选中,部署将只能使用工作区的有效 LangSmith API 密钥访问。
- 如果选中,任何 LangSmith 用户都可以通过 Studio 访问部署。将提供部署的 Studio 直接 URL 以与其他 LangSmith 用户共享。
- 指定
Environment Variables和密钥。现有密钥和环境变量已预填充。请参阅环境变量参考以为修订版配置其他变量。 - 添加新密钥或环境变量。
- 删除现有密钥或环境变量。
- 更新现有密钥或环境变量的值。
- 选择
Submit。几秒钟后,New Revision模态框将关闭,新修订版将排队等待部署。
查看构建和服务器日志
每个修订版都可以使用构建和服务器日志。 从 Deployments 视图开始:- 从
Revisions表中选择所需的修订版。面板从右侧滑出,默认选择Build选项卡,显示修订版的构建日志。 - 在面板中,选择
Server选项卡以查看修订版的服务器日志。服务器日志仅在部署修订版后可用。 - 在
Server选项卡中,根据需要调整日期/时间范围选择器。默认情况下,日期/时间范围选择器设置为Last 7 days。
查看部署指标
从 LangSmith UI 开始…- 在左侧导航面板中,选择 Deployments,其中包含现有部署的列表。
- 选择要监控的现有部署。
- 选择
Monitoring选项卡以查看部署指标。查看所有可用指标的列表。 - 在
Monitoring选项卡中,根据需要使用日期/时间范围选择器。默认情况下,日期/时间范围选择器设置为Last 15 minutes。
中断修订版
中断修订版将停止修订版的部署。 从 Deployments 视图开始:- 从
Revisions表中为所需修订版的行的右侧选择菜单图标(三个点)。 - 从菜单中选择
Interrupt。 - 将出现一个模态框。查看确认消息。选择
Interrupt revision。
删除部署
从 LangSmith UI 开始…- 在左侧导航面板中,选择 Deployments,其中包含现有部署的列表。
- 为所需部署的行的右侧选择菜单图标(三个点)并选择
Delete。 - 将出现
Confirmation模态框。选择Delete。
部署设置
从 Deployments 视图开始:- 在右上角,选择齿轮图标(
Deployment Settings)。 - 将
Git Branch更新为所需的分支。 - 选中/取消选中
Automatically update deployment on push to branch复选框。- 分支创建/删除和标签创建/删除事件不会触发更新。只有推送到现有分支才会触发更新。
- 快速连续推送到分支将排队后续更新。一旦构建完成,最新的提交将开始构建,其他排队的构建将被跳过。
添加或删除 GitHub 仓库
在安装和授权 LangChain 的hosted-langserve GitHub 应用后,可以修改应用的仓库访问权限以添加新仓库或删除现有仓库。如果创建了新仓库,可能需要显式添加它。
- 从 GitHub 个人资料中,导航到
Settings>Applications>hosted-langserve> 单击Configure。 - 在
Repository access下,选择All repositories或Only select repositories。如果选择了Only select repositories,则必须显式添加新仓库。 - 单击
Save。 - 创建新部署时,下拉菜单中的 GitHub 仓库列表将更新以反映仓库访问权限更改。
IP 地址白名单
2025 年 1 月 6 日之后创建的 LangSmith 部署的所有流量都将通过 NAT 网关。 此 NAT 网关将根据您部署的区域具有多个静态 IP 地址。请参阅下表以获取要添加到白名单的 IP 地址列表:| 美国 | 欧盟 |
|---|---|
| 35.197.29.146 | 34.90.213.236 |
| 34.145.102.123 | 34.13.244.114 |
| 34.169.45.153 | 34.32.180.189 |
| 34.82.222.17 | 34.34.69.108 |
| 35.227.171.135 | 34.32.145.240 |
| 34.169.88.30 | 34.90.157.44 |
| 34.19.93.202 | 34.141.242.180 |
| 34.19.34.50 | 34.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 |