[portfolio](https://geonwoo.kim/ko/portfolio) › 루쿠쿠

# 루쿠쿠 OS · 회사 온톨로지와 에이전트 운영 체계

https://geonwoo.kim/ko/portfolio/lukuku-os

기간: 2026.09 — 현재

회사 정보를 묶은 그래프를 직원과 에이전트가 함께 조회합니다. 에이전트는 사람 승인 아래에서 개발 작업을 나눠 맡습니다.

슬랙·메일·깃허브 등 15곳의 원문을 고객사·프로젝트 120여 개에 연결

팀: 사내 에이전트 시스템 담당 2명 · 구조 설계·구현

역할: 온톨로지 설계 · 지식 그래프 · 답변 평가 · 에이전트 운영

Hermes Agent · MCP · PostgreSQL · AWS S3 · BGE-M3 · launchd

- 슬랙 메시지 50만 건 이상을 보관하고 검색하는 원문 저장소

## 여러 곳을 뒤져야 알 수 있던 고객사

문제: 한 고객사를 이해하려면 슬랙, 메일, 문서, 저장소를 따로 뒤져야 했습니다. 사람이 채우던 사내 위키는 문서 51개가 빈 채로 갱신이 멈춰 있었습니다.

해결: 원천 15곳을 정해진 주기로 모아 매일 그래프를 다시 계산합니다. 원문 링크가 있는 관계만 남기고, 수집이 끊기면 마지막 정상본을 유지합니다. 2026.11 기준 대상 약 280개와 관계 약 4,150건을 담습니다. 2026.09부터 전 직원이 씁니다.

## 온톨로지: 무엇을 어떤 말로 잇는가

문제: 이름이 비슷한 대상이나 뜻이 다른 관계를 섞으면 틀린 답이 나옵니다. 관계 이름을 정하지 않으면 같은 사실이 여러 말로 흩어졌습니다.

해결: 무엇을 어떤 말로 이어도 되는지 관계 종류 20개로 정했습니다. 업무 한 건마다 누가 어떤 책임을 맡았는지도 잇게 했습니다. 업무별 책임 역할 관계 100건이 생겼습니다.

## 그래프만으로 답하는가

문제: 그래프가 커져도 실제 질문에 답하는지는 알 수 없었습니다.

해결: 원문 근거로 기대 답을 정한 고정 질문을 매일 돌리고, 못 답한 질문은 어느 단계에서 막혔는지 진단합니다. 슬랙에서 뽑은 관계는 서로 다른 계열 모델 두 곳이 동의해야 채택합니다.

## 첨부 문서에만 있던 거래처

문제: 결제·물류·본인인증 거래처가 첨부 문서 본문에만 있고 그래프에는 없었습니다.

해결: 역할을 나타내는 말 옆의 고유명사를 거래처 후보로 뽑고, 사람이 확인한 것만 거래처로 올렸습니다. 추측한 거래처는 빈 거래처보다 나쁘다고 봤습니다. 그래프의 거래처는 20개에서 24개로 늘었습니다.

## 되돌리기 어려운 일

문제: 에이전트에게 실행을 맡기면서 되돌리기 어려운 일은 막아야 했습니다. 한 에이전트가 지시를 무시하고 고객 스레드에 답한 일도 있었습니다.

해결: 권한을 주제가 아니라 조사·구현·검토 단계로 나눴습니다. 조사와 검토 에이전트는 읽기만 하고, 구현 에이전트는 커밋까지만 하며 병합과 배포는 하지 못합니다. 고객 채널을 지켜보는 에이전트에는 메시지를 쓰는 권한을 주지 않았습니다. 장애 대응을 뺀 배포, 외부 발송, 운영 데이터 쓰기는 사람이 승인합니다.

## 아키텍처

업무 배정 에이전트

요청 분류 · 배정 · 결과 취합

### 회사 온톨로지

- 수집

  슬랙 · 메일 · 캔버스 · 첨부 · 저장소 · 업무 원장

- 슬랙 원문 저장소

  메시지 50만 건 이상 · 전문 검색 · 첨부 원본과 목록 별도 보관

- 위키 그래프

  매일 재계산 · 원문 링크가 붙은 관계만 남김

- 관계 규칙

  허용 관계와 근거 등급을 한 파일에 정의

- 회사 기록

  결정 · 확인할 일 · 기억 · 사람 검토 후 반영

### 조회 창구

- 오프온 MCP

  OAuth · 요청자 권한 안에서만 쓰기

- 답변 평가

  고정 질문을 매일 돌려 못 답한 원인 진단

### 개발 담당

- 조사

  읽기 전용 원인 분석

- 구현

  별도 작업 공간에서 커밋 · 병합·배포 불가

- 검토

  작성자와 다른 모델로 검토

### 업무 담당

- 업무 관찰

  슬랙 대화의 업무를 오프온에 올림 · 근거가 불분명하면 그대로 둠

요청 → 업무 배정 → 구현·커밋 → 다른 모델 검토 → 사람 승인 → 배포 후 확인

고객사·인명·내부 정보를 흐리게 처리한 회사 온톨로지 위키 그래프

고객사·프로젝트·사람·저장소 등 대상 약 280개와 관계 약 4,150건을 잇습니다.


[미국 법인 Shopify B2B 스토어 구축 · B2B 백엔드](https://geonwoo.kim/ko/portfolio/lukuku-commerce-b2b) · [설치미술 전시를 위한 360도 영상 앱과 AI 영상 생성 서버](https://geonwoo.kim/ko/portfolio/lukuku-ai-experience)