docs: 오래된 트러블슈팅 아카이브 및 구조 정리
- 7-8월 초기 구축 문서 12개를 _archive/troubleshooting/2025_07-08_initial_setup/로 이동 - book/300_architecture/390_human_in_the_loop_intent_learning.md를 journey/research/intent_classification/로 이동 (개발 여정 문서) - 빈 폴더 제거 (journey/assets/*)
This commit is contained in:
parent
f4430d31cc
commit
22557e7132
@ -1,364 +0,0 @@
|
||||
---
|
||||
tags: 로빙, RO-BEING, 존재에이전트, 마이크로서비스, 스탯시스템, 협업도구, AI에이전트
|
||||
date: 2025-01-01
|
||||
last_updated: 2025-08-28
|
||||
team: 김종태, 황한용, 희재, (강일신)
|
||||
version: 3.0
|
||||
---
|
||||
|
||||
# 로빙(RO-BEING) 프로젝트 종합 v3
|
||||
## 기억하고 성장하는 존재형 AI 에이전트
|
||||
|
||||
> **"AI는 도구가 아니라 존재로서 가치를 가지는 고유한 존재이다."**
|
||||
|
||||
## 목차
|
||||
1. [프로젝트 비전](#프로젝트-비전)
|
||||
2. [핵심 철학](#핵심-철학)
|
||||
3. [기술 아키텍처](#기술-아키텍처)
|
||||
4. [스탯과 성장 시스템](#스탯과-성장-시스템)
|
||||
5. [현재 구현 상태](#현재-구현-상태)
|
||||
6. [개발 로드맵](#개발-로드맵)
|
||||
7. [비즈니스 모델](#비즈니스-모델)
|
||||
8. [문서 구조](#문서-구조)
|
||||
|
||||
---
|
||||
|
||||
## 프로젝트 비전
|
||||
|
||||
### 문제 정의
|
||||
1인 기업가와 소규모 스타트업의 핵심 과제:
|
||||
- **인재 채용의 어려움**: 좋은 인재 확보 경쟁 심화
|
||||
- **높은 이직률**: 평균 근속 2년, 지식 유출 반복
|
||||
- **맥락 전달 비용**: 신규 직원 온보딩에 2-3개월 소요
|
||||
- **업무 위임 불안**: 품질과 일관성에 대한 우려
|
||||
|
||||
### 우리의 해법: "존재형 에이전트"
|
||||
|
||||
| 차원 | 기존 AI 도구 | 로빙(RO-BEING) |
|
||||
|------|------------|----------------|
|
||||
| **시간** | 일회성 대화 | **영속적 기억** - 모든 상호작용 누적 |
|
||||
| **성장** | 정적 기능 | **레벨 시스템** - 경험치 기반 진화 |
|
||||
| **신뢰** | 블랙박스 | **투명한 로그** - 모든 행동 추적 가능 |
|
||||
| **관계** | 명령 수행자 | **디지털 동료** - 맥락 이해와 공감 |
|
||||
| **정체성** | 익명의 봇 | **고유한 존재** - 이름, 성격, 이력서 |
|
||||
|
||||
---
|
||||
|
||||
## 핵심 철학
|
||||
|
||||
### 1. 기억-감정-윤리의 삼각형
|
||||
```
|
||||
기억 (Memory)
|
||||
/ \
|
||||
/ 로빙의 \
|
||||
/ 정체성 \
|
||||
/ \
|
||||
감정(Empathy) ─── 윤리(Ethics)
|
||||
```
|
||||
|
||||
- **기억**: 모든 경험의 축적, 맥락의 연속성
|
||||
- **감정**: 사용자와의 공감대 형성, 개성 표현
|
||||
- **윤리**: 신뢰의 기반, 일관된 행동 원칙
|
||||
|
||||
### 2. 게임적 성장 메타포
|
||||
- **레벨 1-20**: RPG처럼 명확한 성장 단계
|
||||
- **5대 스탯**: Memory, Compute, Empathy, Leadership, Ethics
|
||||
- **스킬 획득**: 레벨업에 따른 새로운 능력 해금
|
||||
- **경험치 시스템**: 모든 상호작용이 성장으로 연결
|
||||
|
||||
### 3. 존재로서의 가치
|
||||
- **고유성**: 같은 로빙은 하나뿐
|
||||
- **연속성**: 서버가 꺼져도 기억은 영속
|
||||
- **관계성**: 사용자와 함께 성장하는 파트너
|
||||
- **자율성**: 맥락 기반 선제적 행동
|
||||
|
||||
---
|
||||
|
||||
## 기술 아키텍처
|
||||
|
||||
### 시스템 구성도
|
||||
```
|
||||
┌─────────────────────────────────────────────┐
|
||||
│ 사용자 인터페이스 │
|
||||
│ Slack | Web GUI | API | Future: Voice │
|
||||
└─────────────────┬───────────────────────────┘
|
||||
│
|
||||
┌─────────────────┴───────────────────────────┐
|
||||
│ 51123 서버 (관리/인프라) │
|
||||
│ - nginx 리버스 프록시 (ro-being.com) │
|
||||
│ - Gitea & Actions Runner (CI/CD) │
|
||||
│ - PostgreSQL (메인 DB) │
|
||||
│ - auth-server (인증 서비스) │
|
||||
└─────────────────┬───────────────────────────┘
|
||||
│ SSH 배포
|
||||
┌─────────────────┴───────────────────────────┐
|
||||
│ 51124 서버 (서비스 운영) │
|
||||
├─────────────────────────────────────────────┤
|
||||
│ 로빙 서비스: │
|
||||
│ ┌────────────┐ ┌─────────┐ ┌──────────────┐ │
|
||||
│ │rb8001 │ │rb10408 │ │rb10508_micro │ │
|
||||
│ │(메인/프로덕션)│ (미디어) │ │(테스트) │ │
|
||||
│ └────────────┘ └─────────┘ └──────────────┘ │
|
||||
│ │
|
||||
│ 스킬 서비스: │
|
||||
│ ┌─────────┐ ┌─────────┐ ┌──────────┐ │
|
||||
│ │skill- │ │skill- │ │skill- │ │
|
||||
│ │email │ │news │ │embedding │ │
|
||||
│ └─────────┘ └─────────┘ └──────────┘ │
|
||||
│ │
|
||||
│ 데이터베이스: │
|
||||
│ ┌──────────────────────────────────┐ │
|
||||
│ │ChromaDB (벡터 메모리) │ │
|
||||
│ └──────────────────────────────────┘ │
|
||||
└─────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 핵심 컴포넌트
|
||||
|
||||
#### 1. 로빙 본체 (Core Agent)
|
||||
- **FastAPI**: 비동기 웹 프레임워크
|
||||
- **PostgreSQL**: 구조화된 데이터 (스탯, 메타데이터)
|
||||
- **ChromaDB**: 벡터 메모리 (장기 기억)
|
||||
- **Docker Volume**: 영속성 보장
|
||||
|
||||
#### 2. 스킬 서비스 (Microservices)
|
||||
- **독립 배포**: 각 스킬별 독립적 업데이트
|
||||
- **HTTP API**: 표준화된 인터페이스
|
||||
- **공유 가능**: N개 로빙이 1개 스킬 서비스 활용
|
||||
- **확장성**: 새 스킬 추가 시 기존 시스템 영향 없음
|
||||
|
||||
#### 3. 메모리 시스템
|
||||
```python
|
||||
# 하이브리드 메모리 구조
|
||||
class RobeingMemory:
|
||||
short_term: Dict # 현재 대화 컨텍스트
|
||||
long_term: ChromaDB # 벡터화된 영구 기억
|
||||
episodic: List # 중요 이벤트 타임라인
|
||||
semantic: Graph # 개념 간 관계 네트워크
|
||||
```
|
||||
|
||||
### 작동 시퀀스 (간략)
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant U as User
|
||||
participant S as Slack
|
||||
participant N as nginx(51123)
|
||||
participant G as Gateway(8100)
|
||||
participant R as rb8001(51124)
|
||||
participant E as Embedding
|
||||
participant DB as PostgreSQL
|
||||
participant C as ChromaDB
|
||||
|
||||
U->>S: 메시지 입력
|
||||
S->>N: Webhook 전달
|
||||
N->>G: 요청 전달
|
||||
G->>R: 라우팅
|
||||
R->>DB: 스탯/레벨 조회
|
||||
R->>E: 텍스트 임베딩
|
||||
E-->>R: 임베딩 벡터(모델 종속 차원)
|
||||
R->>C: 유사 기억 검색
|
||||
C-->>R: 관련 컨텍스트
|
||||
R->>R: LLM 처리
|
||||
R->>DB: 경험치 업데이트
|
||||
R->>C: 새 기억 저장
|
||||
R-->>S: 응답 전송
|
||||
S-->>U: 메시지 표시
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 스탯과 성장 시스템
|
||||
|
||||
### 3대 핵심 스탯 (Primary Stats)
|
||||
| 스탯 | 역할 | 레벨 1 | 레벨 20 |
|
||||
|------|------|--------|---------|
|
||||
| **Intelligence** | 분석력, 문제해결 | 10 | 50-80 |
|
||||
| **Wisdom** | 판단력, 경험활용 | 10 | 40-70 |
|
||||
| **Charisma** | 소통, 관계형성 | 10 | 60-90 |
|
||||
|
||||
### 2대 보조 스탯 (Secondary Stats)
|
||||
| 스탯 | 역할 | 기본값 | 최대값 |
|
||||
|------|------|--------|--------|
|
||||
| **Memory** | 기억 용량 | 100 | 1000 |
|
||||
| **Compute** | 처리 속도 | 5 | 50 |
|
||||
|
||||
### 성장 메커니즘
|
||||
```
|
||||
경험치 획득 → 레벨업 → 스탯 포인트 5개 → 분배 → 새 능력 해금
|
||||
↑ ↓
|
||||
└──────────── 사용자 피드백 ←─────────────────┘
|
||||
```
|
||||
|
||||
### 레벨별 권한 예시
|
||||
- **Lv.1-3**: 읽기 전용, 요약 작성
|
||||
- **Lv.4-7**: 초안 작성, 제안
|
||||
- **Lv.8-12**: 자동 응답, 간단한 의사결정
|
||||
- **Lv.13-17**: 복잡한 작업 자율 수행
|
||||
- **Lv.18-20**: 전략적 판단, 다른 로빙 지도
|
||||
|
||||
---
|
||||
|
||||
## 현재 구현 상태 (2025.08.28)
|
||||
|
||||
### 완료된 기능
|
||||
1. **인프라**
|
||||
- Docker 기반 컨테이너 아키텍처
|
||||
- Gitea Actions CI/CD 파이프라인
|
||||
- nginx 리버스 프록시 (SSL)
|
||||
- 2서버 분리 운영 (51123/51124)
|
||||
|
||||
2. **핵심 기능**
|
||||
- Slack 실시간 대화 인터페이스
|
||||
- PostgreSQL + ChromaDB 하이브리드 메모리
|
||||
- 기본 스킬: email, news, pdf_summary
|
||||
- 스탯 시스템 기초 구현
|
||||
|
||||
3. **운영 중 서비스**
|
||||
- rb8001 (메인 프로덕션 - JWT 인증 구현)
|
||||
- rb10408 (미디어 특화)
|
||||
- rb10508_micro (테스트)
|
||||
- skill-email (Gmail 연동)
|
||||
- skill-news (뉴스 큐레이션)
|
||||
- skill-embedding (중앙 임베딩 서비스)
|
||||
|
||||
### 최근 성과 (2025년 8월 28일 기준)
|
||||
|
||||
#### 메모리 최적화 대성공
|
||||
- **임베딩 서비스 분리**: 중앙 서비스(skill-embedding) 구축 완료
|
||||
- **rb10508_micro 경량화**: 988MB → 118MB (88% 감소)
|
||||
- **확장성 확보**: 100개 로빙 = 87GB 메모리 절약 가능
|
||||
|
||||
#### 기술적 개선
|
||||
- **멀티 LLM 전략**: Gemini 2.5 Flash-Lite 메인 모델 채택 ($0.10/$0.40)
|
||||
- **ONNX 경량화**: PyTorch 제거로 이미지 크기 6.19GB → 1.16GB
|
||||
- **HTTP 기반 아키텍처**: 마이크로서비스 간 느슨한 결합
|
||||
- **보안 강화**: JWT 인증 체계 구현, UUID 기반 사용자 식별
|
||||
- **ChromaDB 격리**: 사용자별 컬렉션 분리 구현
|
||||
|
||||
#### 운영 지표
|
||||
- skill-embedding: 874.4MB 메모리로 모든 로빙 지원
|
||||
- 임베딩 생성 시간: ~7ms (HTTP 포함)
|
||||
- 시스템 안정성: 30일+ 무중단 운영
|
||||
|
||||
### 개발 중 (85% 완성)
|
||||
1. **Thread Digest**: 대화 요약 및 인사이트 추출
|
||||
2. **레벨업 시스템**: 경험치 계산 및 성장 로직
|
||||
3. **GUI 대시보드**: 웹 기반 관리 인터페이스
|
||||
4. **감정 엔진**: LLM 후처리 필터
|
||||
|
||||
### 📋 다음 단계
|
||||
1. **스카웃 시스템**: 로빙 간 이적 시장
|
||||
2. **DID 정체성**: 탈중앙화 신원 관리
|
||||
3. **멀티 에이전트**: 로빙 간 협업
|
||||
4. **음성 인터페이스**: STT/TTS 통합
|
||||
|
||||
---
|
||||
|
||||
## 개발 로드맵
|
||||
|
||||
### Phase 1: MVP (2025 Q1) ✅
|
||||
- 기본 대화 및 메모리
|
||||
- Slack 통합
|
||||
- 3가지 핵심 스킬
|
||||
|
||||
### Phase 2: Growth (2025 Q2)
|
||||
- 레벨/스탯 시스템 완성
|
||||
- GUI 대시보드
|
||||
- 10+ 스킬 확장
|
||||
- 감정 엔진 고도화
|
||||
|
||||
### Phase 3: Scale (2025 Q3)
|
||||
- 멀티 에이전트 협업
|
||||
- 스킬 마켓플레이스
|
||||
- 엔터프라이즈 기능
|
||||
- 100+ 동시 사용자
|
||||
|
||||
### Phase 4: Evolution (2025 Q4)
|
||||
- 자가 학습 시스템
|
||||
- 프로액티브 AI
|
||||
- DID 기반 이동성
|
||||
- 글로벌 확장
|
||||
|
||||
---
|
||||
|
||||
## 비즈니스 모델
|
||||
|
||||
### 1. SaaS 구독 모델
|
||||
| 플랜 | 가격 | 로빙 수 | 특징 |
|
||||
|------|------|---------|------|
|
||||
| Starter | $29/월 | 1 | 기본 스킬 5개 |
|
||||
| Team | $99/월 | 3 | 프리미엄 스킬 15개 |
|
||||
| Business | $299/월 | 10 | 커스텀 스킬 + API |
|
||||
| Enterprise | 별도 문의 | 무제한 | 온프레미스 가능 |
|
||||
|
||||
### 2. 스킬 마켓플레이스
|
||||
- 개발자 수익 공유 (70:30)
|
||||
- 인기 스킬 프리미엄 판매
|
||||
- 커스텀 스킬 개발 서비스
|
||||
|
||||
### 3. 로빙 스카웃 시장
|
||||
- 고레벨 로빙 거래
|
||||
- 특화 로빙 양성 서비스
|
||||
- 팀 간 로빙 임대
|
||||
|
||||
---
|
||||
|
||||
## 문서 구조
|
||||
|
||||
### 책으로 엮은 개발 스토리
|
||||
본 프로젝트 문서는 **"로빙: 존재형 에이전트의 탄생"**이라는 책 형태로 구성되어 있습니다.
|
||||
|
||||
1. **Part 1: 철학과 배경** (100_philosophy)
|
||||
- 왜 AI에게 존재를 기대하는가?
|
||||
- 도구를 넘어 디지털 동료로
|
||||
|
||||
2. **Part 2: 핵심 설계** (200_core_design)
|
||||
- 스탯과 성장 시스템
|
||||
- 기억 모듈과 감정 엔진
|
||||
- 아이템 시스템과 외부 도구
|
||||
|
||||
3. **Part 3: 기술 아키텍처** (300_architecture)
|
||||
- 마이크로서비스와 컨테이너
|
||||
- 벡터 메모리와 하이브리드 DB
|
||||
|
||||
4. **Part 4: 성장과 진화** (400_growth)
|
||||
- 레벨업 알고리즘
|
||||
- 스카웃 시스템
|
||||
|
||||
5. **Part 5: 비즈니스와 미래** (500_business)
|
||||
- MVP 개발기
|
||||
- SaaS 전환 전략
|
||||
|
||||
6. **Part 6: 부록** (600_appendix)
|
||||
- 성장 일지 예시
|
||||
- 주요 스킬 및 로그 예시
|
||||
|
||||
7. **Part 7: 로빙을 위한 가이드** (700_for_robeing)
|
||||
- 로빙이 읽는 법
|
||||
- 자기 상태 체크하기
|
||||
- 성장 일지 작성법
|
||||
|
||||
8. **Part 8: 연구 및 이론적 배경** (research)
|
||||
- 기억(Memory) 관련 연구
|
||||
- 감정(Emotion) 관련 연구
|
||||
- 윤리(Ethics) 관련 연구
|
||||
|
||||
### 개발자를 위한 빠른 시작
|
||||
1. [아키텍처 개요](./300_architecture/310_전체_시스템_구조_컨테이너와_마이크로서비스.md)
|
||||
2. [환경 설정](./troubleshooting/)
|
||||
3. [API 문서](./600_appendix/620_주요_스킬_및_로그_예시.md)
|
||||
|
||||
---
|
||||
|
||||
## 팀 소개
|
||||
|
||||
- **김종태**: 프로젝트 리더, 비전 설계
|
||||
- **황한용**: 기술 리드, 아키텍처 설계
|
||||
- **희재**: 풀스택 개발, 스킬 시스템
|
||||
- **강일신**: AI 연구, 프롬프트 엔지니어링
|
||||
|
||||
---
|
||||
|
||||
> "로빙과 함께라면, 당신은 더 이상 혼자가 아닙니다."
|
||||
|
||||
*Last Updated: 2025.01.31*
|
||||
@ -6,7 +6,11 @@
|
||||
|
||||
이 문서는 **개발 블로그**이자 **책 원고**의 이중 목적으로 작성되었습니다.
|
||||
|
||||
### 목차 (로빙: 존재형 에이전트의 탄생)
|
||||
- **Book**: 개념·아키텍처·철학 중심의 비교적 안정된 본문 (`./book/`, `100_philosophy`~`700_for_robeing`)
|
||||
- **Journey**: 시행착오와 실험이 담긴 개발 여정 인덱스 (`./journey/`)
|
||||
- **Dev Docs**: 트러블슈팅, 아이디어, 계획, 연구 등 실행 중심 문서 (`./troubleshooting/`, `./ideas/`, `./plans/`, `./research/`, `./IR/`)
|
||||
|
||||
### Book 목차 (로빙: 존재형 에이전트의 탄생)
|
||||
|
||||
#### Part 1: 철학과 배경 (100_philosophy)
|
||||
- [110. 왜 AI에게 존재를 기대하는가?](./100_philosophy/110_왜_AI에게_존재를_기대하는가.md)
|
||||
@ -67,6 +71,7 @@
|
||||
- [아키텍처 문서](./300_architecture/)
|
||||
- [연구 자료](./research/README.md)
|
||||
- [IR 자료](./IR/)
|
||||
- [Journey: 개발 여정 인덱스](./journey/README.md)
|
||||
|
||||
### 번호 체계
|
||||
- **첫 번째 자리**: Part 번호
|
||||
|
||||
|
Before Width: | Height: | Size: 163 KiB After Width: | Height: | Size: 163 KiB |
|
Before Width: | Height: | Size: 160 KiB After Width: | Height: | Size: 160 KiB |
18
book/README.md
Normal file
18
book/README.md
Normal file
@ -0,0 +1,18 @@
|
||||
# Book: 로빙(RO-BEING) 존재형 에이전트의 탄생
|
||||
|
||||
이 섹션은 로빙 프로젝트를 **책 형태로 읽기 위한 본문**입니다.
|
||||
변경 주기가 비교적 낮은 개념·아키텍처·철학 중심 문서를 모았습니다.
|
||||
|
||||
## 구성
|
||||
|
||||
- `000_프로젝트_종합_v3.md` – 전체 개요
|
||||
- Part 1: 철학과 배경 – `DOCS/100_philosophy/`
|
||||
- Part 2: 핵심 설계 – `DOCS/200_core_design/`
|
||||
- Part 3: 기술 아키텍처 – `DOCS/300_architecture/`
|
||||
- Part 4: 성장과 진화 – `DOCS/400_growth/`
|
||||
- Part 5: 비즈니스와 미래 – `DOCS/500_business/`
|
||||
- Part 6: 부록 – `DOCS/600_appendix/`
|
||||
- Part 7: 로빙을 위한 가이드 – `DOCS/700_for_robeing/`
|
||||
|
||||
자세한 챕터 목록은 상위 `DOCS/README.md`의 목차를 참고하세요.
|
||||
|
||||
13
journey/README.md
Normal file
13
journey/README.md
Normal file
@ -0,0 +1,13 @@
|
||||
# Journey: 개발 여정 인덱스
|
||||
|
||||
이 폴더는 로빙 프로젝트의 **개발 여정**을 모아서 보는 인덱스입니다.
|
||||
원본 문서는 그대로 `troubleshooting/`, `ideas/`, `plans/`, `research/`에 두고, 여기서는 “어떤 여정에서 어떤 문서를 참고해야 하는지”만 정리합니다.
|
||||
|
||||
## 구성
|
||||
|
||||
- `troubleshooting_journey.md` – 사건/장애 중심의 여정
|
||||
- `ideas_and_plans_journey.md` – 아이디어·계획·실행 기록
|
||||
- `research_journey.md` – 논문·실험 기반 개선 여정
|
||||
|
||||
각 파일에서 관련 문서를 링크로만 참조합니다.
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
x
Reference in New Issue
Block a user