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

先决条件

在开始之前,请确保您拥有以下内容:

部署您的代理

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:
npm install @langchain/langgraph-sdk
  1. 向代理发送消息:
import { Client } from "@langchain/langgraph-sdk";

const client = new Client({ apiUrl: "your-deployment-url", apiKey: "your-langsmith-api-key" });

const streamResponse = client.runs.stream(
  null,    // 无线程运行
  "agent", // 代理名称。在 langgraph.json 中定义。
  {
    input: {
      "messages": [
        { "role": "user", "content": "What is LangGraph?"}
      ]
    },
    streamMode: "messages",
  }
);

for await (const chunk of streamResponse) {
  console.log(`Receiving new event of type: ${chunk.event}...`);
  console.log(JSON.stringify(chunk.data));
  console.log("\n\n");
}