Skip to main content
LangGraph StateGraph가 여러 노드로부터 동시에 상태 업데이트를 받았으나, 해당 상태 속성이 이를 지원하지 않습니다. 이러한 문제는 그래프에서 fanout이나 다른 병렬 실행을 사용하고 있고, 다음과 같이 그래프를 정의한 경우 발생할 수 있습니다: 
class State(TypedDict):
    some_key: str

def node(state: State):
    return {"some_key": "some_string_value"}

def other_node(state: State):
    return {"some_key": "some_string_value"}


builder = StateGraph(State)
builder.add_node(node)
builder.add_node(other_node)
builder.add_edge(START, "node")
builder.add_edge(START, "other_node")
graph = builder.compile()
위 그래프의 노드가 { "some_key": "some_string_value" }를 반환하면, 이는 "some_key"의 상태 값을 "some_string_value"로 덮어씁니다. 그러나 단일 스텝 내에서 fanout과 같이 여러 노드가 "some_key"에 대한 값을 반환하는 경우, 내부 상태를 어떻게 업데이트해야 할지 불확실하므로 그래프는 이 오류를 발생시킵니다. 이를 해결하려면 여러 값을 결합하는 reducer를 정의할 수 있습니다: 
import operator
from typing import Annotated

class State(TypedDict):
    # operator.add reducer 함수는 이를 추가 전용으로 만듭니다  #
    some_key: Annotated[list, operator.add]
이렇게 하면 병렬로 실행되는 여러 노드에서 반환된 동일한 키를 처리하는 로직을 정의할 수 있습니다.

​
문제 해결

다음 사항이 이 오류를 해결하는 데 도움이 될 수 있습니다:
  • 그래프가 노드를 병렬로 실행하는 경우, 관련 상태 키를 reducer와 함께 정의했는지 확인하세요.
Edit the source of this page on GitHub.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.
⌘I