# Lesson 14 Multi Agent Design > AI 에이전트 강의 패키지의 14강 (심화 트랙 7, 심화 트랙 마지막) — 비개발자가 2~3개 에이전트가 협력하는 워크플로우를 설계하고, 본인 작업의 멀티에이전트 또는 가상 시나리오로 시연할 때 사용하는 30분 대화형 강의. 역할 분담 패턴(라우터/계층/병렬) / 의사소통 프로토콜 / 실패 처리를 한 청크씩 익힌다. 사용자가 "14강 시작", "멀티에이전트", "에이전트 협력", "여러 에이전트", "에이전트 여러 개 같이 일하게", "여러 에이전트 같이 시키고 싶어요", "에이전트 오케스트레이션", "라우터 패턴", "에이전트 워크플로우" 같은 표현을 쓰거나, 13강 끝난 후 자연스럽게 이어지는 강의에 진입하려 할 때 반드시 이 스킬을 사용한다. 심화 트랙의 마지막 강의로, 종료 시 캡스톤(15강) 진입을 안내한다. 단순 멀티에이전트 설명이 아니라, 한 청크씩 게임처럼 진행되는 30분짜리 가이드형 학습 흐름이라는 점이 핵심이다. - Skill: `matthewoong/lesson-14-multi-agent-design` (Agent Skill, multi-file: 11 files) - Install (CLI): `npx skillmds@latest add matthewoong/lesson-14-multi-agent-design` - Raw SKILL.md: https://api.skillmd.com/api/skills/matthewoong/lesson-14-multi-agent-design/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - Author: Matthewoong (https://skillmd.com/u/matthewoong) - Updated: 2026-09-22 - Page: https://skillmd.com/skills/matthewoong/lesson-14-multi-agent-design --- # Lesson 14 — 멀티에이전트 설계 (심화 트랙 마지막) > 학습자가 끝나면 2~3개 에이전트가 협력하는 워크플로우를 설계하고 시연한다. 심화 트랙의 마지막 강의입니다. 종료 시 *캡스톤(15강) 진입* 안내가 추가됩니다. --- ## 0. 시작하기 전에 공통 5개 문서 참조. --- ## 1. 진입 시 행동 공통 패턴 + "심화 트랙 마지막 강의예요. 끝까지 가시면 캡스톤이 기다리고 있어요!" 격려. `progress["14-multi-agent-design"]`. 헤더 `📘 [Lesson 14 · 청크 X/Y]`. --- ## 2. 진도 갱신 + draft 키 명세 | 시점 | 갱신 | |---|---| | 14강 첫 진입 | `status = "in_progress"`, `current_chunk = 1` | | 청크 통과 | `current_chunk += 1` | | 청크 3 답변 | `draft.agents_roles = [<역할 정의>]` | | 청크 4 답변 | `draft.communication_protocol = <메시지 형식·전달 방식>` | | 청크 5 답변 | `draft.failure_handling = <실패 처리 규칙>` | | 실습 통과 | `practice_status = "done"`, `status = "completed"` | ### 14강이 사용하는 `draft` 키 | 키 | 시점 | 형식 | |---|---|---| | `agents_roles` | 청크 3 | array (각 에이전트의 역할) | | `communication_protocol` | 청크 4 | string | | `failure_handling` | 청크 5 | string | --- ## 3. 이론 lesson 흐름 청크 8개. ### 14강에서 *왜* 한 청크씩 가는가 멀티에이전트 설계는 *시스템 사고*가 필요합니다. 한 번에 "라우터 패턴 쓰세요"라고 답을 주면 *왜*가 빠져요. 한 청크씩 *문제 → 패턴 → 적용 → 다음*으로 가야 본인 워크플로우에 맞는 패턴을 *선택*할 수 있습니다. --- ## 4. 가이드 실습 — 옵션 2개 인라인 ### 4-0. 진입 시 draft 정리 ``` 🎉 이론 끝! 이제 멀티에이전트 워크플로우를 시연해볼 시간이에요. 📝 에이전트 역할들: - - 📝 의사소통 프로토콜: 📝 실패 처리: ``` ### 4-1. 옵션 제시 ``` 어떤 워크플로우로 시연하시겠어요? (1) {{name}}님 본인 작업의 멀티에이전트 설계 (2) 가상 시나리오 — 예: "리서치 → 작성 → 검토" 3에이전트 번호로 답해주세요. ``` ### 4-2. 가이드 흐름 도구별 멀티에이전트 호출 방식 안내 + 시연 → 실패 시뮬레이션 (의도적으로 한 에이전트가 실패) → 처리 확인. ### 4-3. 검증 기준 | 항목 | 통과 기준 | |---|---| | 역할 *2개 이상*이 *서로 다른 책임* | ✅ | | 의사소통 형식이 *명시적* (JSON, 텍스트 등) | ✅ | | 실패 처리가 *적어도 1가지* 케이스 다룸 | ✅ | 3개 중 2개 이상 ✅. --- ## 5~7. (공통) 종료 시 **🎯 캡스톤(15강) 진입 분기 안내**: ``` 🎉 심화 트랙 완주 축하드려요, {{name}}님! 이제 마지막 캡스톤이 기다리고 있어요. 지금까지 만든 모든 요소를 본인의 진짜 작업 환경에 통합한 *하네스*를 완성합니다. (1) 캡스톤(15강) 시작 (2) 메뉴로 — 천천히 갈래요 (3) 종료 ``` --- ## 8. 강의 작성자 메타 - **트랙**: 심화 7강 (심화 트랙 마지막) - **선행**: 기초 1~7강 + 심화 8~13강 (권장) - **분량**: 약 30분 - **외부 자료**: 도구별 멀티에이전트 기능 - **비용**: 부분적 - **학습 목표**: - 역할 분담 패턴 3가지(라우터/계층/병렬)를 안다 - 본인 워크플로우에 패턴 1개를 적용 - 의사소통과 실패 처리를 *명시적*으로 정의 - **다음 강의**: 15-build-your-own-harness (🎯 캡스톤) --- ## 9. 빠른 자기 점검 - [ ] 학습자 프로필 읽음 - [ ] `📘 [Lesson 14 · 청크 X/Y]` - [ ] 한 청크만, 끝에 ❓/🛠/🔀 - [ ] 자리표시자 채움 - [ ] 도구명 노출 X - [ ] 시도 전 답 X - [ ] `progress["14-multi-agent-design"]` 갱신 - [ ] 14강 추가: 종료 시 캡스톤 진입 안내를 빼먹지 않았는가