핵심 아키텍처 패턴

오케스트레이션 패턴은 "어떤 일을 누가 언제 수행하는가"를 정하는 청사진입니다. 대부분의 시스템은 패턴 하나만 쓰지 않고 기본 패턴 2~3개를 조합해 만듭니다.

7가지 핵심 패턴

패턴 선택 기준

조합 예시

실전에서는 routing -> parallel research -> evaluator -> approval처럼 조합하는 경우가 많습니다. 패턴 선택에서 정작 중요한 건 "무엇이 주 패턴인가"보다 통제 포인트를 어디에 둘 것인가입니다.

패턴별 상세 메모

Routing

• 분류 실패 비용이 큰 경우, semantic routing만 믿지 말고 rule-based pre-filter를 먼저 둡니다.
• "어느 agent를 부를까"만이 아니라 "사람에게 넘길까"까지 라우팅 범위에 포함합니다.

Parallelization

• 병렬 step는 서로 독립적이어야 합니다.
• 결과 통합 단계에서 근거 출처와 신뢰도를 함께 병합해야 품질이 올라갑니다.

Pipeline

• 단계별 출력 계약이 명확할수록 안정적입니다.
• 앞 단계가 불안정하면 downstream의 정교함은 의미가 없습니다.

Orchestrator-Workers

• worker는 폭넓은 능력보다 좁은 책임을 가져야 합니다.
• orchestrator가 직접 모든 tool을 가지면 worker 분리의 의미가 사라집니다.

Evaluator-Optimizer

• 평가 기준이 텍스트 설명만 있으면 반복 루프가 흔들립니다.
• pass/fail 기준, 스코어, 수정 지시를 구조화해야 합니다.
• 종료 조건을 반드시 정의합니다: max iteration, 최소 점수 도달, 또는 개선 정체 감지.

Hierarchical

• 상위 agent는 모든 세부 실행을 알 필요가 없습니다.
• 목표와 제약만 하위에 넘기고, 구현 세부는 worker에 위임하는 편이 유지보수에 유리합니다.

DAG

• fan-out/fan-in, 조건 분기, 부분 재실행이 필요한 장기 workflow에 적합합니다.
• 그래프가 커질수록 시각화와 trace가 없으면 운영이 급격히 어려워집니다.

안티패턴

2026 프로덕션 오케스트레이션 패턴

2026년 3월 기준 프로덕션 환경에서 자주 보이는 주요 패턴 5가지를 정리합니다.

Swarm 패턴

• agent가 작업을 자율적으로 선택하고 다른 agent에 handoff합니다.
• 탐색적 리서치나 창의적 작업에 적합하지만, 결과 예측성이 낮아 프로덕션에서는 제한적으로 사용됩니다.
• 가드레일: 반드시 max iteration과 비용 한도를 설정해야 합니다.

Mesh 패턴

• 중앙 오케스트레이터 없이 agent가 peer-to-peer로 통신합니다.
• 각 agent가 전문 도메인을 담당하고, 필요할 때 다른 전문가를 호출합니다.
• A2A v1.0.0의 Agent Card가 mesh 패턴의 discovery 문제를 해결합니다.

하이브리드 패턴

실전에서는 단일 패턴보다 하이브리드 조합이 일반적입니다.

빠른 선택 가이드

• FAQ, 간단한 조회 자동화: 단일 agent + tool loop
• 고객 지원 triage: routing + retrieval + approval
• 코드 수정 자동화: pipeline + evaluator + human gate
• 리서치/시장 조사: parallelization + aggregator
• 장기 승인 프로세스: DAG workflow + checkpoint + resume

최소 구현 스켈레톤

type RequestKind = 'faq' | 'research' | 'execution'

async function orchestrate(input: string) {
  const kind: RequestKind = await route(input)

  if (kind === 'faq') {
    return runSingleAgent(input)
  }

  if (kind === 'research') {
    const evidence = await Promise.all([
      runWorker('market-research', input),
      runWorker('docs-research', input),
    ])

    return evaluateAndMerge(evidence)
  }

  const plan = await buildPlan(input)
  const result = await runPipeline(plan)
  return evaluateAndApprove(result)
}

이 스켈레톤에서 핵심은 패턴 이름이 아니라 route -> execute -> evaluate -> approve 같은 통제 지점을 코드에 명확히 드러내는 것입니다.

ADR 스타일 결론

실무 체크리스트

• 현재 문제를 설명할 때 주 패턴을 한 문장으로 말할 수 있는가
• 각 패턴 추가가 지연, 비용, 품질에 미치는 영향을 설명할 수 있는가
• fan-out 이후 fan-in 스키마가 정의되어 있는가
• 평가 루프의 종료 조건이 있는가
• 사람이 개입해야 하는 지점을 패턴 수준에서 모델링했는가

다음에 읽을 장

• 에이전트 설계 원칙
• 라우팅과 디스패치
• 에러 처리와 복구 전략