RAG2026-5일19차시 · Node 이해4 / 19← 이전목차다음 →MetaContents

19차시. Node 이해

1. 노드는 특별한 것이 아닙니다

출처: 원본 PDF 19차시_Node이해.pdf 3쪽 · 쪽 그림 3쪽

"노드"라는 말이 거창하게 들리지만, 실체는 아주 단순합니다.

🧩 노드의 정의 — 딱 한 줄
State를 받아서, 바뀐 부분을 딕셔너리로 돌려주는 함수
그게 전부입니다.
def 노드이름(state):
​# 뭔가 한다
return {"바꾼키": 새값}
클래스를 상속받을 필요도 없고
특별한 데코레이터도 필요 없습니다.
평범한 파이썬 함수입니다.

1-1) 최소 노드 예시

Python
def hello_node(state):
    return {"answer": "안녕하세요"}

# 그래프에 등록
g.add_node("hello", hello_node)

1-2) 그래프 없이도 돌아갑니다

Python
# 그냥 함수니까 직접 불러도 됩니다
result = hello_node({"question": "안녕?"})
print(result)      # {'answer': '안녕하세요'}

실행 결과 예시 (코드를 읽고 만든 예상 화면입니다. 실제 실행 결과, 특히 모델의 답은 다를 수 있습니다)

출력
{'answer': '안녕하세요'}

💡 이게 왜 중요할까요?
노드를 그래프 없이 테스트할 수 있다는 뜻입니다.
그래프를 만들고 컴파일하고 invoke하는 대신
함수 하나만 딱 불러서 확인하면 됩니다.
· 빠릅니다 (그래프 구성 시간 없음)
· 원인이 명확합니다 (이 노드만의 문제)
· 디버깅이 쉽습니다 (breakpoint 걸기 편함)
이것이 오늘 배울 가장 실용적인 내용입니다.

← 이전 절19차시 · 이번 차시에서 배우는 것다음 절 →19차시 · 2. 왜 굳이 함수를 쪼갤까?