跳到内容

INVALID_CONCURRENT_GRAPH_UPDATE

LangGraph StateGraph 从多个节点收到了对其状态的并发更新,而状态的某个属性不支持此操作。

出现这种情况的一种方式是,如果您在图中使用 扇出 (fanout) 或其他并行执行,并且您定义的状态值如下:

const StateAnnotation = Annotation.Root({
  someKey: Annotation<string>,
});

const graph = new StateGraph(StateAnnotation)
  .addNode(...)
  ...
  .compile();

如果上述图中的一个节点返回 { someKey: "someStringValue" },这将把 someKey 的状态值覆盖为 "someStringValue"。然而,如果在单个步骤内的多个节点(例如在扇出中)返回 "someKey" 的值,图将抛出此错误,因为如何更新内部状态存在不确定性。

为了解决这个问题,您可以定义一个 reducer 来合并多个值:

const StateAnnotation = Annotation.Root({
  someKey: Annotation<string[]>({
    default: () => [],
    reducer: (a, b) => a.concat(b),
  }),
});

这将允许您定义处理并行执行的多个节点返回相同键的逻辑。

故障排除

以下内容可能有助于解决此错误:

  • 如果您的图并行执行节点,请确保您已为相关的状态键定义了 reducer。