LangChain 智能体部署上线

这篇适合谁、读完能做到什么

适合已经在本地写好 LangChain 智能体、准备把它放到线上运行的开发者。读完你应该能分清两条部署路线，知道 LangSmith Cloud 的前提条件，并走完从 GitHub 仓库到推送代码的第一步。

两条部署路线

LangChain 智能体上线，有两种主要选择^[1]：

• LangSmith Cloud：托管基础设施。LangSmith 把基础设施、扩容和运维问题都接过去，适合有状态、需要长时间运行的智能体。它支持持久化状态和后台执行^[1]。
• JavaScript 框架和托管平台：页面列出的例子有 Next.js、SvelteKit、Nuxt、Cloudflare Workers 和 Deno Deploy。这些部署方式使用 Agent Streaming Protocol 协议^[1]。

选择哪一条路线，先看智能体的性质。页面把 LangSmith Cloud 定位在有状态、需要长时间运行的智能体上，这类智能体需要保存状态，也需要在后台持续执行。如果你的应用本来就构建在 Next.js、SvelteKit、Nuxt 等框架之上，并且计划使用 Agent Streaming Protocol 协议，那么 JavaScript 框架这条路线更贴近现有的技术栈^[1]。

如果两者都不合适，LangSmith 还提供混合部署（hybrid）、独立服务器（standalone server）和自托管加控制平面（self-hosted with control plane）等选项^[1]。

准备：两个账号

按 LangSmith Cloud 的流程部署，需要两个账号。GitHub 账号用来托管代码，LangSmith 账号用来完成部署和管理^[1]：

• 一个 GitHub 账号；
• 一个 LangSmith 账号，注册免费。

上手：从 GitHub 仓库部署

部署到 LangSmith 的代码必须放在 GitHub 仓库里，公开仓库和私有仓库都支持^[1]。这意味着未公开的代码也能部署，不必为了部署而开源^[1]。

第一步是在 GitHub 上新建一个仓库^[1]。在推送代码之前，页面建议先把应用改造成 LangGraph 兼容的形式，做法是按照本地服务器的搭建指南去做^[1]。准备好之后，把代码推送到这个仓库^[1]。

Python 和 JavaScript 的具体部署说明分别放在 :::python 和 :::js 两个段落里，你按自己用的语言看对应的那一节即可^[1]。

限制和常见问题

• 本文只覆盖到把代码放进 GitHub 仓库这一步。LangSmith 之后的部署配置，页面用引用的方式给出，这里没有展开，需要按页面的链接继续阅读^[1]。
• 仓库本身的访问权限、分支管理这类 GitHub 的日常事务，页面没有涉及，需要你按自己团队的习惯处理。
• 页面明确说 LangSmith 负责基础设施、扩容和运维。至于具体的费用、区域和配额，页面没有给出，要以 LangSmith 的说明为准^[1]。
• JavaScript 框架的部署和 LangSmith Cloud 是两条不同的路线，选哪条取决于你的运行方式和团队的技术栈。页面没有替你做这个决定^[1]。

下一步

想了解 LangSmith 的其他部署方式，可以阅读 LangSmith Agent Server 的概览^[1]。想先在本地把服务跑起来，就按页面指向的本地服务器搭建指南操作^[1]。建议的顺序是：先让智能体在本地以 LangGraph 兼容的方式跑通，再创建仓库并推送代码。这样大部分问题都能在本地暴露，部署时需要排查的内容就少得多^[1]。

本文改编自 LangChain 官方文档中的《Deployment》一页^[1]，原文以 MIT 许可证发布。