本指南向您展示如何将您的 Agent 部署到 LangSmith Cloud,这是一个专为 Agent 工作负载设计的完全托管托管平台。通过 Cloud 部署,您可以直接从 GitHub 仓库部署——LangSmith 处理基础设施、扩展和运维问题。 传统托管平台是为无状态、短寿命的 Web 应用程序构建的。LangSmith Cloud 是专为需要持久状态和后台执行的有状态、长时间运行的 Agent 构建的。
LangSmith 除了 Cloud 之外还提供多种部署选项,包括使用控制平面(混合/自托管)或作为独立服务器部署。有关更多信息,请参阅部署概述

前置条件

在开始之前,确保您具备以下条件:

部署您的 Agent

1. 在 GitHub 上创建仓库

您的应用程序代码必须位于 GitHub 仓库中才能在 LangSmith 上部署。支持公共和私有仓库。对于这个快速入门,首先按照本地服务器设置指南确保您的应用程序与 LangGraph 兼容。然后,将您的代码推送到仓库。

2. 部署到 LangSmith

1

导航到 LangSmith 部署

登录 LangSmith。在左侧边栏中,选择 Deployments
2

创建新部署

点击 + New Deployment 按钮。将打开一个窗格,您可以填写必填字段。
3

链接仓库

如果您是首次用户或添加尚未连接过的私有仓库,请点击 Add new account 按钮,然后按照说明连接您的 GitHub 账户。
4

部署仓库

选择您的应用程序的仓库。点击 Submit 进行部署。这可能需要约 15 分钟完成。您可以在 Deployment details 视图中检查状态。

3. 在 Studio 中测试您的应用程序

一旦您的应用程序部署完成:
  1. 选择您刚刚创建的部署以查看更多详情。
  2. 点击右上角的 Studio 按钮。Studio 将打开并显示您的图。

4. 获取部署的 API URL

  1. 在 LangGraph 的 Deployment details 视图中,点击 API URL 将其复制到剪贴板。
  2. 点击 URL 将其复制到剪贴板。

5. 测试 API

现在您可以测试 API:
  1. 安装 LangGraph SDK:
pip install langgraph-sdk
  1. 向 Agent 发送消息:
from langgraph_sdk import get_sync_client # 或使用 get_client 获取异步客户端

client = get_sync_client(url="your-deployment-url", api_key="your-langsmith-api-key")

for chunk in client.runs.stream(
    None,    # 无线程运行
    "agent", # Agent 名称。在 langgraph.json 中定义。
    input={
        "messages": [{
            "role": "human",
            "content": "什么是 LangGraph?",
        }],
    },
    stream_mode="updates",
):
    print(f"接收新事件,类型:{chunk.event}...")
    print(chunk.data)
    print("\n\n")