AI 에이전트 마스터 클래스 (기획, 구현, 운영, 배포까지 현업에서 바로 적용하는 에이전트 개발 가이드)

김구현

2019년부터실무및교육현장에서활동중인개발자이자강사입니다.현재포레스트소프트에서‘AI를활용한업무자동화시스템’개발을담당하고있으며,삼성청년SWAI아카데미(SSAFY)에서수년간파이썬/데이터트랙의풀스택개발과알고리즘,그리고인공지능강의를전담하고있습니다.아울러AI파인튜닝,온프레미스AI구축,AI에이전트설계등최신기술을다루는실무특강을진행해왔습니다.화려한기법에치중하기보다현장에서검증된코드와명확한설계원칙을제시하여,독자가AI서비스의전체흐름을꿰뚫어보는설계자로성장할수있도록돕고자합니다.

CHAPTER0개발환경준비하기
_0.1필수API키발급
__0.1.1오픈AIAPI키
__0.1.2크레딧결제수단추가
__0.1.3랭체인허브환경설정
_0.2구글코랩설정
__0.2.1구글드라이브에코랩앱추가하기
__0.2.2코랩동작테스트
_0.3로컬개발환경구축
__0.3.1파이썬설치(3.11버전권장)
__0.3.2GitBash설치
__0.3.3VSCode설치
__0.3.4VSCode환경설정과확장도구설치
__0.3.5VSCode사용방법과터미널설정
_0.4실습파일내려받기

PART1랭체인기초와LCEL로시작하는LLM서비스개발

CHAPTER1AI에서AI에이전트로의진화

CHAPTER2LLM서비스개발을위한프레임워크,LangChain
_2.1WhatisLangChain?
_2.2LLM기반서비스,챗GPT를통해파헤쳐보자
_2.3랭체인적용사례
_2.4랭체인작동원리:‘체인’
_2.5랭체인학습을위한참고자료
_2.6핵심요약

CHAPTER3체인을구현하는기초문법,LCEL
_3.1LCEL기초문법이해
__3.1.1LCEL체인의구축및실행
_3.2LCEL구축시주의사항
__3.2.1다중입력변수처리및KeyError
__3.2.2체인구성순서및ValueError
_3.3결합된체인구축
_3.4프롬프트
__3.4.1PromptTemplate.from_template()
__3.4.2PromptTemplate
__3.4.3ChatPromptTemplate
_3.5모델
_3.6출력파서
__3.6.1CommaSeparatedOutputParser
__3.6.2JsonOutputParser
_3.7랭체인허브
__3.7.1랭스미스
__3.7.2프롬프트개선
_3.8핵심요약

CHAPTER4체인의구조를고도화하기,Runnable
_4.1RunnableParallel
_4.2RunnableLambda
_4.3RunnablePassthrough
_4.4핵심요약

CHAPTER5GPT에게기억력을심어주자,Memory
_5.1대화기록관리하기
__5.1.1ChatMessageHistory
__5.1.2MessagesPlaceholder
_5.2Runnable활용
__5.2.1RunnableWithMessageHistory기본
__5.2.2사용자별대화관리
_5.3핵심요약

CHAPTER6랭체인챗봇을서비스로구현하기,Streamlit
_6.1Streamlit
__6.1.1개발환경설정
__6.1.2텍스트요소
__6.1.3데이터와차트요소
__6.1.4레이아웃과내비게이션요소
__6.1.5위젯요소
__6.1.6챗요소
__6.1.7세션상태
_6.2Streamlit과랭체인을활용한범용챗봇개발
__6.2.1사전준비
__6.2.2전체시스템아키텍처및개발프로세스
__6.2.3환경구성
__6.2.4기본페이지뼈대구성과내비게이션구성
__6.2.5주요기능구현
__6.2.6테스트

PART2에이전트와MCP로실전서비스구축

CHAPTER7스스로판단하고행동하는AI요원,Agent
_7.1도구이해하기
__7.1.1가장단순한도구만들기
__7.1.2도구메타데이터다듬기
__7.1.3Pydantic스키마로구조화된입력받기
_7.2에이전트첫걸음
__7.2.1단일에이전트생성하기
__7.2.2도구를활용하는에이전트생성하기
_7.3ReAct패턴이해하기
__7.3.1ReAct란?
__7.3.2ReAct과정관찰하기
_7.4외부도구사용하기
__7.4.1YouTubeSearchTool
_7.5핵심요약

CHAPTER8에이전트에게지식선물하기,RAG
_8.1RAG개념이해하기
__8.1.1RAG란?
__8.1.2벡터임베딩이란?
__8.1.3벡터저장소
_8.2파일로드및청킹
__8.2.1환경설정
__8.2.2파일로더로문서불러오기
__8.2.3문서청킹하기
_8.3메타데이터로데이터구분하기
__8.3.1메타데이터추가
_8.4임베딩모델이해하기
__8.4.1임베딩모델이란?
__8.4.2오픈AI임베딩모델설정하기
_8.5Chroma벡터저장소만들고저장하기
__8.5.1왜Chroma를선택했는가?
__8.5.2Chroma벡터DB생성및저장
_8.6벡터저장소에서검색하기
__8.6.1저장된벡터저장소불러오기와Retriever객체생성
__8.6.2유사도검색과Top-k의중요성
__8.6.3메타데이터필터로검색하기
__8.6.4MMR검색으로답변의다양성확보
_8.7RAG에이전트만들기
__8.7.1검색Tool만들기
_8.8핵심요약

CHAPTER9에이전트와의대화상태유지하기,CheckPointer
_9.1랭그래프와메모리
__9.1.1왜체인이아니라그래프인가?
__9.1.2랭그래프의핵심구성요소와메모리시스템
__9.1.3RunnableWithMessageHistoryvs.체크포인터
_9.2체크포인터설정
__9.2.1InMemorySaver로메모리구현하기
__9.2.2SqliteSaver로메모리영구화하기
_9.3장기기억을위한메모리최적화
__9.3.1SummarizationMiddleware로대화요약하기
_9.4핵심요약

CHAPTER10도구의표준화,MCP
_10.1MCP란무엇인가?
__10.1.1MCP의기본개념
__10.1.2왜MCP가필요한가?
_10.2FastMCP로간단한서버만들기
__10.2.1파일관리서버만들기
_10.3MCP서버연결및에이전트활용
__10.3.1MCP서버의도구를에이전트에불러오기
_10.4외부MCP서버연결하기
__10.4.1외부서버설치하기
__10.4.2외부서버사용하기
_10.5핵심요약

CHAPTER11똑똑한와인소믈리에챗봇만들기,Project
_11.1서비스기획및아키텍처
__11.1.1시스템아키텍처
__11.1.2프로젝트폴더구조
__11.1.3데이터셋준비
_11.2프로젝트환경및기본UI구성
__11.2.1프로젝트생성및환경설정
__11.2.2Streamlit기본구조만들기
_11.3랭체인에이전트설계
__11.3.1에이전트설정분리
__11.3.2에이전트생성기작성
__11.3.3에이전트동작확인및UI연결
_11.4하이브리드지식저장소구축
__11.4.1데이터전처리및벡터스토어생성코드작성
_11.5MCP서버를통한도구확장
__11.5.1파일관리서버
__11.5.2RAG서버
__11.5.3영상검색도구추가
_11.6핵심요약

단순한튜토리얼을넘어,‘운영가능한AI에이전트’로
이책은생성형AI와AI에이전트의개념을단순히설명하거나단편적인예제를나열하는데그치지않습니다.랭체인,RAG,MCP와같은개별기술이실제서비스환경에서어떻게유기적으로연결되어작동하는지그전체적인흐름과구조를체계적으로정리했습니다.
특히실무에서AI서비스를설계할때직면하게되는토큰관리와최적화,랭그래프기반의지속적인대화이력관리,그리고에이전트의효율적인도구선택기준을깊이있게다룹니다.나아가RAG기술을활용한내부지식확장과표준프로토콜인MCP를통한외부시스템연동까지,에이전트개발의전과정을실습중심으로상세히풀었습니다.
도서의마지막부분에서는실전프로젝트인‘와인추천에이전트’를기획부터구현,웹배포까지직접수행해봅니다.이과정을통해독자는단순한기능을구현해보는수준을넘어,실제비즈니스현장에서동작하는완성도높은AI프로젝트를완수하는경험을얻게될것입니다.
단순히AI를이용하는것을넘어,하나의견고하고지속가능한지능형시스템으로구축하고자하는모든개발자와기술리더들에게이책이명확한가이드가되어줄것입니다.

대상독자
● 단순챗봇을넘어,실제업무를수행하는AI에이전트서비스를구현해보고싶은실무엔지니어
● 파이썬기초문법과LLM활용경험은있으나,이를서비스구조로확장하는데어려움을느끼는개발자
● RAG,에이전트,MCP등개별기술은알고있으나,이들을하나의시스템으로설계하는기준이필요한독자
● AI기능을PoC수준이아닌,운영가능한서비스로발전시키고자하는개발자및기술담당자
● AI기반서비스도입과구조설계를검토해야하는기술리더,테크리드,프로덕트매니저