LangGraph Platform

📚 学习目标

学完这篇文章后，你将能够：

• 理解 LangGraph Platform 的核心价值与架构
• 区分四种不同的部署选项（SaaS vs Self-Hosted）
• 掌握从本地开发到生产部署的完整流程

前置知识

在开始学习之前，建议先阅读：

• 01-introduction

1️⃣ 什么是 LangGraph Platform?

你已经在本地跑通了 Agent，现在如何上线？自己搭建服务器（FastAPI/Express）处理流式、持久化、并发、重试是一件非常痛苦的事。

LangGraph Platform 是官方提供的基础设施，专门用于托管 LangGraph 应用。它为你解决了：

• 自动持久化：内置 Postgres Checkpointer。
• 任务队列：处理高并发请求。
• 流式 API：开箱即用的 SSE/Streaming 支持。
• 后台任务：支持长时间运行的任务。

对于前端开发者，它就像是 Vercel 之于 Next.js。

2️⃣ 核心组件

• LangGraph Server: 定义了 API 标准。
• LangGraph Studio: 生产环境的可视化调试台。
• LangGraph CLI: 命令行部署工具。

3️⃣ 部署选项

4️⃣ 配置文件 (langgraph.json)

要部署应用，你需要在根目录创建一个 langgraph.json。

{
  "dependencies": ["."],
  "graphs": {
    "my-agent": "./src/agent.ts:graph"
  },
  "env": "./.env"
}

• dependencies: 依赖项。
• graphs: 导出 Graph 的路径。格式为 文件路径:导出变量名。

💡 练习题

1. 思考题：如果你的公司要求数据绝对不能出内网，你应该选择哪种部署方案？
2. 操作题：为你的项目创建一个 langgraph.json 文件，并尝试使用 LangGraph CLI (如果有) 或 Docker 运行本地 Server。

📚 参考资源

官方文档

• LangGraph Platform

✅ 总结

本章要点：

• Platform 让你专注于业务逻辑，而非基础设施。
• langgraph.json 是部署的核心配置文件。
• Studio 在生产环境中依然可用，是排查线上问题的利器。

下一步：如何组织一个复杂的 LangGraph 项目结构？继续学习：应用结构。