그래프 엔지니어링

쾨니히스베르크의 다리에서 에이전트 하네스까지
지식 그래프와 에이전트 그래프, 두 트랙을 하나의 백본으로

리프 메타 (leaf meta)

 

_{한국어 | English  |  최신 판은 릴리즈 목록에서 확인하세요 | 현재 판 v2026.08.02 | 2026년 8월 2일}

---

라이선스

이 책은 크리에이티브 커먼즈 저작자표시 4.0 국제 (CC BY 4.0) 로 배포합니다. 자세한 내용은 LICENSE에 있습니다.

---

목차

본문 35장, 부록 6편. 8부로 나뉩니다. 1부와 2부를 지나면 트랙 1(지식 그래프) 과 트랙 2(에이전트 그래프) 로 갈라졌다가 5부에서 다시 합칩니다. 급하면 2부부터 읽어도 되고, 에이전트만 필요하면 4부로 바로 가도 막히지 않게 썼습니다.

제목을 누르면 그 장의 요약 페이지로 갑니다. 절 목록, 한 장 요약, 키워드별 1차 출처, 예제 실행법이 한 쪽에 들어 있습니다. PDF를 내려받기 전에 어느 장이 지금 필요한지 고르는 데 쓰세요.

같은 페이지의 영어판은 content_en/에 있습니다. 예제 코드는 언어별로 복사하지 않았습니다. 코드는 한 벌이고 content/에 있습니다.

1부 - 뿌리: 그래프는 어디에 있었나

초기 AI는 그래프였습니다. 딥러닝이 그걸 벡터로 녹여 버렸고, LLM 에이전트 시대에 와서 우리는 다시 그래프를 그리고 있습니다. 그 60년과 최근 2년을 압축합니다.

2부 - 그래프의 기초 문법

노드와 엣지와 속성부터 순회, 중심성, 쿼리 언어까지. 두 트랙 어디로 가든 여기를 밟고 갑니다.

3부 - 지식 그래프 엔지니어링 (트랙 1)

모델이 무엇을 아는가. 온톨로지 설계부터 트리플 추출, 시간성, 하이브리드 검색까지.

4부 - 에이전트 그래프 엔지니어링 (트랙 2)

모델이 무엇을 하는가. 이 분야는 아직 자리를 잡는 중이라, 어디까지가 검증된 사실이고 어디부터가 추정인지 문장으로 구분해 뒀습니다.

5부 - 두 그래프가 만나는 곳

두 트랙이 합류하는 지점. 이 책의 클라이맥스입니다.

6부 - 백본: 상태 관리 엔진

책의 심장. 전부 실제 코드와 그림으로 갑니다.

7부 - 운영

8부 - 미래

부록

용어집(한글-영문), 전체 참고 링크, Cypher와 SPARQL과 GQL 대조 치트시트, 엔진 비교 표, 예제 코드 실행 가이드, 연습문제 해답 색인

---

출처

📎 출처 링크 모음 - SOURCES.md | English

본문에 쓰지 않은 자료는 바깥 읽을거리에 따로 모았습니다. 논문, 교과서, 강의, 엔진, 공개 데이터, 그리고 빅테크가 같은 문제를 어떻게 풀었는지까지 106개를 표로만 정리했고 관련 장을 붙여 뒀습니다. 책을 읽다가 더 파고 싶어졌을 때 다음으로 열 것들입니다.

본문 각 장 첫머리의 키워드 상자에 걸린 1차 출처를 한 페이지에 모았습니다. 링크 172개, 키워드 228개입니다. 장별로도 볼 수 있고, 여러 장에서 함께 걸리는 출처만 따로 모아 둔 표도 있습니다.

이 책은 모든 키워드에 셋 중 하나를 붙였습니다. [표준](공식 명세가 있다), [사실상 표준](명세는 없지만 업계가 널리 쓴다), [실험](아직 자리를 잡는 중이다). 어느 문장이 검증된 사실이고 어느 문장이 저자의 추정인지 가르는 게 이 라벨입니다. 라벨이 틀렸다고 보시면 이의를 걸어 주세요.

---

책 내려받기

📕 graph-engineering-v2026.08.02.pdf 내려받기 | 릴리즈 노트 | 지난 판 전부

현재 판

내려받은 파일이 온전한지 확인하려면:

shasum -a 256 graph-engineering-v2026.08.02.pdf

왜 저장소에 PDF가 없나

PDF는 커밋하지 않습니다. 10MB에 가까운 빌드 산출물을 판올림마다 쌓으면 git 히스토리가 금방 무거워지고, 한 번 들어간 건 지워도 히스토리에 남습니다. 그래서 저장소에는 원본(.tex, .mmd, .py)만 두고 결과물은 릴리즈 첨부로 내보냅니다.

파일 이름으로 판을 구분합니다

첨부 파일 이름에 판 번호가 그대로 박혀 있습니다.

판 번호는 vYYYY.MM.DD 형식이고, 그 PDF를 빌드한 날짜입니다. 같은 날 두 번 이상 냈다면 뒤에 -2, -3이 붙습니다(graph-engineering-ko-v2026.08.05-2.pdf).

언어 조각을 넣은 이유는 하나입니다. 영어판이 나오면 같은 릴리즈에 파일 두 개가 붙는데, 이름이 같으면 구분이 안 됩니다. 판이 더 쌓이기 전에 규칙을 바꾸는 게 쌉니다.

내려받은 파일 이름만 봐도 어느 판인지 알 수 있으니, 이름을 바꾸지 말고 두시길 권합니다. 어딘가에 인용할 때도 판 번호를 같이 적어 주면 나중에 대조하기 쉽습니다. 지난 판은 릴리즈 목록에 그대로 남아 있습니다.

---

예제 코드

본문에 나오는 실행 가능한 예제를 장별로 담았습니다.

content/
├─ ch01/code/     # 각 장의 예제. README.md 에 실행법이 있다
├─ ch02/code/
│  ...
└─ ch35/code/

대부분 파이썬 3.11 이상에서 추가 설치 없이 돌아갑니다. 데이터베이스나 외부 API가 필요한 예제는 해당 장의 code/README.md에 필요한 버전과 설치 명령, 샘플 데이터를 함께 적어 뒀습니다. 실행 가이드 전체는 책의 부록에 있습니다.

---

틀린 곳과 반증

이 책은 정확해서 믿을 만한 책이 아닙니다. 틀린 곳이 드러나면 고치기 때문에 믿을 만한 책입니다. 그 고치는 자리가 여기 Issues입니다.

책 안에는 제보 문구를 한 줄도 넣지 않았습니다. 인쇄된 페이지에 붙은 연락처는 몇 년이면 죽는데, 그때부터는 「고칠 생각이 있다」는 시늉만 남거든요. 대신 저장소를 열어 뒀습니다.

세 가지 창구

넷 중 어디에도 안 맞으면 그냥 빈 이슈로 여세요. 양식은 적는 사람을 돕자고 만든 것이지 문턱을 세우려는 게 아닙니다.

반증부터 걸어 뒀습니다

35장에서 저자는 이 책의 주장 다섯 개를 직접 지목하고, 각각에 무엇이 참이면 이 주장이 틀리는지를 미리 적었습니다. 평균 확신은 46%입니다. 절반 아래예요.

그 다섯 개를 이슈로 열어 두고 고정해 뒀습니다. 빈 종이를 채우는 건 부담스러워도 열린 스레드에 답글은 달 만하니까요. 여러분 환경에서 재 보시고 다르게 나오면, 해당 스레드에 숫자를 적어 주세요.

반증 조건을 못 쓰는 문장은 주장이 아니라 의견입니다. 책을 쓰면서 그리로 빠진 문장은 전부 뺐습니다. 이 표는 그 규칙을 저자 자신에게도 적용한 결과입니다.

적기 전에 이것만

• 최신 판에서 이미 고쳐졌는지 릴리즈 목록에서 확인해 주세요. 판 번호는 내려받은 파일 이름에 박혀 있습니다.
• 근거는 1차 출처로 부탁드립니다. 공식 명세, 제품 공식 문서, RFC, 논문, 공식 저장소. 이 책이 그 기준으로 쓰였고, 고칠 때도 같은 기준을 씁니다.
• 「제 환경에서는 이렇게 나왔습니다」가 이 책에서 가장 센 근거입니다. 책의 숫자는 자릿수와 방향으로만 쓰시고, 값은 직접 재세요.

---

이 책에 대해

교과서가 아니라 밤에 혼자 읽다가 노트북을 여는 책을 목표로 썼습니다. 모든 절이 네 박자로 갑니다. 막힌 상황, 왜 막혔는지, 최소한으로 뚫는 방법, 그리고 그 방법이 언제 배신하는지.

그래서 성공담보다 실패담이 깁니다. 장마다 저자가 자기 주장을 의심하고, 확인해 보고, 틀렸으면 앞에서 한 말을 정정하는 대목이 최소 세 번 나옵니다. 매끄럽게 다듬어 지우지 않았습니다. 이 책의 신뢰는 정확함이 아니라 정정하는 습관에서 나온다고 믿기 때문입니다.

모든 개념에는 [표준] / [사실상 표준] / [실험] 중 하나를 붙였습니다. 특히 4부에서 다루는 '에이전트 그래프 엔지니어링'은 용어 자체가 아직 정립되지 않았습니다. 어디까지가 검증된 사실이고 어디부터가 저자의 추정인지, 본문에서 문장으로 구분해 뒀습니다.

각 장 끝에는 「내가 아직 모르는 것」이 있습니다. 저자가 확신하지 못하는 것 두세 개를 그대로 적어 둔 상자입니다.