온톨로지가 무엇인지부터 시작해, 원천 데이터베이스를 잇고, Cypher로 묻고, 에이전트와 함께 온톨로지를 구축하고, 업무 시스템에 액션을 실행하고, 그 위에 앱을 만드는 데까지 차근차근 따라 하는 실습서입니다.
이 튜토리얼에서 하는 일#
Ontological Studio는 온톨로지를 만들고, 묻고, 실행하고, 앱으로 쓰는 데스크톱 프로그램입니다. 설치 파일 하나에 그래프 데이터베이스(Ontological DB), 데이터 패브릭, 온톨로지 구축 에이전트, 액션 실행기, 예제 업무 시스템이 모두 들어 있어서, 노트북 한 대로 처음부터 끝까지 실습할 수 있습니다.
이 튜토리얼은 한 회사의 공급망 운영 이야기를 따라갑니다. 이 회사의 데이터는 세 시스템에 흩어져 있습니다.
| 시스템 | 담고 있는 것 | 예 |
|---|---|---|
구매 ERP (erp) |
협력사, 품목, 발주, 발주 품목 | 선전 골드라인 PCB에 PCB 기판 2,000장을 발주했다 |
물류 WMS (wms) |
입고 선적, 일별 재고 | 그 발주의 선적이 세관에 9일째 묶여 있다 |
고객 CRM (crm) |
고객, 판매 주문, 클레임 | 도쿄의 고객이 PCB 납땜 불량 클레임을 냈다 |
“3일 넘게 늦은 선적은 어느 협력사의 어느 발주 건인가?”라는 질문의 답은 이 셋을 모두 이어야 나옵니다. 튜토리얼을 마치면 여러분은 이 질문을 그래프 질의 한 줄로 답하고, “그 선적을 긴급 처리해 줘”라는 지시를 승인 절차를 거쳐 실제 시스템에 실행하고, 이 모든 것을 한 화면에 모은 업무 앱을 만들 수 있게 됩니다.
학습 순서#
1 · 시작하기설치, 첫 실행, 화면 둘러보기
2 · 온톨로지 개념클래스·속성·관계·인스턴스, 앱의 구성
3 · 데이터 연결원천 DB를 복사 없이 가상 노드로
4 · Cypher 익히기MATCH부터 집계·진단·시간 여행까지
5 · 온톨로지 구축골든 퀘스천·골든 커맨드, 문서로 구축, 질의
6 · 액션시스템 등록, 액션 만들기, 승인·실행·취소
7 · 애플리케이션대시보드, 코드 앱, SDK, 액션 버튼
8 · 마무리 과제배운 것을 엮는 종합 실습
각 장은 개념 → 따라 하기 → 확인 문제 순서로 되어 있습니다. 확인 문제의 답은 접혀 있으니, 먼저 스스로 해 본 뒤 펼쳐 보세요.
누구를 위한 튜토리얼인가#
- 데이터베이스 수업에서 SQL
SELECT와JOIN을 배워 본 대학생 수준이면 충분합니다. - 그래프 데이터베이스나 Cypher는 몰라도 됩니다. 4부에서 처음부터 배웁니다.
- 프로그래밍은 7부(코드 앱)에서만 조금 필요합니다. 그것도 에이전트가 코드를 써 주므로, 읽을 수 있으면 됩니다.
준비물#
| 항목 | 내용 |
|---|---|
| 컴퓨터 | macOS (Apple Silicon, M1 이상) 또는 Windows 10/11 (x64), 메모리 8GB 권장 |
| 디스크 | 2GB 이상 여유 |
| 코딩 에이전트 | Claude Code 또는 Codex CLI — 설치하고 로그인해 두면 API 키 없이 구축·질의 에이전트가 동작합니다. 없어도 3·4부(데이터 연결, Cypher)는 그대로 실습할 수 있습니다. |
| 네트워크 | 설치 파일을 받을 때와 에이전트(LLM)를 쓸 때만 필요합니다. 데이터베이스는 모두 내 컴퓨터 안에서 돕니다. |
먼저 영상으로 보고 싶다면
제품 소개 페이지에 문서로 구축하기, 골든 커맨드로 액션 만들기, 온톨로지 앱 만들기 시연 영상이 있습니다. 이 튜토리얼은 그 과정을 한 단계씩 풀어 쓴 것입니다.
표기 약속#
MATCH (s:Supplier) RETURN s.name처럼 고정폭 글자는 입력하는 문장, 화면의 버튼 이름은 「가상 노드 만들기」처럼 낫표로 씁니다.- 화면 사진은 낮 테마로 찍었습니다. 일부 시연 장면(밤 테마)은 사진 설명에 따로 적었습니다.
- 숫자와 결과는 모두 예제 데이터로 실제로 실행해 얻은 값입니다. 여러분의 결과가 다르면, 앞 장에서 데이터를 바꾸는 실습(액션 실행 등)을 했는지 확인하세요.