跳到主要内容
要在 LangSmith 上部署应用程序，该应用程序必须包含一个或多个图、一个配置文件 (langgraph.json)、一个指定依赖项的文件，以及一个可选的 .env 文件，该文件指定环境变量。 本页解释了 LangSmith 应用程序的组织方式，以及如何提供部署所需的配置详细信息。

​
核心概念

要使用 LangSmith 进行部署，请提供以下信息
  1. 一个配置文件 (langgraph.json)，它指定了应用程序要使用的依赖项、图和环境变量。
  2. 实现应用程序逻辑的 图。
  3. 一个指定运行应用程序所需的 依赖项 的文件。
  4. 应用程序运行所需的 环境变量。
与框架无关LangSmith 部署支持部署 LangGraph 图。但是，图的节点的实现可以包含任意 Python 代码。这意味着任何框架都可以在节点中实现并部署在 LangSmith 部署上。这让您可以在 LangGraph 之外保留核心应用程序逻辑，同时仍使用 LangSmith 进行部署、扩展和可观测性。

​
文件结构

以下是 Python 和 JavaScript 应用程序的目录结构示例
  • Python (requirements.txt)
  • Python (pyproject.toml)
  • JS (package.json)
my-app/
├── my_agent # all project code lies within here
│   ├── utils # utilities for your graph
│   │   ├── __init__.py
│   │   ├── tools.py # tools for your graph
│   │   ├── nodes.py # node functions for your graph
│   │   └── state.py # state definition of your graph
│   ├── __init__.py
│   └── agent.py # code for constructing your graph
├── .env # environment variables
├── requirements.txt # package dependencies
└── langgraph.json # configuration file for LangGraph
应用程序的目录结构可能因编程语言和使用的包管理器而异。

​
配置文件

langgraph.json 文件是一个 JSON 文件，它指定了部署应用程序所需的依赖项、图、环境变量和其他设置。 有关 JSON 文件中所有支持的键的详细信息，请参阅 LangGraph 配置文件参考。
LangGraph CLI 默认使用当前目录中的 langgraph.json 配置文件。

​
示例

  • Python
  • JavaScript
  • 依赖项包括一个自定义本地包和 langchain_openai 包。
  • 将从文件 ./your_package/your_file.py 中加载单个图，其中包含变量 variable。
  • 环境变量从 .env 文件中加载。
{
    "dependencies": [
        "langchain_openai",
        "./your_package"
    ],
    "graphs": {
        "my_agent": "./your_package/your_file.py:agent"
    },
    "env": "./.env"
}

​
依赖项

应用程序可能依赖于其他 Python 包或 JavaScript 库（取决于应用程序编写的编程语言）。 您通常需要为正确设置依赖项指定以下信息：
  1. 目录中指定依赖项的文件（例如，requirements.txt、pyproject.toml 或 package.json）。
  2. 配置文件中的 dependencies 键，指定运行应用程序所需的依赖项。
  3. 任何额外的二进制文件或系统库都可以使用 LangGraph 配置文件 中的 dockerfile_lines 键指定。

​
图

使用配置文件中的 graphs 键来指定哪些图将在部署的应用程序中可用。 您可以在配置文件中指定一个或多个图。每个图都由一个唯一的名称和一个指向 (1) 已编译图或 (2) 定义图的函数的路径标识。

​
环境变量

如果您正在本地使用已部署的 LangGraph 应用程序，您可以在配置文件的 env 键中配置环境变量。 对于生产部署，您通常会希望在部署环境中配置环境变量。
在 GitHub 上编辑此页面源文件。
以编程方式连接这些文档到 Claude、VSCode 等，通过 MCP 获取实时答案。
© . This site is unofficial and not affiliated with LangChain, Inc.