[Week1] StateGraph를 활용한 쇼핑 정보 ReAct Agent 구현

[Parkhaeil]

선택 도메인

쇼핑 추천 에이전트 (1주차는 mock 데이터, 3주차부터 실제 상품 데이터로 확장 예정)

이번 주 구현 목표

StateGraph로 직접 ReAct 루프를 구성하고, Pydantic으로 structured output을 강제

구현 요약

• 노드 3개: agent(도구 사용 판단) / tools(도구 실행) / final(구조화 응답 생성)
• 도구 3개: search_products, get_product_detail, get_size_guide
• 조건부 엣지 should_continue로 agent 다음 라우팅 (tool_calls 유무 판단)
• tools → agent 백엣지로 ReAct 루프 형성
• 응답 스키마: answer, reasoning, tools_used, confidence

그래프 흐름

START → agent → (tool_calls 있음?) ─Y→ tools → agent
└N→ final → END

[그래프 시각화 이미지 첨부]

실행 방법

1. .env에 ANTHROPIC_API_KEY (또는 OPENAI_API_KEY) 설정
2. 노트북 위에서부터 셀 순차 실행

테스트 결과 요약

질문	호출 도구	confidence
운동화 뭐 있어?	search_products	0.9
아디다스 삼바 P001 상세 + 사이즈 가이드	get_product_detail, get_size_guide	0.95
안녕! 너 뭐 할 줄 알아?	(없음)	0.5

막힌 점 / 다음 주 개선

• 현재 mock 데이터라 도메인 깊이가 얕음 → 3주차 RAG에서 실제 상품 페이지로 교체
• 도구 실패 fallback 단순 → 4주차에 retry 로직 추가 예정