codejunkie99/graph-engineering
요약
이 글은 AI 에이전트의 작동 구조를 설계하는 '그래프 엔지니어링' 개념을 소개합니다. 에이전트는 지식 그래프(기억)와 태스크 그래프(작동 방식)라는 두 가지 핵심 요소로 구성되며, 이 레포지토리는 이를 실제 사용 가능한 형태로 구현했습니다.
핵심 포인트
- 에이전트의 작동 구조는 프롬프트가 아닌 그래프 엔지니어링으로 설계된다.
- 지식 그래프는 개체와 관계를 포함하며, 온톨로지-추출-융합 과정을 거친다.
- 태스크 그래프는 작업 간의 의존성(병렬 분산, 검증기 등)을 정의하여 에이전트의 흐름을 제어한다.
AI 에이전트가 작동하는 구조를 설계하는 학문 — 프롬프트를 통해서가 아니다.
이것은 두 가지 절반으로 구성되어 있습니다:
지식 그래프 (Knowledge graphs)— 에이전트가 기억하는 것. 노드는 개체와 사실이며, 엣지는 시간과 출처(provenance)를 가진 관계입니다. 온톨로지 → 추출 → 융합 → 제공(serving). 태스크 그래프 (Task graphs)— 에이전트가 작동하는 방식. 노드는 작업(jobs)이고, 엣지는 실행 의존성입니다. 병렬 분산(Parallel fan-out), 별도의 검증기(verifiers), 중지 규칙(stop rule), 인간의 게이트(human gate) 등이 있습니다.
프롬프트 엔지니어는 모델의 단어를 조종했습니다. 루프 엔지니어는 반복을 조종했습니다. 그래프 엔지니어는 그 **토폴로지(topology)**를 조종합니다.
이 레포지토리(repo)는 Southeast University의 대학원 지식 그래프 과정 (npubird/KnowledgeGraphCourse, 4.4K★, 2019년부터 중국어로 강의됨) — 그리고 태스크 그래프 뒤에 있는 현대적인 에이전트 오케스트레이션 연구 — 를 오늘날 실제로 사용할 수 있는 형태로 변환했습니다.
| 경로 | 내용 |
|---|---|
graph-engineering/ | 이 기술. 여러분의 에이전트(Claude Code / 모든 스킬과 호환되는 하네스)에 전달하면, 전체 9단계 지식 그래프 파이프라인, 태스크 그래프 패턴, 그리고 사용자의 도메인에서 그려진 다이어그램으로 각 단계를 설명하는 교육 모드를 학습합니다. |
graph-engineering/references/ | 정제된 과정: 커리큘럼 지도(원래 중국어 덱에 대한 링크 포함), 모델링, 추출, 융합 + GraphRAG, 태스크 그래프. |
WORKFLOWS.md | 붙여넣기 준비가 된 아홉 개의 프롬프트 블록 — 전체 과정을 대화형으로 가르쳐주는 /kg-tutor와, 완전한 빌드를 위해 체인되는 여덟 가지 단일 목적 도구들 (/kg-scope → /kg-rag) |
dist/graph-engineering.skill | 패키징된 스킬 파일. |
git clone https://github.com/codejunkie99/graph-engineering.git
cp -r graph-engineering/graph-engineering ~/.claude/skills/
그런 다음 에이전트에게 빌드(
flowchart LR
A[1 범위(scope)] --> B[2 표현(representation)] --> C[3 온톨로지(ontology)] --> D[4 개체(entities)]
D --> E[5 관계(relations)] --> F[6 이벤트(events)] --> G[7 품질 게이트(quality gate)]
...
추출하기 전에 도메인을 모델링하세요. 저장하기 전에 융합하세요. 모든 단계에서 검증하세요.
지식 그래프는 트리플의 더미가 아니라 스키마를 가진 제품입니다.
- 삭제
가짜 간선(fake edges): 화살표는 작업이 흐르는 경우에만 실제입니다. - 이
다이아몬드: 분할 → 병렬 워커 → 분리된 검증자 컨텍스트 → 하나의 소유된 병합. - 이
중지 규칙(stop rule) (Google DeepMind × MIT, 180가지 구성): 팀들은 작업이 분할될 때 약 80%의 승률을 보이며; 모든 팀 구성은 순차적인 작업에서 실패합니다. 작업의 형태가 결정합니다. - 이
인간 게이트(human gate): 귀하의 승인은 실수가 되돌리기에 비싼 지점에 정확히 위치해야 합니다.
세부 정보: references/task-graphs.md
지식 그래프 부분은 东南大学《知识图谱》研究生课程 (Southeast University's graduate Knowledge Graph course)인 Prof. Peng Wang — npubird/KnowledgeGraphCourse의 독립적인 영어 증류본입니다. 모든 원본 강의 PDF는 중국어이며 원래 레포에 남아 있습니다; 여기에서는 재배포되지 않습니다. 태스크 그래프 자료는 Google DeepMind × MIT의 "Towards a Science of Scaling Agent Systems"와 Anthropic이 발표한 멀티 에이전트 엔지니어링 작업에서 가져왔습니다.
MIT 라이선스. @Av1dlive가 구축했습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub AI Tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기