單 Agent 會(huì)遇到天花板工具一多就亂選、長(zhǎng)任務(wù)一斷就從頭再來(lái)。LangGraph 用「把流程畫(huà)成狀態(tài)機(jī)」的方式解決這些問(wèn)題這也是它成為 2026 年生產(chǎn)級(jí) Agent 首選的原因。附完整可運(yùn)行代碼。文章目錄一、為什么不是 LangChain 而是 LangGraph二、環(huán)境與最小示例三、條件邊讓流程學(xué)會(huì)「拐彎」四、多智能體三種協(xié)作拓?fù)湓趺催x五、斷點(diǎn)續(xù)跑與人工介入生產(chǎn)剛需5.1 Checkpoint進(jìn)程崩了也能續(xù)5.2 Interrupt關(guān)鍵操作前停下來(lái)等人批5.3 節(jié)點(diǎn)級(jí)重試讓偶發(fā)故障自愈5.4 流式輸出用戶(hù)體驗(yàn)的分水嶺5.5 什么時(shí)候不要用多 Agent六、生產(chǎn)化檢查清單一、為什么不是 LangChain 而是 LangGraph一句話說(shuō)清關(guān)系LangChain 是組件庫(kù)LangGraph 是把組件串成可控流程的編排層。它把 Agent 的工作流建模成圖GraphNode節(jié)點(diǎn)一個(gè)函數(shù)干一件事調(diào)模型、跑工具、查庫(kù)Edge邊節(jié)點(diǎn)之間的流轉(zhuǎn)支持條件分支State狀態(tài)全局共享的數(shù)據(jù)所有節(jié)點(diǎn)讀寫(xiě)。好處在生產(chǎn)環(huán)境才顯出來(lái)能力裸寫(xiě) Agent 循環(huán)LangGraph流程可控模型自己決定下一步黑盒圖里畫(huà)死白盒可審計(jì)斷點(diǎn)續(xù)跑斷了重來(lái)token 白燒checkpoint 自動(dòng)落盤(pán)從斷點(diǎn)恢復(fù)人工介入基本沒(méi)法做原生 interrupt人審后繼續(xù)出錯(cuò)定位翻日志猜每個(gè)節(jié)點(diǎn)獨(dú)立可測(cè)二、環(huán)境與最小示例pipinstalllanggraph langchain-openaiexportOPENAI_API_KEYsk-xxx# 或用 Ollama把 ChatOpenAI 換成 base_url 指向本地先看一個(gè)「三個(gè)節(jié)點(diǎn)串成審查流水線」的骨架# minimal_graph.pyfromtypingimportTypedDictfromlanggraph.graphimportStateGraph,START,ENDclassState(TypedDict):question:strdraft:strreview:strfinal:strdefdraft_node(state:State)-dict:# 實(shí)際項(xiàng)目在這里調(diào) LLM示例用占位return{draft:f關(guān)于「{state[question]}」的初稿}defreview_node(state:State)-dict:return{review:f初稿審查通過(guò){state[draft]}}defpolish_node(state:State)-dict:return{final:f定稿{state[draft]}已按審查意見(jiàn)修改}builderStateGraph(State)builder.add_node(draft,draft_node)builder.add_node(review,review_node)builder.add_node(polish,polish_node)builder.add_edge(START,draft)builder.add_edge(draft,review)builder.add_edge(review,polish)builder.add_edge(polish,END)graphbuilder.compile()resultgraph.invoke({question:AI Agent 的三大組件})print(result[final])狀態(tài)就是 TypedDict節(jié)點(diǎn)返回「要更新的字段」框架負(fù)責(zé)合并——這就是 LangGraph 的全部心智模型。三、條件邊讓流程學(xué)會(huì)「拐彎」審查不通過(guò)要打回重寫(xiě)用條件邊實(shí)現(xiàn)fromlanggraph.graphimportStateGraph,START,ENDfromtypingimportTypedDict,LiteralclassState(TypedDict):draft:strscore:intattempts:intdefreview_node(state:State)-dict:return{score:60ifstate[attempts]2else85}# 模擬評(píng)分defroute(state:State)-Literal[rewrite,accept]:returnrewriteifstate[score]80elseacceptbuilderStateGraph(State)builder.add_node(review,review_node)builder.add_conditional_edges(review,route,{rewrite:review,accept:END})builder.add_edge(START,review)# 真實(shí)項(xiàng)目記得加最大重試次數(shù)防止無(wú)限循環(huán)燒錢(qián)defroute_safe(state:State)-Literal[rewrite,accept]:ifstate[attempts]3:returnaccept# 超限降級(jí)接受并標(biāo)記人工處理returnrewriteifstate[score]80elseaccept踩坑所有循環(huán)邊必須有退出條件。沒(méi)設(shè)重試上限的審查循環(huán)模型可能永遠(yuǎn)打回重寫(xiě)一晚上燒掉一個(gè)月預(yù)算。四、多智能體三種協(xié)作拓?fù)湓趺催x拓?fù)浣Y(jié)構(gòu)適用注意Supervisor主管式一個(gè)協(xié)調(diào)節(jié)點(diǎn)分派給專(zhuān)家節(jié)點(diǎn)大多數(shù)業(yè)務(wù)場(chǎng)景推薦默認(rèn)協(xié)調(diào)節(jié)點(diǎn)邏輯要簡(jiǎn)單明確流水線節(jié)點(diǎn)串行各自加工文檔處理、內(nèi)容生產(chǎn)上游輸出質(zhì)量決定一切辯論/群聊多個(gè) Agent 互評(píng)方案評(píng)審、提高結(jié)論可靠性token 消耗 ×N慎用Supervisor 模式骨架生產(chǎn)最常用# supervisor.py核心邏輯節(jié)選fromlanggraph.graphimportStateGraph,START,ENDfromtypingimportTypedDict,LiteralclassTeamState(TypedDict):task:strnext_agent:strresearch:strcode:strreport:strdefsupervisor(state:TeamState)-dict:# 實(shí)際項(xiàng)目用 LLM 結(jié)構(gòu)化輸出決定下一個(gè) agent# prompt 要求只輸出 researcher / coder / writer / FINISHifnotstate.get(research):return{next_agent:researcher}ifnotstate.get(code):return{next_agent:coder}ifnotstate.get(report):return{next_agent:writer}return{next_agent:FINISH}defroute(state:TeamState)-Literal[researcher,coder,writer,__end__]:return{FINISH:__end__}.get(state[next_agent],state[next_agent])builderStateGraph(TeamState)builder.add_node(supervisor,supervisor)builder.add_node(researcher,lambdas:{research:調(diào)研結(jié)果...})builder.add_node(coder,lambdas:{code:print(hello)})builder.add_node(writer,lambdas:{report:最終報(bào)告...})builder.add_edge(START,supervisor)builder.add_conditional_edges(supervisor,route)fornodein[researcher,coder,writer]:builder.add_edge(node,supervisor)# 干完活回主管由主管決定下一步注意專(zhuān)家節(jié)點(diǎn)干完活必須回到 supervisor由它統(tǒng)一調(diào)度——讓專(zhuān)家之間直接對(duì)話是多 Agent 系統(tǒng)失控的頭號(hào)原因。五、斷點(diǎn)續(xù)跑與人工介入生產(chǎn)剛需5.1 Checkpoint進(jìn)程崩了也能續(xù)fromlanggraph.checkpoint.sqliteimportSqliteSaver checkpointerSqliteSaver.from_conn_string(runs.db)graphbuilder.compile(checkpointercheckpointer)# 每次調(diào)用帶 thread_id同一個(gè) id 的執(zhí)行歷史自動(dòng)持久化config{configurable:{thread_id:order-20260928-001}}graph.invoke({task:處理這批退貨工單},config)# 進(jìn)程重啟后同 thread_id 再 invoke從最近的 checkpoint 繼續(xù)5.2 Interrupt關(guān)鍵操作前停下來(lái)等人批fromlanggraph.typesimportinterrupt,Commanddefrefund_node(state:TeamState)-dict:# 流程會(huì)在這里暫停把內(nèi)容拋給人類(lèi)approvalinterrupt({question:是否同意退款,detail:state[task]})ifapproval!yes:return{report:已取消人工拒絕了退款}return{report:退款已執(zhí)行}人工放行只需對(duì)同一thread_id再發(fā)一次指令graph.invoke(Command(resumeyes),config)凡是動(dòng)錢(qián)的、發(fā)出去就收不回的操作退款、發(fā)郵件、調(diào)用生產(chǎn) API前面一律加 interrupt。這一條能避開(kāi) 90% 的 Agent 事故。5.3 節(jié)點(diǎn)級(jí)重試讓偶發(fā)故障自愈調(diào)外部 API 的節(jié)點(diǎn)模型、搜索、數(shù)據(jù)庫(kù)總有抖動(dòng)LangGraph 內(nèi)置了重試策略不用自己包 try/exceptfromlanggraph.pregelimportRetryPolicy builder.add_node(researcher,research_fn,retryRetryPolicy(max_attempts3,initial_interval1.0,backoff_factor2.0),)注意只給會(huì)抖動(dòng)的節(jié)點(diǎn)加重試。LLM 調(diào)用、HTTP 請(qǐng)求值得加純本地計(jì)算解析、格式化加了反而掩蓋真 bug。5.4 流式輸出用戶(hù)體驗(yàn)的分水嶺多 Agent 鏈路長(zhǎng)不流式的話用戶(hù)盯著白屏幾十秒必走人。LangGraph 兩種流式都支持# 1) token 級(jí)流式模型邊生成邊吐字forchunkingraph.stream({task:總結(jié)這批工單},config,stream_modemessages):ifchunk.content:print(chunk.content,end,flushTrue)# 2) 節(jié)點(diǎn)級(jí)流式前端展示「正在執(zhí)行調(diào)研 → 寫(xiě)碼 → 出報(bào)告」forupdateingraph.stream(input,config,stream_modeupdates):fornode_name,state_deltainupdate.items():print(f[步驟]{node_name}完成)生產(chǎn)建議兩個(gè)都開(kāi)節(jié)點(diǎn)級(jí)做進(jìn)度條token 級(jí)做正文輸出。5.5 什么時(shí)候不要用多 Agent潑一盆必要的冷水——多 Agent 不是銀彈出現(xiàn)以下信號(hào)時(shí)留在單 Agent任務(wù)流程固定、步驟少寫(xiě)成普通函數(shù)鏈更穩(wěn)、更便宜、更好測(cè)單模型 好的 Prompt 能達(dá)標(biāo)多 Agent 拓?fù)浔旧頃?huì)引入新的失敗模式調(diào)度錯(cuò)、狀態(tài)污染token 預(yù)算緊張Supervisor 每次調(diào)度都是額外 LLM 調(diào)用成本輕松翻倍。判斷標(biāo)準(zhǔn)當(dāng)「一個(gè) Prompt 裝不下所有工具和規(guī)則」或者「不同環(huán)節(jié)需要不同模型/溫度/權(quán)限」時(shí)才值得拆多 Agent。拆分時(shí)優(yōu)先按權(quán)限拆能碰錢(qián)的和不能碰錢(qián)的分開(kāi)其次按領(lǐng)域拆。六、生產(chǎn)化檢查清單每個(gè)節(jié)點(diǎn)單一職責(zé)可獨(dú)立單測(cè)LangGraph 節(jié)點(diǎn)就是普通函數(shù)所有循環(huán)有最大次數(shù)限制thread_id有業(yè)務(wù)含義訂單號(hào)/會(huì)話 id方便追溯危險(xiǎn)操作前有 interrupt接 LangSmith 或自建日志每個(gè)節(jié)點(diǎn)的輸入輸出留痕狀態(tài)里的字段做減法——狀態(tài)越大每次 checkpoint 越貴。