관리

시스템 구성 및 관리 설정.

접근: 탐색 레일 → 설정

설정 패널

설정 패널은 카테고리별로 구성됩니다:

┌─────────────────────────────────────────────────────────┐
│ 설정                                                    │
├─────────────────────────────────────────────────────────┤
│                                                         │
│ 카테고리:                                               │
│ • 일반                       ← 현재                   │
│ • LLM 제공자                                           │
│ • 채널                                                 │
│ • 데이터 보존                                          │
│ • 보안                                                 │
│ • 고급                                                 │
│                                                         │
└─────────────────────────────────────────────────────────┘

일반 설정

시스템 구성

일반 설정

시스템 이름
[내 AI 인력                       ]

기본 언어
[English ▼]

시간대
[Asia/Seoul ▼]

날짜 형식
[YYYY/MM/DD ▼]

표시 기본 설정

표시

테마
○ 라이트  ● 다크  ○ 자동

밀도
○ 편안함  ● 컴팩트

사이드바
☑️ 기본적으로 라이브 피드 표시
☑️ 완료된 작업 자동 축소
☐ 목록에서 에이전트 아바타 표시

알림

알림 기본 설정

인앱 알림
☑️ 데스크톱 알림 활성화
☑️ 알림 시 소리 재생
☐ 제목에 알림 수 표시

이메일 알림
☐ 일일 요약 본문
☐ 시스템 오류 시 알림
☐ 주간 분석 보고서

LLM 제공자 설정

사용할 AI 모델을 구성합니다.

제공자 우선순위

LLM 제공자 우선순위

CapiBot에 AI가 필요할 때 이 순서로 제공자를 시도:

1. 🥇 Anthropic Claude
2. 🥈 Google Gemini
3. 🥉 Kimi (Moonshot)
4.    GLM (Zhipu AI)
5.    MiniMax
6.    Ollama (로컬)

[제공자 추가] [재정렬]

장애 조치 작동 방식:

기본 제공자 (Claude)가 요청 시도
실패하면 자동으로 다음 구성된 제공자 시도
성공하거나 모두 실패할 때까지 계속

제공자 구성

Anthropic:

API Key: [sk-ant-********************************    ]
모델: [Claude 3.5 Sonnet ▼]
최대 토큰: 4096
온도: 0.7
[연결 테스트]

Ollama (로컬):

Base URL: [http://localhost:11434           ]
모델: [llama3.1:latest ▼]
[모델 새로고침]

Google Gemini:

API Key: [************************************    ]
모델: [Gemini 1.5 Pro ▼]
[키 확인]

모델 재정의

에이전트별 모델 선택:

Morgan (CEO) → Claude (기본값)
Nova (엔지니어) → Gemini (더 빠른 코딩)
Scout (연구) → Claude (더 나은 분석)

채널 설정

메시징 채널을 구성합니다.

Telegram 봇 구성

봇 토큰: [123456789:ABCdefGHIjkl...      ]
상태: ✅ 연결됨
봇 사용자명: @MyCapiBot

사용자 화이트리스트
☑️ 화이트리스트 활성화
허용된 사용자: @username1, @username2
☐ 모든 사용자 허용 (권장하지 않음)

기능
☑️ 음성 메시지 전사
☑️ 파일 처리
☑️ 타이핑 표시기
[저장] [연결 테스트]

WhatsApp Business API

API Key: [********************************    ]
전화번호: +1 (555) 123-4567
상태: ✅ 연결됨

웹훅 URL: https://your-domain.com/webhooks/whatsapp
확인 토큰: [********************************    ]

미디어 처리
☑️ 이미지 다운로드
☑️ 문서 다운로드
☐ 오디오 다운로드 (저장소 필요)
최대 파일 크기: 16 MB
[저장] [테스트 메시지]

Slack

Slack 앱 구성

봇 토큰: [xoxb-1234-5678-...              ]
상태: ✅ 연결됨
워크스페이스: MyWorkspace

채널
#general — ✅ 활성
#engineering — ✅ 활성
#marketing — ⏸️ 일시 중지

기능
☑️ 스레드 인식 메시징
☑️ 서식 있는 텍스트
☑️ 파일 공유
[저장] [채널에 초대]

데이터 보존

데이터를 얼마나 오래 보관할지 제어.

데이터 보존 정책

자동 정리가 오래된 데이터를 자동으로 제거합니다.

활동        [30 ▼]일 동안 보관
알림        [7 ▼]일 동안 보관
감사 로그   [90 ▼]일 동안 보관
통신/메시지 [15 ▼]일 동안 보관
웹훅 내역   [30 ▼]일 동안 보관
추적        [30 ▼]일 동안 보관
파일        [90 ▼]일 동안 보관
완료된 작업 [365 ▼]일 동안 보관

☑️ 자동 정리 활성화
☐ 삭제 전 보관
[변경 사항 저장]

자동 정리를 하는 이유:

데이터베이스 크기 감소
성능 향상
개인 정보 보호 유지
비용 제어

중요한 데이터는 절대 삭제되지 않음:

활성 작업
에이전트 메모리
지식 베이스
기업 정보
설정

보안 설정

인증

인증

API Key 인증
마스터 API Key: [CAPIBOT_************************    ]
[재생성] [복사]

세션 설정
세션 기간: [7 ▼]일
☑️ 보안 쿠키 필요
☑️ IP 주소 검증
☐ 사용자당 여러 세션 허용

개발 모드
☐ 개발 모드 활성화 (⚠️ 프로덕션용이 아님)

접근 제어

접근 제어

IP 화이트리스트
☐ IP 제한 활성화
허용된 IP: 192.168.1.0/24, 10.0.0.5

사용자 화이트리스트 (Telegram)
@username1, @username2, @username3
☐ 모든 Telegram 사용자 허용

호스트 화이트리스트
localhost, capibot.io, *.internal.com

콘텐츠 보안

콘텐츠 보안 정책

☑️ CSP 헤더 활성화
☑️ 인라인 스크립트 차단
☑️ 객체 소스 제한
☑️ 양식 작업 검증

셸 보안
☑️ 위험한 셸 패턴 차단
☑️ 작업 공간으로 제한
☑️ 명령 시간 초과 (기본값: 30초)
최대 셸 출력: 호출당 ~10KB

고급 설정

시스템 성능

성능

연결 풀링
최대 데이터베이스 연결: [10 ▼]
연결 시간 초과: [30 ▼]초

캐싱
☑️ 응답 캐싱 활성화
캐시 기간: [60 ▼]초

속도 제한
API 속도 제한: 분당 [100 ▼]요청
웹훅 속도 제한: 분당 [100 ▼]요청

로깅

로깅

로그 레벨
[정보 ▼] (디버그, 정보, 경고, 오류)

로그 대상
☑️ 콘솔
☐ 파일: /var/log/capibot/
☐ 외부 (syslog)

민감한 데이터
☐ API 키 로깅 (권장하지 않음)
☐ 전체 프롬프트 로깅
☑️ 민감한 데이터 마스킹

백업 및 복구

백업 설정

자동 백업
☑️ 일일 백업 활성화
백업 시간: [02:00 ▼]
보관: [7 ▼]일

백업 내용
☑️ 데이터베이스
☑️ 파일 저장소
☑️ 구성
☐ 로그

수동 백업
[지금 백업 생성]

마지막 백업: 2024년 12월 14일 오전 2:00
상태: ✅ 성공 (245 MB)
[다운로드] [복원]

사용자 관리

다중 사용자 CapiBot을 실행하는 경우:

사용자 관리

현재 사용자: 3

┌─────────────────┬──────────────┬────────────┐
│ 사용자          │ 역할         │ 마지막 활동│
├─────────────────┼──────────────┼────────────┤
│ admin@capibot.io│ 관리자       │ 2분 전     │
│ user1@company.io│ 사용자       │ 1시간 전   │
│ user2@company.io│ 사용자       │ 1일 전     │
└─────────────────┴──────────────┴────────────┘

[사용자 초대] [사용자 납품]

사용자 역할

관리자:

전체 시스템 접근
설정 관리
사용자 관리
감사 로그 보기

사용자:

기업 생성/관리
할당된 에이전트 관리
자신의 작업 보기
제한된 설정 접근

가져오기 / 납품하기

데이터 납품

데이터 납품

납품할 것
☑️ 기업 및 팀
☑️ 에이전트 및 구성
☑️ 작업 및 내역
☑️ 지식 베이스
☐ 로그 및 추적

형식
● JSON (기계 판독 가능)
○ Markdown (인간 판독 가능)
○ CSV (스프레드시트)

[데이터 납품]

데이터 가져오기

데이터 가져오기

⚠️ 가져오기는 기존 데이터와 병합됩니다.
충돌 항목은 건너뜁니다.

파일 선택: [찾아보기...]
지원 형식: .json, .zip

[가져오기 미리보기] [데이터 가져오기]

시스템 정보

시스템 상태 보기:

시스템 정보

버전: CapiBot v1.2.3
빌드: 2024.12.15-abc123
라이선스: MIT (오픈 소스)

런타임
Node.js: v20.10.0
가동 시간: 14일, 3시간
메모리: 2.3GB / 8GB

데이터베이스
PostgreSQL: 16.1
크기: 1.2 GB
연결: 3 / 10

업데이트 확인
현재: v1.2.3
최신: v1.2.3 ✅ 최신 상태

모범 사례

구성

변경 사항 문서화 — 설정을 변경한 이유 메모
먼저 테스트 — 개발 환경에서 변경 시도
먼저 백업 — 주요 변경 전에
보수적으로 시작 — 점진적으로 강화
정기적으로 검토 — 월간 설정 감사

보안

강력한 API 키 — 자동 생성된 키 사용
정기적인 순환 — 90일마다
최소 권한 — 필요한 최소한의 접근
로그 모니터링 — 이상 활동 감시
업데이트 유지 — 최신 버전의 보안 패치

성능

적절한 풀 크기 — 사용량에 맞는 DB 연결
현명하게 캐싱 — 동적 콘텐츠는 캐싱하지 않기
정기적으로 정리 — 오래된 데이터 자동 정리
리소스 모니터링 — 메모리와 디스크 주시
쿼리 최적화 — 느린 쿼리 로그 확인

문제 해결

설정이 저장되지 않음:

권한 확인
값이 유효한지 확인
오류 메시지 검토
페이지 새로고침 시도

연결 테스트 실패:

API 키 확인
네트워크 연결 확인
방화벽 규칙 검토
서비스 상태 확인

성능 문제:

연결 풀 크기 낮추기
캐시 기간 줄이기
자동 정리 활성화
데이터베이스 크기 확인

보안 경고:

감사 로그 검토
접근 패턴 확인
화이트리스트 확인
손상된 키 순환

관리