19차시. Node 이해

8. 노드 명세서 만들기

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

노드가 늘어나면 "누가 뭘 읽고 뭘 쓰는지" 헷갈립니다. 표로 남겨두세요.

노드	읽는 키	쓰는 키	책임
retrieve	query, top_k	documents, scores, / retrieval_ok	근거 확보
generate	documents, / question	answer, insufficient, / has_citation	답변 작성
verify	answer, documents	grade, reason	품질 판정
rewrite	question, retries	query, retries, / tried_queries	질의 개선
fallback	tried_queries	answer, grade	안전한 마무리

8-1) 이 표로 설계를 점검하기

🔍 표를 보고 확인할 세 가지
① 같은 키를 두 노드가 쓰고 있지 않은가?
answer를 generate와 fallback이 둘 다 씁니다
→ 둘은 동시에 실행되지 않으므로 괜찮습니다
→ 동시에 실행되는 노드가 같은 키를 쓰면 문제입니다
② 아무도 안 쓰는 키가 있는가?
있다면 State에서 빼도 됩니다
③ 읽으려는데 아무도 안 채우는 키가 있는가?
있다면 KeyError가 납니다. 초기값을 넣으세요

⚠️ verify와 rewrite는 아직 안 만들었습니다
26차시(Verifier)와 30차시(Rewrite)에서 만듭니다.
지금 표에 미리 적어두는 이유는
State 설계가 그때도 맞는지 확인하기 위해서입니다.
지금 State에 grade, reason, tried_queries가 있으니
나중에 노드만 추가하면 됩니다. 스키마는 안 고쳐도 됩니다.