langgraph-workflows

name	langgraph-workflows
description	理解工作流 vs Agent、预定义 vs 动态模式，以及使用 Send API 的编排器-工作器模式 Use when this capability is needed.
metadata	{"author":"evanfang0054"}

langgraph-workflows (JavaScript/TypeScript)

---

name: langgraph-workflows description: 理解工作流 vs Agent、预定义 vs 动态模式，以及使用 Send API 的编排器-工作器模式

概述

LangGraph 同时支持工作流（预定义路径）和Agent（动态决策）。理解何时使用每种模式对于有效的 Agent 设计至关重要。

关键区别：

• 工作流：预定义的代码路径，按特定顺序操作
• Agent：动态，定义自己的流程和工具使用
• 混合：结合确定性和 Agent 步骤

决策表：工作流 vs Agent

特征	工作流	Agent	混合
控制流	固定、预定义	动态、模型驱动	混合
可预测性	高	低	中
复杂性	简单	复杂	可变
使用场景	顺序任务	开放式问题	结构化灵活性
示例	ETL、验证	研究、问答	审查批准

核心模式

1. 预定义工作流

按固定路径顺序执行：

• 数据处理流水线
• 验证工作流
• 多步骤转换

2. 动态 Agent

模型决定下一步：

• ReAct Agent（推理 + 行动）
• 工具调用循环
• 自主任务完成

3. 编排器-工作器模式

一个协调器委托给多个工作器：

• Map-reduce 操作
• 并行处理
• 多 Agent 协作

代码示例

基本工作流（预定义）

import { StateGraph, StateSchema, START, END } from "@langchain/langgraph";
import { z } from "zod";

const WorkflowState = new StateSchema({
  data: z.string(),
  validated: z.boolean(),
  processed: z.boolean(),
});

const validate = async (state: typeof WorkflowState.State) => {
  const isValid = state.data.length > 0;
  return { validated: isValid };
};

const process = async (state: typeof WorkflowState.State) => {
  return {
    data: state.data.toUpperCase(),
    processed: true,
  };
};

// 固定工作流: validate → process
const workflow = new StateGraph(WorkflowState)
  .(, validate)
  .(, process)
  .(, )
  .(, )  
  .(, )
  .();

 result =  workflow.({ :  });
.(result);  

动态 Agent（模型驱动）

import { ChatAnthropic } from "@langchain/anthropic";
import { tool } from "@langchain/core/tools";
import { AIMessage, ToolMessage } from "@langchain/core/messages";
import { StateGraph, StateSchema, MessagesValue, END, START } from "@langchain/langgraph";
import { z } from "zod";

const search = tool(async ({ query }) => `Results for: ${query}`, {
  name: "search",
  description: "Search for information",
  schema: z.object({ query: z.string() }),
});

const calculate = tool(async ({ expression }) => eval(expression).toString(), {
  name: "calculate",
  description: "Calculate a mathematical expression",
  schema: z.object({ expression: z.string() }),
});

const  =  ({
  : ,
});

 model =  ({ :  });
 tools = [search, calculate];
 modelWithTools = model.(tools);

  =  () => {
   response =  modelWithTools.(state.);
   { : [response] };
};

  =  () => {
   lastMessage = state..(-);
   (!lastMessage || !.(lastMessage)) {
     { : [] };
  }

   toolsByName = { [search.]: search, [calculate.]: calculate };
   result = [];

   ( toolCall  lastMessage. ?? []) {
     tool = toolsByName[toolCall.];
     observation =  tool.(toolCall);
    result.(observation);
  }

   { : result };
};

  = () => {
   lastMessage = state..(-);
   (lastMessage && .(lastMessage) && lastMessage.?.) {
     ;
  }
   ;
};


 agent =  ()
  .(, agentNode)
  .(, toolNode)
  .(, )
  .(, shouldContinue, [, ])
  .(, )
  .();

编排器-工作器模式

import { StateGraph, StateSchema, Send, ReducedValue, START, END } from "@langchain/langgraph";
import { z } from "zod";

const OrchestratorState = new StateSchema({
  tasks: z.array(z.string()),
  results: new ReducedValue(
    z.array(z.string()).default(() => []),
    { reducer: (current, update) => current.concat(update) }
  ),
  summary: z.string().optional(),
});

const orchestrator = (state: typeof OrchestratorState.State) => {
  // 将任务扩散到工作器
  return state.tasks.map(task => new Send("worker", { task }));
};

const worker = async () => {
   result = ;
   { : [result] };
};

  =  () => {
   summary = ;
   { summary };
};

 graph =  ()
  .(, worker)
  .(, synthesize)
  .(, orchestrator, [])
  .(, )
  .(, )
  .();

 result =  graph.({
  : [, , ],
});
.(result.);  

混合：带 Agent 步骤的工作流

import { StateGraph, StateSchema, START, END } from "@langchain/langgraph";
import { z } from "zod";

const HybridState = new StateSchema({
  input: z.string(),
  validated: z.boolean(),
  agentResponse: z.string().optional(),
  finalized: z.boolean(),
});

const validate = async (state: typeof HybridState.State) => {
  return { validated: true };
};

const agentProcess = async (state: typeof HybridState.State) => {
  // 动态 agent 逻辑在这里
  const response = `Agent processed: ${state.input}`;
  return { agentResponse: response };
};

const finalize = async (state:  .) => {
   { :  };
};


 hybrid =  ()
  .(, validate)      
  .(, agentProcess)     
  .(, finalize)      
  .(, )
  .(, )
  .(, )
  .(, )
  .();

Map-Reduce 示例

import { StateGraph, StateSchema, Send, ReducedValue, START, END } from "@langchain/langgraph";
import { z } from "zod";

const MapReduceState = new StateSchema({
  documents: z.array(z.string()),
  summaries: new ReducedValue(
    z.array(z.string()).default(() => []),
    { reducer: (current, update) => current.concat(update) }
  ),
  finalSummary: z.string().optional(),
});

const mapDocuments = (state: typeof MapReduceState.State) => {
  return state.documents.map(doc => new Send("summarize", { doc }));
};

const summarize = async (: { doc:  }) => {
   summary = ;
   { : [summary] };
};

  =  () => {
   finalSummary = state..();
   { finalSummary };
};

 graph =  ()
  .(, summarize)
  .(, reduce)
  .(, mapDocuments, [])
  .(, )
  .(, )
  .();

 result =  graph.({
  : [, , ],
});

并行知识库路由器

import { StateGraph, StateSchema, Send, ReducedValue, START, END } from "@langchain/langgraph";
import { z } from "zod";

const RouterState = new StateSchema({
  query: z.string(),
  sources: z.array(z.string()),
  results: new ReducedValue(
    z.array(z.string()).default(() => []),
    { reducer: (current, update) => current.concat(update) }
  ),
  final: z.string().optional(),
});

const classify = async (state: typeof RouterState.State) => {
  const query = state.query.toLowerCase();
  const sources: string[] = [];

  if (query.includes("code")) sources.();
   (query.()) sources.();
   (query.()) sources.();

   { sources };
};

  = () => {
   state..(  (source, { : state. }));
};

  =  () => {
   { : [] };
};

  =  () => {
   { : [] };
};

  =  () => {
   { : [] };
};

  =  () => {
   { : state..() };
};

 graph =  ()
  .(, classify)
  .(, queryGithub)
  .(, queryNotion)
  .(, querySlack)
  .(, synthesize)
  .(, )
  .(, routeToSources, [, , ])
  .(, )
  .(, )
  .(, )
  .(, )
  .();

边界

您能够配置的

✅ 选择工作流 vs Agent 模式 ✅ 混合确定性和 Agent 步骤 ✅ 使用 Send API 进行并行执行 ✅ 定义自定义编排器逻辑 ✅ 控制工作器节点行为 ✅ 使用 reducer 聚合结果

您不能配置的

❌ 更改 Send API 消息传递模型 ❌ 绕过工作器状态隔离 ❌ 修改并行执行机制 ❌ 在运行时覆盖 reducer 行为

注意事项

1. Send 需要工作器状态隔离

// ❌ 错误 - 工作器共享状态，导致冲突
const State = new StateSchema({
  sharedCounter: z.number(),  // 所有工作器修改相同的计数器!
});

// ✅ 正确 - 每个工作器获得隔离的输入
const worker = async (state: { task: string }) => {
  // state 对此工作器是隔离的
  return { results: [process(state.task)] };
};

2. Send 需要累加器 Reducer

// ❌ 错误 - 最后一个工作器覆盖所有其他工作器
const State = new StateSchema({
  results: z.array(z.string()),  // 没有 reducer!
});

// ✅ 正确 - 使用 ReducedValue
import { ReducedValue } from "@langchain/langgraph";

const State = new StateSchema({
  results: new ReducedValue(
    z.array(z.string()).default(() => []),
    { reducer: (current, update) => current.concat(update) }
  ),
});

3. 工作流可能过于僵化

// ❌ 反模式 - 过于僵化的工作流
.addEdge("validate", "process")  // 始终继续，没有错误处理

// ✅ 更好 - 添加条件逻辑
const routeAfterValidate = (state) => {
  if (!state.validated) return "errorHandler";
  return "process";
};

.addConditionalEdges("validate", routeAfterValidate, ["process", "errorHandler"]);

4. 始终 Await 异步节点

// ❌ 错误 - 忘记 await
const result = graph.invoke({ data: "test" });
console.log(result.output);  // undefined!

// ✅ 正确
const result = await graph.invoke({ data: "test" });
console.log(result.output);  // 可以工作!

相关链接

• 工作流和 Agent (JavaScript)
• Send API 指南
• Map-Reduce 示例

---

Converted and distributed by TomeVault — claim your Tome and manage your conversions.