전체 24장 지도 — 일곱 단계로 쌓아 올린다

한 줄 요약

이 과정은 빈 폴더에서 시작해 브라우저에서 동작하는 멀티에이전트 상담 서비스까지를 일곱 단계(STEP)로 쌓아 올립니다. 각 단계는 바로 앞 단계의 결과물 위에 올라갑니다.

1. 일곱 단계

STEP 1. 프로젝트 정의 — 무엇을 자동화할 것인가 (1~2장)

무엇을 왜 만드는지 정하고(1장), 실습 환경을 세팅해 LLM을 처음 호출합니다(2장).

끝나면 — 내 컴퓨터의 haru-market 폴더에서 Gemini에게 질문하고 답을 받습니다.

STEP 2. 상담 품질 — 우리 쇼핑몰처럼 답하게 만들기 (3~4장)

LLM이 하루마켓 상담원의 말투와 규칙으로 답하게 만들고(3장), 문의를 여섯 유형으로 분류하게 합니다(4장).

왜 먼저 하나 — 에이전트의 판단은 결국 LLM이 합니다. 두뇌를 다루지 못하면 도구를 달아도 엉뚱하게 씁니다.

STEP 3. 사내 데이터 연결 — 실시간 조회에 답하기 (5~8장)

LLM이 함수를 부르게 만드는 원리를 보고(5장), 실제 주문 데이터에 연결하고(6장), 도구를 여러 개로 늘리고(7장), 본인 확인과 개인정보 보호를 넣습니다(8장).

끝나면 — "제 주문 어디까지 왔어요?"에 실제 주문 데이터를 조회해서 답합니다.

STEP 4. 에이전트 루프 — 스스로 판단하고 반복하게 만들기 (9~11장)

"생각 → 행동 → 관찰"의 반복을 직접 만들고(9장), 무한 반복과 비용에 안전장치를 걸고(10장), 같은 것을 프레임워크로 다시 만들어 봅니다(11장).

끝나면 — 한 번의 조회로 안 끝나는 문의를 끝날 때까지 처리합니다.

STEP 5. 정책 지식(RAG) — 환불 규정대로 답하게 만들기 (12~15장)

정책 문서를 읽어 잘게 나누고(12장), 의미로 검색할 수 있게 저장하고(13장), 찾은 조항을 근거로 답하게 하고(14장), 검색 품질을 끌어올립니다(15장).

끝나면 — "불량품 반품 배송비는 누가 내요?"에 정책 조항을 근거로 답합니다.

STEP 6. 기억 — 대화를 이어가게 만들기 (16~17장)

대화 이력을 관리해 "그거"를 이해하게 하고(16장), 긴 대화를 요약하고 고객 정보를 다음 방문까지 기억하게 합니다(17장).

끝나면 — 두 번째 질문이 첫 번째 질문 위에서 이어집니다.

STEP 7. 오케스트레이션 — 여러 에이전트가 협업하게 만들기 (18~24장)

상담 흐름을 그래프로 그리고(18장), 문의마다 길을 가르고(19장), 복합 문의를 쪼개 처리하고(20장), 전문 에이전트 셋과 처리 도구를 만들고(21장), Supervisor가 이들을 지휘하게 하고(22장), 환불·주문 취소를 사람이 승인하게 하고(23장), 전부 합쳐 채팅 화면과 상담원 화면이 있는 서비스로 만듭니다(24장).

끝나면 — 1장에서 본 그 채팅 화면이 내 컴퓨터에서 동작합니다. 교환을 접수하면 처리번호가 나오고, 주문 취소를 요청하면 상담원 화면에 승인 대기가 뜹니다.

2. 한눈에 보는 표

STEP	무엇을 붙이나	장	끝나면 할 수 있는 것
1	프로젝트 정의·환경	1~2	LLM을 호출한다
2	프롬프트·분류	3~4	우리 쇼핑몰 말투로 답하고 문의를 분류한다
3	도구	5~8	실제 데이터를 조회해 답한다
4	루프·가드레일	9~11	끝날 때까지 스스로 반복한다
5	지식(RAG)	12~15	정책 문서를 근거로 답한다
6	기억	16~17	대화를 이어 간다
7	오케스트레이션	18~24	여러 에이전트가 협업해 요청을 처리하는 서비스가 된다

STEP 7의 뒤쪽 네 장은 이렇게 나뉩니다.

장	만드는 것
21	전문 에이전트 셋(주문조회, 정책안내, 요청처리)과 처리 도구(배송지 변경, 교환 접수, 환불 승인 요청)
22	세 에이전트를 지휘하는 Supervisor
23	환불·주문 취소를 사람이 승인하는 길
24	채팅 화면과 상담원 화면(승인 대기, 처리 내역, 넘겨받은 문의)이 있는 서버

3. 각 장은 이렇게 진행합니다

3장부터 모든 장은 같은 순서로 되어 있습니다.

왜 필요한가 — 지금 시스템에 무엇이 부족한지, 이걸 모르면 무엇을 판단하지 못하는지.
개념 — 이번 장의 핵심 개념을 그림과 표로.
따라하기 — 프로젝트 폴더에 파일을 만들고, 코드 전체를 복사해 붙여 넣고, 실행합니다. 그리고 결과에서 무엇을 봐야 하는지 짚습니다.
정리와 체크리스트 — 말로 설명할 수 있는지 스스로 점검합니다.
실습문제와 해답 — 코드를 조금 고쳐 보며 손에 익힙니다.

따라하기에서 부탁드리는 것 한 가지. 실행하기 전에 "어떤 결과가 나올지" 먼저 짐작해 보세요. 짐작과 결과가 다를 때가 가장 많이 배우는 순간입니다. 그리고 LLM의 답은 실행할 때마다 조금씩 달라집니다. 교재에 실린 결과와 글자가 똑같지 않아도 정상입니다. 봐야 할 것은 문장이 아니라 동작입니다.

4. 이 과정을 마치면 남는 것

남는 것	내용
개념	에이전트, 도구 호출(Function Calling), RAG, 메모리, 멀티에이전트 오케스트레이션을 구조로 설명할 수 있습니다
판단 기준	"이 일에 에이전트가 필요한가, 멀티에이전트는 과한가"를 비용과 정확도로 따질 수 있습니다
결과물	내 컴퓨터에서 동작하는, 요청을 직접 처리하는 멀티에이전트 고객지원 서비스와 그 코드 전체

핵심 정리

과정은 정의 → 상담 품질 → 도구 → 루프 → 지식 → 기억 → 오케스트레이션의 일곱 단계입니다.
각 단계는 앞 단계의 결과물 위에 올라갑니다. 순서대로 따라오면 "왜 지금 이게 필요한지"가 이어집니다.
3장부터는 파일 만들기 → 코드 붙여 넣기 → 실행 → 관찰을 반복합니다.
결과는 실행마다 조금씩 다릅니다. 문장이 아니라 동작을 봅니다.