강의 계획 레슨 250개 중 176번째 · 에이전트 만들기 (도구 사용과 ReAct)
에이전트 만들기 (도구 사용과 ReAct)

계획, 되돌아보기, 다시 계획하기

ReAct 반복 하나는 도구 호출 하나에는 괜찮지만, 진짜 과제에는 단계가 있어요: 주제를 조사하고, 그다음 요약하기. 비행기를 예약하고, 그다음 호텔. 유능한 에이전트는 한 번에 행동 하나를 즉흥으로 하지 않아요 - 계획을 세우고, 그것을 해 나가고, 단계마다 되돌아보며 계속할지, 방향을 고칠지, 멈출지 정해요. 그 계획-행동-되돌아보기 주기가 에이전트가 헤매지 않고 긴 과제를 끝내게 해요.

1. 목표를 계획으로 나누기

계획은 흐릿한 목표를 순서 있는 하위 과제 리스트로 바꾸는 거예요. 운영에서는 모델이 이 계획을 써요. 여기서는 테스트할 수 있도록 결정적이고 키워드로 움직이게 만들어요. 같은 생각, 고정된 출력:

def decompose(goal):
    g = goal.lower()
    if "research" in g or "report" in g:
        return ["gather sources", "extract facts", "write summary"]
    elif "trip" in g or "travel" in g:
        return ["pick dates", "book flights", "book hotel"]
    return ["understand goal", "do the work", "review result"]

2. 각 단계의 결과 되돌아보기

하위 과제가 돈 뒤 에이전트는 결과를 보고 제어 결정을 내려요. 작은 결과 dict {"ok": bool, "last": bool}(단계가 성공했나, 그리고 마지막 단계인가)와 가능한 결정 세 개를 줘요:

  • "replan" - 단계가 실패했어요. 무엇을 시도했든 안 됐으니, 현재 계획이 의심스러워요.
  • "done" - 단계가 성공했고 마지막이었어요. 목표를 이뤘어요.
  • "continue" - 성공했지만 할 일이 더 있어요. 다음 하위 과제로 가요.

순서가 중요해요: 실패는 마지막 단계에서도 "replan"이에요(망가진 마지막 단계는 "done"이 아니에요).

3. 실패하면 한 번 다시 계획하기

제어기가 모두 묶어요. 계획을 걸으며 단계마다 execute(subtask)를 부르고, 마지막인지 표시하고, 되돌아봐요. "continue"면 나아가고, "done"이면 성공적으로 멈추고, "replan"이면 새 회복 계획을 만들어 다시 시작해요 - 하지만 가망 없는 과제가 영원히 반복하지 못하도록 max_replans번까지만이에요(앞에서 배운 반복 방지 규율). 다시 계획할 횟수가 떨어지면 "failed"로 멈춰요.

def replan(goal, failed_step):
    # retry the failed step, then still do every step that came after it
    base = failed_step[len("retry: "):] if failed_step.startswith("retry: ") else failed_step
    plan = decompose(goal)
    rest = plan[plan.index(base) + 1:] if base in plan else []
    return ["retry: " + base] + rest

여기서 execute는 모의예요 - 하위 과제에 대해 {"ok": ...}를 돌려주는 여러분이 넘기는 함수 - 제어기가 완전히 결정적이고 테스트할 수 있도록 진짜 도구 호출을 대신해요. 실시간 에이전트에서는 같은 제어기가 로직을 바꾸지 않고 진짜 도구와 모델이 쓴 계획을 몰아요. Run을 눌러 계획이 성공하는 걸 보고, 그다음 한 단계에서 실패하고 다시 계획해서 회복하는 걸 보세요.

내 차례

계획 제어기를 만드세요. 순서 있는 하위 과제 리스트를 돌려주는 decompose(goal)를 쓰세요(research/report -> ["gather sources", "extract facts", "write summary"], trip/travel -> ["pick dates", "book flights", "book hotel"], 그 밖 -> ["understand goal", "do the work", "review result"]). {"ok", "last"}에 대해 ok가 아니면 "replan", 아니면 last면 "done", 아니면 "continue"를 돌려주는 reflect(step_result)를 쓰세요. replan(goal, failed_step)을 쓰세요 -> 실패한 단계를 다시 시도하고 그다음 decompose(goal)에서 그 뒤에 오는 모든 단계를 여전히 하는 회복 계획: "extract facts"에서 실패한 research 목표라면 ["retry: extract facts", "write summary"]. (남은 일을 건너뛰고 "done"이라고 알리는 회복 계획은 고전적인 에이전트 버그예요: 요약은 결코 쓰이지 않았어요.) failed_step 자체가 재시도라면 접두사가 겹치지 않도록 먼저 "retry: " 접두사를 벗기세요. 그다음 계획을 걸으며, execute(subtask)({"ok": bool}를 돌려줘요)를 부르고, 되돌아보고(last는 여러분이 정해요), (subtask, ok, decision) 추적을 기록하고, 실패하면 max_replans번까지 다시 계획하고(회복 계획의 첫 단계부터 다시 시작), {"status": "done"|"failed", "trace": [...], "replans": int}를 돌려주는 run_plan(goal, execute, max_replans=1)을 쓰세요.

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

이 연습은 곧 열려요

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