Skip to main content
应用程序必须使用配置文件进行配置，才能部署到 LangSmith（或进行自托管）。本操作指南讨论了使用 requirements.txt 指定项目依赖项来设置应用程序以进行部署的基本步骤。 此示例基于此仓库，该仓库使用 LangGraph 框架。 最终的仓库结构将如下所示：
LangSmith 部署支持部署 LangGraph 图。然而，图的_节点_实现可以包含任意代码。这意味着任何框架都可以在节点内实现并部署在 LangSmith 部署上。这使您无需使用额外的 LangGraph 开源 API 即可实现核心应用逻辑，同时仍可使用 LangSmith 进行部署、扩展和可观测性。更多详情，请参阅在 LangSmith 部署中使用任何框架。
你也可以使用以下方式设置：
  • pyproject.toml：如果你更喜欢使用 poetry 进行依赖管理，请查看此操作指南了解如何在 LangSmith 中使用 pyproject.toml。
  • 单仓库（monorepo）：如果你有兴趣部署位于单仓库内的图，请查看此仓库了解如何操作的示例。
每个步骤之后，都会提供一个示例文件目录，以演示代码的组织方式。

​
指定依赖项

依赖项可以选择性地在以下文件之一中指定：pyproject.toml、setup.py 或 requirements.txt。如果未创建这些文件中的任何一个，则可以在配置文件中稍后指定依赖项。 以下依赖项将包含在镜像中，你也可以在代码中使用它们，只要版本范围兼容即可：
示例 requirements.txt 文件：
示例文件目录：

​
指定环境变量

环境变量可以选择性地在文件中指定（例如 .env）。请参阅环境变量参考以配置部署的其他变量。 示例 .env 文件：
示例文件目录：
默认情况下，LangSmith 遵循 uv/pip 的行为，不会安装预发布版本，除非明确允许。如果您想使用预发布版本，有以下选项：
  • 使用 pyproject.toml：在 [tool.uv] 部分添加 allow-prereleases = true。
  • 使用 requirements.txt 或 setup.py：您必须明确指定每个预发布依赖项，包括传递性依赖。例如，如果您声明 a==0.0.1a1 且 a 依赖于 b==0.0.1a1，那么您还必须在依赖项中明确包含 b==0.0.1a1。

​
定义图

实现你的图。图可以在单个文件或多个文件中定义。请注意每个要包含在应用程序中的 CompiledStateGraph 的变量名。变量名将在稍后创建 LangGraph 配置文件时使用。 示例 agent.py 文件，展示了如何从你定义的其他模块导入（此处未显示模块的代码，请参阅此仓库查看其实现）：
示例文件目录：

​
创建配置文件

创建一个名为 langgraph.json 的配置文件。有关配置文件 JSON 对象中每个键的详细说明，请参阅配置文件参考。 示例 langgraph.json 文件：
请注意，CompiledGraph 的变量名出现在顶级 graphs 键的每个子键值的末尾（即 :<variable_name>）。
配置文件位置 配置文件必须放置在与包含编译图及其关联依赖项的 Python 文件同级或更高级别的目录中。
示例文件目录：

​
下一步

设置好项目并将其放入 GitHub 仓库后，就该部署你的应用了。
将这些文档通过 MCP 连接到 Claude、VSCode 等，以获取实时答案。
在 GitHub 上编辑此页面 或 提交问题。