LangGraph.js 于 2026-09-25 发布 `@langchain/[email protected]`,并由 `@langchain/[email protected]` / vue / svelte 同步放出:`useStream` 的 multitask 策略 `"enqueue"` 可选 `queue: "server"`,把排队从浏览器内存改成后端 Runs REST(`POST/GET /threads/{id}/runs` 与 cancel)。队列跨刷新与多会话可见,`cancelQueued`/`clearQueue` 也走服务端。默认仍 `queue: "local"`,自定义 `AgentServerAdapter` 不支持该选项。适合要把 Agent 聊天队列做成可恢复、可协作的前端团队。

核心要点速览 (Key Takeaways)

🔬

深度技术解析与实战评估

核心背景与行业痛点

Agent 聊天 UI 常用 useStream 把用户连点的任务排进 "enqueue" 队列,但队列若只活在浏览器内存里:一刷新就丢、多标签不同步、关页无法协作取消。云端 LangGraph 部署其实已有 Runs REST,前端却仍把排队当本地玩具——长任务与「人在回路」场景会反复出现幽灵队列与重复提交。

架构亮点与底层机制

[@langchain/[email protected]](https://github.com/langchain-ai/langgraphjs/releases/tag/%40langchain%2Flanggraph-sdk%401.12.0)(#2848)让 "enqueue" 可设 queue: "server":排队项变成后端真实 run,经 POST/GET /threads/{thread_id}/runs 持久化,并用 POST /threads/{thread_id}/runs/{run_id}/cancel 取消。刷新后仍在,其他会话可见;cancelQueued/clearQueue 同步打到服务端。默认 queue: "local" 保持旧行为。@langchain/[email protected]、[email protected]、[email protected] 同步放出;@langchain/[email protected] 主要是依赖对齐。自定义 AgentServerAdapter 传输不支持该选项——queue 只作用于内置 transport。

权威 Benchmark 与实测跑分对比

发行说明未给队列吞吐或跨会话一致性的公开数字。验收应用两个浏览器会话:server 队列在刷新后仍列出;cancel 后两端消失;未实现 Runs REST 的后端应明确失败而非静默回落 local。不要用 local 队列的内存延迟外推 server 路径。

开发者实战落地与开箱指南

npm i @langchain/[email protected] @langchain/[email protected]

在 useStream 上传入 queue: "server"(配合 multitask: "enqueue"),并确认 apiUrl 后端实现 Runs REST。Howto:useStream React;总览见 LangGraph.js 与 npm [@langchain/langgraph-sdk](https://www.npmjs.com/package/@langchain/langgraph-sdk)、[@langchain/react](https://www.npmjs.com/package/@langchain/react)。先在 staging 用两个浏览器会话验证队列持久化与 cancel,再打开生产开关。