서론 (Introduction)

Chapter 6 (Fine-tuning)을 통해 우리는 단일 AI 시스템을 개선하는 데 집중했습니다. 이 장에서는 여러 에이전트(Agents)가 복잡한 작업을 위해 협업하는 멀티 에이전트 (multi-agent) 설계를 소개합니다.

이전의 에이전트 구현 방식은 "하나의 에이전트가 모든 것을 수행"하는 접근 방식을 사용했습니다. 복잡한 작업의 경우, 모든 책임을 단일 에이전트에게 맡기는 데는 한계가 있습니다.

[단일 에이전트 (Single Agent, 이전 방식)]
사용자(User) → 에이전트(Agent) → 도구(Tools) → 답변(Answer)
하나의 에이전트가 모든 결정을 내리고 모든 것을 실행함
...

멀티 에이전트는 다음과 같은 경우에 효과적입니다:

• 작업에 여러 유형의 전문 지식이 필요한 경우
• 병렬 처리 (Parallel processing)를 통해 속도를 높일 수 있는 경우
• 별도의 에이전트가 품질 검사 (Quality checking)를 수행하기를 원하는 경우

2026년 트렌드: Anthropic의 연구에 따르면 멀티 에이전트 아키텍처 (multi-agent architectures)는 작업 완료율을 90% 향상시킵니다. 오케스트레이터 × 워커 (Orchestrator × Worker) 패턴은 프로덕션 표준이 되었습니다.

이 장의 아키텍처 (Architecture for This Chapter)

사용자의 질문 (User's question)
    ↓
[오케스트레이터 (Orchestrator)]
...

디렉토리 구조 (Directory Structure)

pgvector-tutorial/
├── 기존 파일들 (existing files)
└── multiagent/
...

1. 검색 워커 (Search Worker) — multiagent/search_worker.py

pgvector 검색에만 전적으로 집중하는 워커입니다. 단일 책임 (Single responsibility, 검색 전용) 원칙을 통해 프롬프트 (prompt)를 단순하게 유지하고 정확도를 높입니다.

# multiagent/search_worker.py
"""
검색 전문가 워커 (Search specialist worker)
...

2. 품질 검사 워커 (Quality Check Worker) — multiagent/quality_worker.py

답변 품질을 평가하는 데만 전적으로 집중하는 워커입니다.

# multiagent/quality_worker.py
"""
품질 검사 전문가 워커 (Quality check specialist worker)
...

3. 오케스트레이터 (Orchestrator) — multiagent/orchestrator.py

두 워커를 조정하는 지휘 본부입니다.

# multiagent/orchestrator.py
"""
오케스트레이터 (Orchestrator)
...

4. 실행 스크립트 (Execution Script) — 14_multiagent.py

# 14_multiagent.py
import time
import sys
...

5. 실행하기 (Running It)

mkdir multiagent
touch multiagent/__init__.py
python 14_multiagent.py

샘플 출력 (Sample output):

============================================================
Orchestrator 시작됨
질문: ML 평가 지표(ML evaluation metrics)에 대해 자세히 알려줘
...

6. 아키텍처 패턴 비교 (Architecture Pattern Comparison)

패턴	구조	적합한 용도
Orchestrator × Worker (본 장)	1개의 명령 센터 + 다수의 전문가
일반적인 작업 분해 (General task decomposition)
...	...	...

7. 프로덕션 고려 사항 (Production Considerations)

비용 폭발 주의 (Watch out for cost explosions)
오케스트레이터(Orchestrator)가 모든 워커(Worker)로부터 전체 결과물을 받을 때, 컨텍스트 윈도우(Context window)가 급격히 팽창합니다. 워커는 항상 구조화된 JSON 요약본을 반환하도록 설정해야 하며, 전체 텍스트를 그대로 전달해서는 안 됩니다.

단계 제한 설정 (Set step limits)
각 에이전트(Agent)에 항상 max_steps 제한을 설정하여...