Koog 한국어 문서 공부 목차
Koog 문서를 한국어로 하나씩 옮겨 둔 글이 85개까지 쌓였습니다.
그런데 글이 시간순으로 흩어져 있으면 처음 공부하는 입장에서는 “어디서부터 읽어야 하지?”가 먼저 막힙니다.
그래서 이 글은 Koog 시리즈 전체를 공부 순서대로 따라갈 수 있게 만든 목차입니다. 처음 보는 분은 위에서 아래로 읽고, 이미 Koog를 조금 써본 분은 필요한 단계만 골라 읽으면 됩니다.
추천 학습 순서
- 처음에는 1~3단계만 읽어도 Koog의 큰 방향이 잡힙니다.
- 직접 에이전트를 만들려면 4~6단계를 이어서 보면 좋습니다.
- 운영, 추적, 외부 연동이 필요하면 7~11단계가 실전 구간입니다.
- 마지막 12단계는 예제와 보충 자료라서, 필요한 것부터 골라 보면 됩니다.
1단계. 전체 그림 잡기
Koog가 무엇인지, 어떤 기능을 제공하는지, 어떤 용어를 쓰는지 먼저 정리하는 구간입니다.
2단계. 에이전트 기본기
Basic Agent, Graph-based Agent, Functional Agent, Planner Agent까지 에이전트의 형태를 차례로 봅니다.
3단계. 프롬프트와 LLM 실행 흐름
프롬프트 구성, LLM 클라이언트, 실행기, 실패 처리, 응답 캐싱을 묶어서 이해합니다.
4단계. 노드, 그래프, 전략 만들기
Koog의 실행 그래프를 직접 설계하고 커스텀 전략을 만드는 핵심 구간입니다.
5단계. 도구 시스템 익히기
에이전트가 외부 기능을 호출하는 Tools 구조를 익힙니다.
6단계. 기능 확장과 상태 관리
이벤트, 추적, 메모리, 영속성처럼 실제 앱에 가까워질수록 필요한 기능들입니다.
7단계. 관측성과 커스텀 기능
OpenTelemetry와 외부 관측 도구 연동, 커스텀 기능 확장을 다룹니다.
8단계. 외부 프로토콜 연동
MCP, A2A, ACP처럼 에이전트 생태계와 연결되는 프로토콜을 정리합니다.
9단계. 모델 제어와 안전장치
모델 파라미터, 기능 차이, 콘텐츠 모더레이션을 확인합니다.
10단계. 프레임워크 통합
Ktor, Spring Boot, Spring AI와 Koog를 붙이는 방법을 봅니다.
11단계. 런타임·출력·운영 기능
이벤트, 구조화 출력, 스트리밍, 세션, RAG, 직렬화, 테스트까지 운영에 가까운 기능들입니다.
12단계. 마무리와 예제 탐색
왜 Koog인지 정리하고, 다양한 예제와 MCP 클라이언트 구현을 훑어봅니다.
어떻게 공부하면 좋을까
처음부터 모든 글을 완벽히 이해하려고 하기보다, 먼저 1회독으로 용어와 구조를 익히는 편이 좋습니다.
추천 흐름은 이렇습니다.
- 개념 파악: 1~5번 글로 Koog의 목적과 빠른 시작 흐름을 잡습니다.
- 에이전트 구현: 6~12번 글로 에이전트 유형을 비교합니다.
- 실전 구성: 21~30번 글로 그래프와 도구 호출 구조를 만져봅니다.
- 서비스화: 31번 이후의 메모리, 관측성, 프로토콜, 테스트 글을 필요한 순서대로 붙입니다.
- 예제 확인: 마지막 예제 글에서 실제 패턴을 가져와 자기 프로젝트에 맞게 변형합니다.
이 목차는 Koog 시리즈를 계속 공부할 때 기준점으로 쓰기 위한 글입니다. 새 글이나 보정본이 생기면 이 글을 갱신해서 입구 역할을 하도록 유지하겠습니다.