LangSmith UI

从 LangSmith UI开始，选择 **部署** 在左侧导航面板中， **部署**。在右上角，选择 **+ 新建部署** 来创建新部署：

1. 在 **创建新部署** 面板中，填写必填字段。对于 **部署详情**: 1. 选择 **从 GitHub 导入** 并遵循 GitHub OAuth 工作流程来安装和授权 LangChain 的 hosted-langserve GitHub 应用以访问所选仓库。安装完成后，返回 **创建新部署** 面板并从下拉菜单中选择要部署的 GitHub 仓库。 <aside class="callout"><strong>提示</strong> 安装 LangChain 的 GitHub 用户 hosted-langserve GitHub 应用必须是 所有者 组织或账户的。此授权每个 LangSmith 工作区只需完成一次——后续部署可由任何具有部署权限的用户创建。 </aside>

1. 为部署指定名称。 1. 指定所需的 **Git 分支**。部署与分支关联。当创建新版本时，关联分支的代码将被部署。分支可在后续的 部署设置. 1. 指定 LangGraph API 配置文件 的完整路径，包括文件名。例如，如果文件 langgraph.json 位于仓库根目录，请指定 langgraph.json. 1. 使用复选框 **在推送到分支时自动更新部署**。如果选中，当更改推送到指定的 **Git 分支**时，部署将自动更新。您可以在 部署设置 in 中启用或禁用此设置. 对于 **部署类型**: - 开发部署适用于非生产用例，并使用最少资源进行配置。 - Production deployments can serve up to 500 requests/second and are provisioned with highly available storage with automatic backups. 1. 确定部署是否应该 **通过 Studio 共享**. 1. 如果未选中，部署仅可通过 工作区. 1. 如果选中，部署可通过 Studio 供任何 LangSmith 用户访问。将提供指向 Studio 部署的直接 URL 以与其他 LangSmith 用户共享。 1. 指定 **环境变量** 和密钥。如需为部署配置其他变量，请参阅 环境变量参考. 1. 敏感值（如 API 密钥（例如， OPENAI_API_KEY）应指定为密钥。 1. 也可以指定其他非敏感环境变量。 1. 新的 LangSmith 追踪项目 将自动创建，与部署同名。 1. 在右上角，选择 **提交**。几秒钟后， **部署** 视图出现，新部署将排队等待配置。

LangGraph CLI

1. 安装 LangGraph CLI:

        uv tool install langgraph-cli
        

1. 将您的 LangSmith API 密钥添加到项目根目录的 .env 文件中：

        LANGSMITH_API_KEY=lsv2_...
        

1. 从项目目录运行部署命令：

        langgraph deploy
        

这将创建一个 dev 部署，其名称与项目目录同名。使用 --name 可指定不同的名称，或使用 --deployment-type prod 进行生产部署：

        langgraph deploy --name my-agent --deployment-type prod
        

命令完成后，部署将进入配置队列。可以通过 LangSmith UI 在部署创建后管理环境变量，或在您的 env 文件的 langgraph.json.

LangSmith UI

从 LangSmith UI开始，选择 **部署** 在左侧导航面板中。选择现有部署以创建新修订版本。

1. 在 **部署** 视图的右上角，选择 **+ 新修订版本**. 1. 在 **新修订版本** 模态框中填写必填字段。 1. 指定 API 配置文件 的完整路径（包括文件名）。例如，如果文件 langgraph.json 位于仓库根目录，请指定 langgraph.json. 1. 确定部署是否应该 **通过 Studio 分享**. - 如果未选中，部署将只能通过工作区的有效 LangSmith API 密钥访问 如果选中，部署将可通过. - Studio 供任何 LangSmith 用户访问。将提供部署的 Studio 直接 URL 以与其他 LangSmith 用户分享。 指定 1. 环境变量 **和环境变量** 。现有密钥和环境变量会预填充。如需为修订版本配置其他变量，请参阅 环境变量参考. 1. 添加新的密钥或环境变量。 1. 删除现有的密钥或环境变量。 1. 更新现有密钥或环境变量的值。 1. 选择 **提交**。几秒钟后， **新修订版本** 模态框将关闭，新修订版本将进入部署队列。

LangGraph CLI

Re-run langgraph deploy 在您的项目目录中运行此命令。该命令通过名称查找现有部署，并使用您的最新代码更改创建新版本：

    langgraph deploy
    

要通过 ID 而不是名称来定位特定部署，请使用 --deployment-id:

    langgraph deploy --deployment-id
    

使用 langgraph deploy list 查看所有部署并查找其 ID：

    langgraph deploy list
    

LangSmith UI

从以下位置开始： **部署** view:

1. 从以下位置选择所需版本： **版本** 表格。一个面板从右侧滑开， **构建** 标签页默认选中，显示该版本的构建日志。 1. 在该面板中，选择 **服务器** 标签页以查看该版本的服务器日志。服务器日志仅在版本部署后才可用。 1. 在 **服务器** tab, adjust the date/time range picker as needed. By default, the date/time range picker is set to the **最近7天**.

LangGraph CLI

使用 langgraph deploy logs 来获取部署的日志。

查看服务器（运行时）日志：

    langgraph deploy logs
    

查看构建日志：

    langgraph deploy logs --type build
    

持续跟踪实时日志：

    langgraph deploy logs --follow
    

按时间范围、日志级别或搜索字符串过滤日志：

    langgraph deploy logs --start-time 2026-03-01T00:00:00Z --level ERROR
    

如果有多个部署，请按名称或 ID 指定目标：

    langgraph deploy logs --name my-agent
    langgraph deploy logs --deployment-id
    

有关所有可用选项，请参阅 deploy logs CLI 参考.

LangSmith UI

从 LangSmith UI:

1. 在左侧导航面板中，选择 **部署**，其中包含现有部署的列表。 1. 选择所需部署所在行右侧的菜单图标（三个点），然后选择 **删除**. 1. A **确认** 弹窗将出现。选择 **删除**.

LangGraph CLI

使用 langgraph deploy list 查找要删除的部署的 ID：

    langgraph deploy list
    

然后按 ID 删除：

    langgraph deploy delete
    

要跳过确认提示，请使用 --force:

    langgraph deploy delete --force