LangGraph:低層編排骨架,把控制權交回開發者手上

摘要

節點是步驟、邊是流轉、狀態在中間跑,而同一張圖可以混用確定性程式與模型判斷。續跑點、審批卡點與可檢查的狀態是原語,不是事後補丁。

推薦
軟體名稱
LangGraph
版本
1.2.11
開源
開源
作業系統
LinuxmacOSWindows
更新時間
2026-10-06 14:34

代理框架這兩年出得很快,但多數是先幫你把「一個能自己幹活的代理」包好,再讓你在它的殼子裡改。這一個反過來走:它把自己定位成低層編排骨架加執行環境,把控制權交回開發者。首頁直接點出它取捨的那條線——在控制力與自主性之間取平衡,用來設計能可靠處理複雜任務的代理。

專案首頁:低層編排骨架與執行環境

四件事各自佔了一章

人工介入是可選的,但被當成一等公民:在關鍵節點插入檢查點,讓人可以審核、加上品質檢查、在代理動手之前先批准;官方的說法很白——替代理加上檢查點,好引導並批准它的動作。控制流有三種形狀:單一代理、多代理、階層式,三者吃同一套低層原語,也就是結構隨需求長,不必為了改架構而換框架。記憶是內建的:對話歷史會被保存,上下文跨工作階段延續,官方說明把它拆成短期工作記憶與跨工作階段的長期存放兩層。串流同樣被當成一等公民,原生的逐詞輸出把推理與動作即時露出來——這其實是留給前端體驗的介面。

兩種步驟,同一張圖

最要害的設計是允許混用。同一張圖裡,需要穩定、需要可稽核的環節,寫成確定性的手寫邏輯;需要隨機應變的環節,交給模型判斷。聽起來很樸素,落到工程上差別卻很大:你不必在「全自動」與「全腳本」之間二選一,而是逐段決定模型該出現在哪裡。官方說明把它概括成低層編排骨架與執行環境,用來建置、管理與部署長期運作的有狀態代理,並提到已被大型金融、出行與銀行機構採用。它同時把依賴邊界畫得很清楚:一個模型加一個工具就能起步,文件裡常借用同門的元件生態做整合,但用這套框架並不要求把那個生態一起拉進來。

起步確實輕。安裝就是一個套件,官方的 hello world 用狀態圖與訊息狀態建好節點,把起點與終點連起來,編譯後呼叫,回傳一則模型訊息。那段程式碼把它的世界觀交代完了:節點是步驟,邊是流轉,狀態在中間跑。

官方說明站:狀態圖、持久化與人工介入

續跑與審批,是為上線準備的

說明站列出的核心收益裡,前三條都屬於「上線之後才會遇到」的問題。持久化執行讓代理在失敗後從中斷處恢復,不必整件事重跑一遍;人工介入允許在任何時點檢查並修改狀態;綜合記憶把短期工作記憶與長期存放分開管。再加上官方另一套產品提供的除錯與可觀測能力,以及面向長期運作工作流的部署。說明站的目錄結構也看得出側重:持久化檢查點、儲存、容錯、事件串流、中斷、時間旅行、子圖、部署,幾乎每一章都在回答「跑長了怎麼辦」。

溯源那一段寫得很坦率:受圖計算與分散式資料流的經典設計啟發,公開介面參考了一套知名圖形函式庫,由一個廣泛使用的代理元件生態團隊打造,但可以脫離它使用。

開源儲存庫:MIT 授權與社群規模

適合誰用

三種人比較對症。需要長期運作的工程團隊:續跑、人工審批卡點、狀態可查,在這裡是原語而不是事後補的補丁。對控制粒度有要求的團隊:不想被單一黑箱認知架構框住,想逐段決定哪裡用模型、哪裡用死邏輯。以及已經在那個元件生態裡的人:觀測、評測與部署都有對應產品接得上。

要留意的地方也有幾處。它是低層框架,抽象少意味著程式碼量偏大;想快速做出一個示範型代理,從高層封裝起步會省事得多,專案自己的說明也指向這類上層專案。生態裡的觀測與部署能力在雲端提供,本地自建得自己補齊。授權方面儲存庫以 MIT 發布,數據約為 41.8k 顆星、7.1k 次分支、561 個發布、301 位貢獻者、被 44K 個專案使用,另外有同等能力的腳本語言版本。

低層框架的價值不在於讓你少寫程式,而在於當流程跑到第二十步卡住時,你手上有明確的鉤子可以插進去。

LangGraph下載地址
支援的作業系統: Linux macOS Windows