프롬프트 몇 줄만으로는 부족하다,

코드로 통제하는 AI 에이전트를 만들 차례!

이 책은 ReAct 패턴을 프레임워크 없이 직접 구현하는 것부터 시작해, 모델을 코드로 감싸고 통제하는 ‘하네스 엔지니어링’으로 에이전트를 설계합니다. 툴 사용, 단기·장기 메모리, 컨텍스트 엔지니어링, RAG, 랭그래프 워크플로, 멀티 에이전트 오케스트레이션까지 하나씩 직접 구현하며 원리를 익힙니다.

매일 아침 시장 브리핑을 전송하는 정보 워크플로 에이전트, 스스로 에러를 고치는 자기수정 데이터 분석가, 카메라로 방을 보고 물건을 옮기는 멀티모달 집사 로봇까지, 서로 다른 도메인의 실전 프로젝트 3개를 처음부터 끝까지 완성합니다. 여기서 멈추지 않습니다. 프롬프트 인젝션과 위험한 실행을 막는 보안 가드레일, 비용과 데이터 보안을 고려한 vLLM 기반 로컬 서빙, FastAPI와 AWS Lambda를 활용한 배포, 랭스미스 기반 관측성과 비용 모니터링까지 다룹니다. 잘 작동하는 데모를 넘어, 실제로 일하고 운영할 수 있는 AI 에이전트를 완성해 보세요.

• • ReAct 패턴을 프레임워크 없이 직접 구현하며 원리부터 이해하는 AI 프로젝트
• • 모델을 코드로 통제하는 ‘하네스’ 개념으로 설계하는 안정적인 에이전트
• • 툴 사용, 단기·장기 메모리, 컨텍스트 엔지니어링, RAG, 랭그래프 워크플로
• • 보안 가드레일, vLLM 로컬 서빙으로 비용 절감, FastAPI·AWS Lambda 배포와 랭스미스 운영 모니터링까지

PART 1 에이전트의 핵심 원리

CHAPTER 1 AI 에이전트의 시대

1.1 챗봇, RAG, 에이전트

1.2 에이전트 도입에 적합한 문제

1.3 에이전트의 동작 원리 ReAct

1.4 핵심 구성 요소 LLM, 메모리, 툴

1.5 하네스 엔지니어링

1.6 클로드 코드의 클라이언트 구조

1.7 실습을 위한 준비: 에이전트 개발 환경 구성

CHAPTER 2 툴 사용

2.1 툴 사용의 요청·실행·결과 전달 흐름

2.2 날씨 API를 호출하는 첫 번째 에이전트

2.3 여러 툴을 조합하는 멀티 툴 에이전트

2.4 툴 설계 가이드라인과 스키마 작성법

2.5 MCP vs CLI: 툴을 사용하는 두 가지 방식

2.6 자주 발생하는 오류와 해결 방법

CHAPTER 3 ReAct 패턴 구현

3.1 ReAct 루프 이해

3.2 툴 사용 기반 ReAct 에이전트 구현

3.3 툴 사용 없이 JSON으로 구현하는 ReAct

3.4 랭그래프 기반 ReAct 에이전트 구현

3.5 무한 루프 방지와 탈출 조건 설정

CHAPTER 4 메모리 시스템 구축

4.1 메모리

4.2 단기 메모리: 대화 목록 관리

4.3 요약 메모리 구현

4.4 벡터 DB 기반 장기 메모리 에이전트

4.5 메모리 압축 전략

4.6 체크포인터를 이용한 상태 저장

CHAPTER 5 컨텍스트와 하네스 엔지니어링

5.1 에이전트 컨텍스트의 구성과 관리

5.2 하네스 엔지니어링의 개념과 필요성

5.3 입력 검증: 전처리

5.4 구조화된 출력: 신뢰할 수 있는 응답

5.5 가드레일

5.6 클로드 코드 유출로 본 하네스

5.7 하네스 위치를 결정하는 일반적인 기준

PART 2 에이전트 확장하기

CHAPTER 6 RAG + 에이전트 결합

6.1 외부 지식과 최신 정보를 위한 RAG

6.2 튜토리얼: RAG 파이프라인 구축

6.3 RAG 품질 개선 방법

6.4 튜토리얼: 에이전틱 RAG 구현

6.5 그래프 RAG: 구조화된 청킹과 온톨로지

6.6 하이브리드 RAG

CHAPTER 7 랭그래프 기반 에이전트 워크플로

7.1 랭체인과 랭그래프의 역할

7.2 StateGraph 기반 워크플로 구축

7.3 조건부 라우팅과 툴 통합

7.4 휴먼 인 더 루프: 실행 전 사용자 승인

7.5 스트리밍: 실시간 진행 상황 모니터링

7.6 상태 확장: 커스텀 필드 추가

CHAPTER 8 멀티 에이전트 오케스트레이션

8.1 멀티 에이전트의 상태 관리

8.2 슈퍼바이저 패턴

8.3 핸드오프 패턴

8.4 계층형 패턴

8.5 안전한 상태 관리

PART 3 실전 프로젝트

CHAPTER 9 프로젝트: 출근하는 증권맨(정보 워크플로 에이전트)

9.1 시나리오 작성

9.2 설계: 지표 수집 → 종목 점검 → 뉴스 수집 → 브리핑 작성 → 전송

9.3 성공, 실패 기준 정의

9.4 툴 준비: 시장 데이터, 뉴스, 포맷터, 카카오톡/슬랙

9.5 랭그래프 상태 그래프 구축과 노드별 구현

9.6 실행과 디버깅: 데이터 누락, API 실패, 빈 결과를 다루는 법

9.7 운영: 매일 아침 자동 실행과 알림 채널 연동

9.8 평가: 로그 분석으로 보는 브리핑 품질과 개선 지점

9.9 전체 코드와 확장 아이디어

CHAPTER 10 프로젝트: 끈질긴 주니어 데이터 분석가(자기수정 에이전트)

10.1 시나리오 작성

10.2 설계: 생성 → 실행 → 해석 → 자기수정으로 종료되는 루프

10.3 데이터/실행 환경: DuckDB와 영속 커널

10.4 계층별 자기수정 구현

10.5 휴먼 인 더 루프: 위험한 작업 전 사용자 승인 게이트

10.6 날씨 API를 활용한 분석 보강

10.7 랭그래프 통합과 실행

10.8 평가: 정확도, 재시도 횟수, 첫 시도 성공률

10.9 전체 코드와 확장 아이디어

CHAPTER 11 프로젝트: 부탁을 듣는 집사 로봇(멀티모달 에이전트)

11.1 시나리오

11.2 설계: 비전 인지 → 계획 → 행동 → 재인지 루프

11.3 사전 준비

11.4 헤드리스 렌더링과 스모크 테스트

11.5 Space와 Action: 로봇의 공간·행동 정의

11.6 Perception: VLM 입력을 위한 카메라 이미지 최적화

11.7 Planner와 Executor: 명령 분해와 액션 실행

11.8 랭그래프 통합: 인지·계획·행동 루프와 종료 조건

11.9 실행 시나리오: 단순 명령에서 복합/모호한 명령으로

11.10 실패와 복구: 객체 미발견, 물리 실패, 계획 오류 대응

11.11 평가: 작업 성공률, 단계 효율, 복구 횟수

11.12 전체 코드와 확장 아이디어

PART 4 프로덕션과 운영

CHAPTER 12 하네스 보안: 안전성과 가드레일

12.1 웹 보안과 다른 에이전트 보안의 공격면

12.2 프롬프트 인젝션 방어(LLM01)

12.3 입출력 검증 레이어 설계(LLM02/LLM05)

12.4 실행 차단 및 예외 처리(LLM06)

12.5 샌드박스 런타임 격리(LLM10)

12.6 통합: 가드레일을 갖춘 에이전트

CHAPTER 13 비용과 보안을 위한 오픈소스 LLM 서빙

13.1 상용 API의 한계: 비용 폭탄과 데이터 유출

13.2 vLLM 아키텍처와 PagedAttention 원리

13.3 튜토리얼: RTX 3090 기반 Qwen2.5·Llama 3.1 서빙

13.4 API 호환성을 활용한 로컬 에이전트 전환

13.5 에이전트 속도 극대화를 위한 프리픽스 캐싱 활성화

CHAPTER 14 배포와 운영

14.1 요청형 에이전트 서비스 배포의 필요성

14.2 FastAPI로 에이전트 API 서버 구축

14.3 튜토리얼: AWS Lambda 서버리스 배포

14.4 관측성과 비용 모니터링

마치면서

찾아보기