강의 계획 레슨 250개 중 231번째 · 프로젝트: 도구를 쓰는 조사 에이전트
프로젝트: 도구를 쓰는 조사 에이전트

에이전트의 ReAct 반복 연결하기

이제 프로젝트의 심장이에요: ReAct 반복(추론 -> 행동 -> 관찰), 사실상 모든 에이전트 프레임워크 뒤의 제어 반복이에요. 모델은 한 번에 답하지 않아요. 한 단계를 생각하고, 도구를 고르고, 돌리고, 결과를 읽고, 그제야 다음에 할 일을 정해요. 여러분의 일은 그 반복을 모의 도구 위에서 평범한 Python으로 쓰는 거예요. 그래야 LangChain을 블랙박스로 다루는 대신 기계 장치를 이해해요.

실제 배포에서는 "추론" 단계가 LLM 호출이에요. 여기서는 전체를 오프라인에서(네트워크 없이, API 없이) 테스트할 수 있도록 모델을 작고 결정적인 정책으로 바꿔요. 정책은 과제와 지금까지 모은 관찰을 보고 다음 행동을 돌려줘요. 그 분리가 진짜 교훈이에요: 반복은 일반적이고, 정책만 똑똑해요.

과제는 정책이 읽는 작은 명세예요:

task = {"need": ["team size", "office floors"], "op": "*"}
# "look up these facts, then combine them with this operator"

run_agent(task, tools, max_steps=8)를 만들 거예요. 그건 추적을 돌려줘요: 단계마다 하나씩, (thought, tool, args, observation) 튜플의 순서 있는 리스트. 그 추적이 에이전트의 추론 역사 전체이고, 바로 그걸 기록하고, 다시 재생하고, (다음 레슨에서) 평가해요.

반복이 담은 추론, 매 반복:

  • 필요한 사실이 하나라도 아직 모르는 것이면, 다음 행동은 처음 빠진 것을 search 하는 거예요. 관찰을 기록하고 사실을 기억해요.
  • 모든 사실을 모았고 과제에 op이 있으면, 다음 행동은 두 사실을 합치는 calc예요. 결과를 기억해요.
  • 더 할 일이 없으면, 관찰이 답인 마지막 finish 행동을 내보내고 멈춰요.
def run_agent(task, tools, max_steps=8):
    trace, facts = [], {}
    for _ in range(max_steps):
        missing = [k for k in task["need"] if k not in facts]
        if missing:
            key = missing[0]
            obs = tools["search"]({"query": key})   # ACT + OBSERVE
            facts[key] = obs
            trace.append(("need " + key, "search", {"query": key}, obs))
            continue
        ...   # compute if there is an op, else finish

tools dict는 정신적으로 레슨 1의 등록부예요: search(args)는 사실을 풀고, calc(args)는 a와 b에 op을 적용해요. 최종 답은 op이 있으면 calc 결과이고, 없으면 찾아본 사실 하나예요. 채점기는 단계별 (tool, args, observation) 순서와 최종 답을 확인하니, 반복은 추측이 아니라 실제로 올바르게 보내야 해요. 두 번째, 다른 과제도 돌리니 하드코딩한 추적은 통과할 수 없어요. Run을 눌러 사실 두 개짜리 과제가 추론해서 답에 이르는 걸 보세요.

내 차례

search(args)(시작 코드에 주어진 FACTS 표에서 args["query"]를 풀고, 없으면 "not found")와 calc(args)(+ - * /에 대해 args["a"], args["b"]에 args["op"]을 적용)가 있는 dict를 돌려주는 make_tools()를 쓰세요. 그다음 추론-행동-관찰 반복을 구현하는 run_agent(task, tools, max_steps=8)를 쓰세요: task["need"]에서 아직 빠진 키를 각각 search 하고(처음 빠진 것 먼저), task["op"]이 정해져 있으면 calc, 그다음 (thought, "finish", {"answer": answer}, answer)로 쓴 마지막 finish 단계. (thought, tool, args, observation) 튜플의 순서 있는 리스트를 돌려주세요. 최종 답은 calc 결과이고, op이 없으면 사실 하나예요.

이 레슨에서 문제를 발견했나요? 알려 주세요 · 이 레슨에 대해 묻기

이 연습은 곧 열려요

앞의 레슨을 마치면 이 레슨이 열려요. 강좌 전체가 무료이고 계정도 필요 없으며, 이 레슨은 지금 바로 읽을 수 있어요.