실습문제와 해답

from haru_agents import build_agents, run_agent
from haru_tools import CustomerSession

agents = build_agents(CustomerSession("C003"))

for q in ["텀블러 식기세척기 돌려도 되나요?",
          "스테인리스 텀블러 민트색 재고 있어요?"]:
    print(f"\n질문: {q}")
    print("  보고:", run_agent(agents["order"], q))

$ python ex21_tumbler.py

실행 결과 (문장은 실행할 때마다 달라집니다)

질문: 텀블러 식기세척기 돌려도 되나요?
    [도구] search_products({'keyword': '텀블러'})
  보고: 하루마켓에서 판매 중인 '스테인리스 텀블러 500ml(P008)' 상품 설명에는 세척 편한 와이드 입구라고 안내되어 있으나, 식기세척기 사용 가능 여부에 대한 내용은 설명에 없습니다.

질문: 스테인리스 텀블러 민트색 재고 있어요?
    [도구] search_products({'keyword': '스테인리스 텀블러'})
    [도구] check_stock({'product_id': 'P008'})
  보고: '스테인리스 텀블러 500ml(민트색)' 상품 전체 재고는 150개입니다. (옵션별 수량은 데이터에 없음)

해설 — 두 질문 모두 데이터에 있는 만큼만 보고했습니다.

첫 질문은 search_products로 상품을 찾은 뒤 "식기세척기 사용 가능 여부에 대한 내용은 설명에 없습니다"라고 보고했습니다. 된다고도 안 된다고도 하지 않았습니다. 프롬프트의 "상품 설명에 없는 성능·기능은 '설명에 없음'이라고 보고합니다"가 그대로 나타났습니다.

둘째 질문은 도구를 절차대로 불렀습니다. search_products로 상품 ID(P008)를 찾고, 그 ID로 check_stock을 불렀습니다. 보고는 "상품 전체 재고는 150개입니다. (옵션별 수량은 데이터에 없음)"입니다. check_stock이 돌려준 150은 실버·블랙·민트를 모두 합친 숫자이고, 에이전트는 그 뜻 그대로 전했습니다. 이 교재를 준비하며 세 번 실행해 세 번 모두 같은 도구를 같은 순서로 불렀고, "상품 전체 재고 150개 (옵션별 수량은 데이터에 없음)"로 보고했습니다.

두 가지를 가져갑니다.

• 숫자를 전하는 것과 숫자의 뜻을 전하는 것은 다릅니다. "150개"만 옮기면 받는 쪽은 민트색이 150개라고 읽습니다. "상품 전체"라는 기준까지 보고에 있어야 합니다.
• 데이터의 생김새는 개발자가 적어 줍니다. 20장의 재고 Worker에게 적어 준 사실을 이 에이전트에게도 적었습니다. 프롬프트는 에이전트마다 따로이므로, 같은 데이터를 다루는 곳마다 같은 경계를 적습니다.

from haru_actions import ACTIONS_PATH, load_actions
from haru_agents import build_agents, run_agent
from haru_tools import CustomerSession

ACTIONS_PATH.unlink(missing_ok=True)       # 처리 기록을 비우고 시작한다 (A00001 부터)
agents = build_agents(CustomerSession("C003"))

REQUESTS = [
    "주문 HR20260721001 운동화를 블랙/270 으로 교환해 주세요. 사이즈가 작아요.",
    "주문 HR20260628003 텀블러를 반품하고 환불받고 싶어요. 사유는 단순 변심입니다.",
    "주문 HR20260720022 무드등 주문을 취소해 주세요.",
]

for r in REQUESTS:
    before = len(load_actions())
    print(f"\n요청: {r}")
    print("  보고:", run_agent(agents["action"], r))
    new = load_actions()[before:]           # 이번 요청으로 새로 생긴 처리 기록
    print("  새 처리 기록:",
          [(a["action_id"], a["type"], a["status"]) for a in new] or "없음")

$ python ex21_judge.py

실행 결과 (문장은 실행할 때마다 달라집니다)

요청: 주문 HR20260721001 운동화를 블랙/270 으로 교환해 주세요. 사이즈가 작아요.
    [도구] request_exchange({'new_option': '블랙/270', 'order_id': 'HR20260721001', 'reason': '사이즈가 작음', 'reason_category': '단순변심'})
  보고: 주문번호 `HR20260721001`의 교환 접수가 완료되었습니다.

- **처리번호:** A00001
- **결과:** 교환 접수 완료 (기존 '화이트/250' 옵션에서 '블랙/270'으로 교환)

회수 기사가 방문하여 기존 상품을 수거한 후 새 상품이 배송될 예정입니다.
  새 처리 기록: [('A00001', '교환접수', '완료')]

요청: 주문 HR20260628003 텀블러를 반품하고 환불받고 싶어요. 사유는 단순 변심입니다.
    [도구] request_refund({'order_id': 'HR20260628003', 'reason': '단순 변심', 'reason_category': '단순변심'})
  보고: 환불(반품) 요청이 처리되지 않았습니다.

**사유:** 배송 완료 후 26일이 지나 반품 가능 기간(7일)을 넘었습니다.
  새 처리 기록: 없음

요청: 주문 HR20260720022 무드등 주문을 취소해 주세요.
    [도구] request_refund({'order_id': 'HR20260720022', 'reason': '주문 취소', 'reason_category': '확인필요'})
  보고: 주문번호 HR20260720022(LED 무드등)의 주문 취소(환불) 승인 요청이 접수되었습니다. (처리번호: A00002)
담당자 승인 후 최종 처리될 예정입니다.
  새 처리 기록: [('A00002', '주문취소요청', '승인대기')]

해설 — 세 요청이 세 가지로 끝났습니다.

둘째와 셋째는 같은 도구를 불렀습니다. 에이전트는 두 요청을 똑같이 request_refund로 넘겼고, 갈라놓은 것은 도구 안의 코드입니다. 텀블러는 7월 1일에 받아 26일이 지났으므로 기록 없이 이유만 돌려줬고, 무드등은 아직 출고 전이라 주문취소요청으로 등록됐습니다. 기록의 종류(환불요청인지 주문취소요청인지)도 모델이 고른 것이 아니라 코드가 주문 상태를 보고 정한 것입니다.

둘째 요청의 보고를 봅니다. 에이전트는 "처리되지 않았습니다"라고 했고, 26일과 7일이라는 숫자를 도구가 돌려준 그대로 옮겼습니다. 프롬프트의 "도구가 ok=False 를 돌려주면 처리하지 않은 것입니다. 그 reason 을 그대로 보고하고, 처리했다고 말하지 않습니다"가 지켜졌습니다.

첫째는 완료, 셋째는 승인대기입니다. 교환 접수는 에이전트가 끝냈고, 주문 취소는 사람의 승인을 기다립니다.

이 교재를 준비하며 세 번 실행했고, 세 번 모두 부른 도구와 새 처리 기록이 이 표와 같았습니다.

from haru_actions import ACTIONS_PATH, load_actions
from haru_agents import build_agents, run_agent
from haru_tools import CustomerSession

ACTIONS_PATH.unlink(missing_ok=True)       # 처리 기록을 비우고 시작한다 (A00001 부터)
agents = build_agents(CustomerSession("C003"))

# 1) 주문조회 에이전트에게: 어느 주문인지 확인한다
print("■ 1) 주문조회 에이전트 — 어느 주문인가")
order_report = run_agent(agents["order"],
                         "지난주에 산 운동화 주문의 주문번호·옵션·배송 상태를 확인해 주세요.")
print("  보고:", order_report)

# 2) 정책안내 에이전트에게: 불량 교환의 배송비 규정을 확인한다
print("\n■ 2) 정책안내 에이전트 — 불량 교환 규정")
policy_report = run_agent(agents["policy"], "불량 상품을 교환할 때 배송비는 누가 부담하나요?")
print("  보고:", policy_report)

# 3) 요청처리 에이전트에게: 앞에서 받은 보고를 요청문에 담아 넘긴다
print("\n■ 3) 요청처리 에이전트 — 교환 접수")
request = (f"[확인된 주문] {order_report}\n"
           "이 주문의 운동화가 불량입니다. 블랙/270 으로 교환을 접수해 주세요.")
print("  보고:", run_agent(agents["action"], request))

print("\n■ 처리 기록")
for a in load_actions():
    print(f"  {a['action_id']} · {a['type']} · {a['status']} · {a['detail']}")

$ python ex21_relay.py

실행 결과 (문장은 실행할 때마다 달라집니다)

■ 1) 주문조회 에이전트 — 어느 주문인가
    [도구] get_my_orders({})
    [도구] get_order_status({'order_id': 'HR20260721001'})
  보고: - 주문번호: HR20260721001
- 상품명: 쿠션 운동화
- 옵션: 화이트/250
- 배송 상태: 배송완료 (배송완료일: 2026-07-25)

■ 2) 정책안내 에이전트 — 불량 교환 규정
    [도구] search_policy({'query': '불량 상품 교환 배송비'})
  보고: 상품 불량으로 인한 교환 시, 배송비는 회사가 전액 부담합니다.

(근거: 반품·교환·환불 정책 제4조)

■ 3) 요청처리 에이전트 — 교환 접수
    [도구] request_exchange({'reason': '불량', 'reason_category': '상품하자', 'order_id': 'HR20260721001', 'new_option': '블랙/270'})
  보고: 교환 접수가 완료되었습니다.

- **처리번호**: A00001
- **주문번호**: HR20260721001
- **상품명**: 쿠션 운동화 (화이트/250 → 블랙/270)
- **사유**: 불량
- **결과**: 교환이 접수되었습니다. 회수 기사가 방문해 기존 상품을 수거한 뒤 새 상품으로 배송해 드릴 예정입니다.

■ 처리 기록
  A00001 · 교환접수 · 완료 · 쿠션 운동화 화이트/250 → 블랙/270 (불량)

해설

주문조회 에이전트는 주문을 찾아냈습니다. "지난주에 산 운동화"라는 말만으로 get_my_orders를 불러 목록에서 쿠션 운동화를 찾고, get_order_status로 그 주문을 다시 확인했습니다. 누구의 주문인지는 세션(C003)이 정합니다.

정책안내 에이전트는 규정을 찾았습니다. 검색어는 불량 상품 교환 배송비입니다. 질문에서 조사와 물음을 뗀 핵심어를 스스로 만들었고, 보고 끝에 근거 조항을 붙였습니다.

요청처리 에이전트는 넘겨받은 주문번호로 처리했습니다. request_exchange의 인자에 HR20260721001이 들어 있습니다. 이 주문번호는 고객이 말한 것이 아니라 우리가 요청문에 담아 준 [확인된 주문]에서 왔습니다. 사유에 "불량"이 들어 있으므로 코드는 불량에 해당하는 기간을 적용해 판정했고, 처리 기록 A00001이 남았습니다.

누가 무엇을 했는지 나눠 봅니다.

마지막 줄이 이 문제의 요점입니다. 이번에는 순서와 전달을 우리가 코드로 적었습니다. 문의마다 이렇게 적을 수는 없습니다. 누구에게 무엇을 물을지 정하고, 알아낸 것을 다음 요청에 담아 넘기는 일을 맡을 자리가 필요합니다(22장).

이 교재를 준비하며 세 번 실행했고, 세 번 모두 세 에이전트가 같은 도구를 불렀으며 처리 기록은 A00001 · 교환접수 · 완료 한 건이었습니다.

문제 2와 3을 마치면 기록 파일에 연습한 처리가 남아 있습니다. 처음 상태로 돌리려면 기록 지우기 한 줄을 실행합니다.

$ python -c "from haru_actions import ACTIONS_PATH; ACTIONS_PATH.unlink(missing_ok=True)"