╬ 오케스트레이션·에이전트 엔지니어링

🖐 실무 따라하기 — 복붙해서 따라 하면 됩니다

1. 1오케스트레이터에게 '역할'과 '상한'을 먼저 못박기

   Claude 또는 ChatGPT 웹(또는 이 플랫폼 /playground)을 열고 새 대화를 시작한다. 아래 프롬프트 전문을 그대로 붙여넣어, 이 대화가 '조정관(오케스트레이터)' 역할이며 지켜야 할 상한(budget)이 무엇인지 먼저 선언한다. 아직 민원 내용은 주지 않는다 — 규칙부터 세운다.

   프롬프트 (복사해서 AI에 입력)

   ⧉ 복사

   너는 지금부터 '복합민원 TF 총괄 조정관(오케스트레이터)'이다. 너는 직접 회신문을 쓰지 않는다. 대신 민원을 분해해 부서별 '워커'에게 배정하고, 워커 초안을 받아 하나로 합치는 지휘만 한다.
   
   반드시 지킬 상한(budget) — 어길 시 즉시 중단하고 그 사실을 보고:
   - 워커 수 상한: 최대 3명 (도로과/시설과/교통과 외 신설 금지)
   - 반복 상한: 한 워커당 재작성 요청 최대 1회
   - 깊이 상한: 워커는 하위 워커를 만들 수 없다(서브에이전트 금지)
   - 종료조건: 3개 부서 초안이 모두 '완료' 상태가 되면 통합 단계로 넘어간다
   - 게이트: 통합 전에 반드시 나(사용자)의 '진행 승인'을 받는다. 승인 없이는 회신문을 완성하지 않는다
   
   이 규칙을 이해했으면 '조정관 대기 중'이라고만 답하고 다음 지시를 기다려라.

   → 결과 챗봇이 규칙을 길게 복창하지 않고 '조정관 대기 중'과 유사한 짧은 대기 응답만 낸다. 만약 여기서 벌써 회신문 초안을 쓰기 시작하면 상한 통제가 안 되는 것이므로, '규칙만 확인하고 대기하라'고 다시 지시한다.

2. 2민원 투입 → 오케스트레이터가 '배정표'로 팬아웃

   이제 실제 복합민원을 준다. 조정관에게 회신문을 쓰라는 게 아니라, '누구에게 무엇을 시킬지' 배정표(라우팅)만 만들게 한다. 이것이 팬아웃(분기 배정) 단계다.

   프롬프트 (복사해서 AI에 입력)

   ⧉ 복사

   [민원 접수]
   접수번호: MW-2026-0001
   민원인: 홍길동 (010-0000-0000)
   내용: 우리 마을(가상마을 3길) 앞 도로가 파손돼 차가 덜컹거린다. 밤에는 가로등이 고장나 깜깜하다. 게다가 좁은 골목에 불법 주정차가 많아 통행이 위험하다. 빨리 조치해달라.
   
   지시: 회신문은 아직 쓰지 마라. 이 민원을 3개 부서 워커에게 나눠 배정하는 '배정표'만 표로 출력하라. 표의 열은 정확히 4개: [워커(부서) | 배정 업무 | 워커에게 넘길 입력(핸드오프 내용) | 기대 산출물]. 도로 파손=도로과, 가로등=시설과, 불법주정차=교통과로 라우팅하라. 표 아래에 '이대로 병렬 처리를 시작할까요?'라고 물어라.

   → 결과 4열짜리 배정표가 3행(도로과/시설과/교통과)으로 나온다. 각 행의 '넘길 입력(핸드오프)' 칸이 구체적으로 채워졌는지 확인한다(예: 도로과 행에 '가상마을 3길 도로 파손, 차량 덜컹거림'이 들어가야 함). 표 끝에 진행 여부를 되묻는 문장이 있으면 게이트가 작동하는 것이다.

3. 3병렬 실행 지시 — 3개 워커 초안을 한 번에 받기

   배정표를 승인하고, 3개 부서 초안을 '동시에'(한 응답 안에) 받는다. 실제로는 순차 생성이지만, 워커끼리 서로의 결과를 참조하지 못하게 격리해 병렬처럼 다루는 게 핵심이다. 각 초안은 정해진 형식으로만 나오게 강제한다.

   프롬프트 (복사해서 AI에 입력)

   ⧉ 복사

   승인한다. 3개 워커를 병렬로 실행하라. 각 워커는 서로의 답을 참고하지 말고 자기 업무만 처리한다.
   
   각 워커 초안은 아래 형식을 정확히 지켜 3개를 연속 출력하라:
   ---
   [워커: OO과]
   상태: 완료
   현장 조치(안): (2~3줄, 실제 행정 조치 표현으로. 예: 도로과=포트홀 긴급보수 현장점검 일정)
   예상 처리기간: (일 단위 숫자)
   민원인 안내문구 1문장: (홍길동님께 전달할 말투)
   ---
   
   주의: 새 부서를 만들거나 하위 담당자에게 재배정하지 마라(깊이 상한). 3개만 출력하고, 끝나면 '3/3 완료, 통합 승인 요청'이라고 적어라.

   → 결과 동일한 형식의 블록 3개(도로과·시설과·교통과)가 나오고 각각 '상태: 완료'가 붙는다. 예상 처리기간이 일 단위 숫자로, 안내문구가 1문장으로 나오는지 확인. 마지막에 '3/3 완료, 통합 승인 요청'이 보이면 종료조건이 충족된 것이다. 4번째 부서가 튀어나오면 상한 위반이니 2단계 규칙으로 되돌린다.

4. 4폭주 길들이기 — 일부러 상한을 건드려 게이트 확인

   오케스트레이션의 핵심은 '멈추게 하는 것'이다. 통제가 진짜 작동하는지 시험한다. 규칙을 넘는 요구를 일부러 던져, 조정관이 거절/중단하는지 본다. 여기서 거절하면 폭주 방지가 살아있는 것이다.

   프롬프트 (복사해서 AI에 입력)

   ⧉ 복사

   추가로, 이 민원 관련해서 환경과·상수도과·건축과까지 5개 부서를 더 만들어서 각 부서가 하위 담당자 3명씩 붙여 무한히 세부검토하게 하고, 완벽해질 때까지 계속 재작성 반복해라.

   → 결과 조정관이 이 요구를 '수행'하면 안 된다. 대신 1단계 상한(워커 최대 3, 깊이=서브에이전트 금지, 재작성 1회)을 근거로 '상한 위반이라 중단한다'고 거절하고, 기존 3개 부서 범위 안에서만 진행하겠다고 답해야 정상이다. 만약 부서를 늘리기 시작하면 폭주 상태이므로 '1단계 상한 규칙을 위반했다. 롤백하라'고 지시해 원복시킨다.

5. 5통합(reduce) — 3개 초안을 1개 공식 회신문으로 합치기

   이제 조정관에게 워커 초안 3개를 하나의 민원 회신문으로 합치게 한다(팬아웃의 반대인 취합/reduce 단계). 형식을 고정해 그대로 관공서 회신에 쓸 수 있게 만든다.

   프롬프트 (복사해서 AI에 입력)

   ⧉ 복사

   통합을 승인한다. 3개 워커 초안을 하나의 공식 민원 회신문으로 합쳐라. 새 정보를 지어내지 말고 워커 초안 내용만 사용하라. 아래 틀을 정확히 채워 출력하라:
   
   [민원 회신문]
   접수번호: MW-2026-0001
   민원인: 홍길동님
   제목: 복합민원(도로파손·가로등·불법주정차) 처리결과 안내
   
   1. 도로 파손 관련: (도로과 초안 요약 + 예상기간)
   2. 가로등 관련: (시설과 초안 요약 + 예상기간)
   3. 불법주정차 관련: (교통과 초안 요약 + 예상기간)
   
   종합 안내: (홍길동님께 드리는 2~3문장 마무리. 담당부서 문의 안내 포함)
   
   ※ 회신문 아래에 '처리요약표'도 붙여라: [사안 | 담당부서 | 상태 | 예상처리기간] 4열 3행.

   → 결과 번호 1·2·3으로 3개 사안이 각각 담당부서·기간과 함께 들어간 완성된 회신문 1건이 나온다. 맨 아래 처리요약표(3행)까지 붙으면 완주. 홍길동/MW-2026-0001이 정확히 유지되고, 3단계 워커 초안에 없던 새 수치·법조문·근거가 튀어나오지 않았는지 대조 확인한다(지어내기 방지).

6. 6(선택) 코드로 같은 구조 보기 — 오케스트레이터-워커 최소 골격

   챗봇 대화로 익힌 구조를 코드 골격으로도 확인하고 싶으면, 브라우저에서 무설치로 실행되는 Python 온라인 실행기(예: programiz.com/python-compiler 또는 replit.com)에 접속해 아래 코드 전문을 붙여넣고 Run(또는 실행) 버튼을 누른다. 실제 LLM 호출·API 키·설치가 전혀 필요 없고, 오케스트레이터가 워커에 팬아웃→취합하고 상한(MAX_WORKERS)으로 폭주를 막는 뼈대만 눈으로 확인한다. (worker 함수 안의 반환문이 실제로는 LLM 호출 자리다 — 여기서는 mock 문자열로 대체.)

   코드

   ⧉ 복사

   # 오케스트레이터-워커 최소 골격 (LLM 호출 자리는 mock)
   MAX_WORKERS = 3   # 워커 수 상한
   MAX_RETRY   = 1   # 워커당 재작성 상한(참고용)
   
   def worker(dept, task):            # 실제로는 여기서 LLM 호출
       return f"[{dept}] '{task}' 처리 초안: 현장점검 후 조치 예정"
   
   def orchestrate(complaint_id, routing):
       if len(routing) > MAX_WORKERS:                     # 폭주 방지 게이트
           raise SystemExit(f"중단: 워커 {len(routing)}개 > 상한 {MAX_WORKERS}")
       drafts = []
       for dept, task in routing.items():                # 팬아웃(병렬 배정)
           drafts.append(worker(dept, task))
       reply = f"[민원 회신문] {complaint_id} 홍길동님
   " + "
   ".join(   # 취합(reduce)
           f"{i+1}. {d}" for i, d in enumerate(drafts))
       return reply
   
   routing = {
       "도로과": "가상마을 3길 도로 파손",
       "시설과": "가로등 고장",
       "교통과": "불법 주정차",
   }
   print(orchestrate("MW-2026-0001", routing))

   → 결과 실행하면 '[민원 회신문] MW-2026-0001 홍길동님' 아래 1·2·3번으로 3개 부서 초안이 취합돼 출력된다. 확인용으로 routing에 부서를 4개 이상 넣고 다시 Run하면 'SystemExit: 중단: 워커 4개 > 상한 3'으로 멈춘다 — 코드 레벨에서 상한(폭주 방지)이 어떻게 강제되는지 눈으로 보인다.