LangGraph Node
2026년 7월 16일
LangGraph Node
정의
Node는 LangGraph 그래프 안에서 실행되는 하나의 작업 단계이다.
보통 Python 함수로 만들고, builder.add_node()로 그래프에 등록한다.
Python
Node 함수의 기본 형태
Python
입력은 보통 LangGraph State이고, 출력은 State에 병합할 딕셔너리이다.
예시: retrieve 노드
Python
retrieve는 답변에 필요한 참고 문서를 준비하는 노드이다.
아래 예시는 실제 검색을 하지 않고, 문서를 하드코딩해서 반환하는 가장 단순한 형태이다.
예시: generate 노드
Python
generate는 context와 question을 프롬프트로 합쳐 LLM에게 전달하고, 결과를 answer에 저장한다.
Node와 일반 함수의 차이
함수 자체는 일반 Python 함수이다.
하지만 LangGraph에 등록되면 그래프 실행 단위가 된다.
Python
이 순간부터 retrieve는 단순 함수가 아니라 그래프의 한 단계로 동작한다.
Node와 Tool의 차이
retrieve 같은 Node는 그래프 설계자가 실행 순서를 정한다.
반면 @tool이 붙은 함수는 LLM이 필요할 때 선택해서 호출한다.
자세한 비교:
한 줄 정리
LangGraph Node는 State를 입력받아 작업을 수행하고, State에 병합될 결과를 반환하는 워크플로우 단계이다.