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

# Hermes Agent 기반 사내 운영 에이전트

https://geonwoo.kim/ko/portfolio/lukuku-ops-agent

기간: 2026.04 — 현재

직원이 슬랙과 텔레그램에서 부르는 사내 운영 에이전트입니다. 사무실 맥미니 한 대에서 Nous Research의 Hermes Agent로 돌아갑니다. 요청을 나눠 맡을 에이전트에 배정하고, 결과를 모아 같은 스레드에 답합니다. 설계부터 구현과 운영까지 맡았습니다.

슬랙 요청을 역할별 에이전트 9개에 나눠 맡기고, 오류는 배포와 회복 확인까지 처리하는 에이전트

팀: 사내 에이전트 시스템 · 설계·구현·운영 담당

역할: 에이전트 권한 설계 · 운영 서버 구성 · 장애 자동 처리 · 모델 평가

만든 도구: [offon](https://geonwoo.kim/ko/portfolio#tools) · [vat](https://geonwoo.kim/ko/portfolio#tools)

Hermes Agent · Python · macOS · launchd · OpenViking · BGE-M3 · Slack

- 업무 조회·등록과 연차·반차 신청을 슬랙 스레드에서 처리
- 고객 채널의 요청을 업무로 올리는 관찰 에이전트 · 고객 채널에 쓰는 권한은 없음
- 재직자마다 슬랙 대화로 매일 새로 고치는 개인 에이전트
- 맥미니 한 대에서 launchd 작업 33개로 상시 실행 · 5분마다 설치본과 소스 대조

## 이름만 셋이던 예비 모델

문제: 대화가 약 141k 토큰으로 커지자 응답이 최대 1,221초까지 늦어졌습니다. 예비 모델 세 자리 중 하나는 인증이 만료됐고, 둘은 주 모델과 같은 공급자였습니다.

해결: 원인은 커진 대화의 압축이 300초 제한에 걸려 실패한 것이었습니다. API 키로 결제하지 않는다는 원칙에 맞춰, 구독 계정으로 Claude를 부르는 로컬 어댑터를 만들었습니다. 이 어댑터를 주 모델과 다른 공급자의 예비 경로로 붙였습니다.

## 오류마다 기다리던 승인

문제: 처음에는 오프온 오류만 에이전트가 고쳤고, 수정과 배포에 사람 승인이 필요했습니다.

해결: 모든 프로젝트의 오류를 원인 조사부터 배포와 회복 확인까지 맡겼습니다. 오탐이면 알림을 끄지 않고 감지 조건을 고칩니다. 외부 발송, 거래·환불, 원문 삭제, 권한 변경, 회사 기록 반영 다섯 가지만 사람이 승인합니다.

## 지어낸 링크로 답하는 개인 에이전트

문제: 직원 대신 답하는 에이전트가 도구가 찾지 않은 링크를 근거로 대면 안 됐습니다.

해결: 질문 9개로 모델을 비교하고, 도구가 돌려주지 않은 링크를 하나라도 쓰면 0점으로 매겼습니다. 첫 실제 대화에서는 위키 도구를 한 번도 부르지 못했습니다. 도구를 뒤로 미루지 않게 하고, 조회 순서를 지침에 적어 고쳤습니다. 5점 만점에 2.86–4.54점이 나왔고, 지어낸 링크는 모든 후보에서 0건이었습니다.

## 하루 늦은 회사 기록

문제: 회사 결정 기록을 새벽에 한 번만 받아 와서, 에이전트가 그날 정한 결정을 찾지 못했습니다.

해결: 10분마다 도는 수집 작업에 기록 동기화를 넣었습니다. 같은 질문에 그날의 결정으로 답하는 것을 확인했습니다.

## 아키텍처

총괄 에이전트

요청 해석 · 계획 · 배정 · 인계 · 결과 검증 · 최종 판단 · 결과는 실제 원천과 대조

### 지식과 기억

- 회사 기록

  목표 · 결정 · 운영 기준 · 사람 승인 없이 반영하지 않음

- 운영 설정 저장소

  에이전트 설정 · 실행 규칙 · 회사 기록과 역할 분리

- Hermes Agent 내장 기억

  에이전트마다 기억을 따로 둠

- OpenViking 검색

  지식 · 대화 검색 · 검색 결과를 회사 기록으로 보지 않음

### 실행과 통제

- 총괄이 맡는 시스템

  오프온 · 회사 기록 · 설정 저장소 · 자격 증명 · 작업자 보고만으로 완료 처리하지 않음

- 단계 인계 원장

  업무 · 완료 조건 · 담당 · 검토 · 장기 실행 · 감사 · 재시도

- 범위와 승인

  역할마다 실행 범위 제한 · 작업자는 일을 다시 맡기지 않음 · 외부 발송은 별도 승인

### 개발 담당

- 조사 · 읽기 전용

  원인 · 기술 근거 조사 · 제품 코드 수정 없음

- 구현 · 격리

  별도 작업 공간에서 구현 · 로컬 테스트 · 최종 커밋 · 푸시 · 병합 · 배포 없음

- 검증 · 독립 QA

  테스트 근거 확인 · 통과 · 반려 판정 · 최종 반영은 총괄

### 운영 담당

- 슬랙 관찰

  공개 채널 메시지 수집 · 요청을 오프온에 반영 · 판단은 총괄로 반환

- 슬랙 원문 저장소 · 저장소

  메시지 50만 건 이상 · 비공개 방과 웹훅 방을 뺀 공개 채널을 매일 수집

- 직원 정보

  HR 정보 정리 · HR 범위 안에서만 실행

- 개인 업무

  개인 오프온 업무 · 연차 · 반차 · 승인 판단은 총괄

- 직원 대응

  오프온 읽기 전용 · 직원에게 한 답변은 회사 승인이 아님

### 운영 알림

- 오류 알림 전달

  오류 알림 채널의 슬랙 웹훅 알림을 총괄 에이전트에 전달 · 작업은 실행하지 않음

역할 수행 → 결과 · 근거 · 위험 반환 → 총괄이 원천과 대조 → 승인 · 검증 후 반영 → 다시 조회해 완료 확인


[스포츠 브랜드 국내 자사몰과 ERP의 판매 대사·연동 운영](https://geonwoo.kim/ko/portfolio/lukuku-commerce-erp) · [오프온 · 전사 업무 관리 시스템](https://geonwoo.kim/ko/portfolio/offon)