> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloosphere.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 관리자 패널

> 사용자, 조직, 시스템 설정, 채널, 모니터링, 평가 등 관리자 기능 전체 안내

<Info>사용자 프로필 › 관리자 패널</Info>

관리자 패널은 Cloosphere 플랫폼 전체를 운영하는 중앙 관리 인터페이스입니다.

* 사용자 관리, 조직 구조, LLM 연결, 보안 정책, 알림 채널 등 플랫폼의 모든 설정을 제어합니다.

<Frame caption="관리자 패널 진입 경로 및  메인 화면">
  <img src="https://mintcdn.com/cloocus/Jjr6o_i720oXQtQO/images/admin/overview-main.png?fit=max&auto=format&n=Jjr6o_i720oXQtQO&q=85&s=37f2bc8a16fb008ed7cf3e09acac2d4d" alt="관리자 패널 진입 경로 및  메인 화면" width="4320" height="2700" data-path="images/admin/overview-main.png" />
</Frame>

<Note>
  관리자 패널은 **Admin** 역할을 가진 사용자만 접근할 수 있습니다. 일반 사용자(User)에게는 관리자 메뉴가 표시되지 않습니다.
</Note>

<Columns cols={4}>
  <Card title="사용자" icon="users" href="/ko/admin/users">
    사용자 목록·역할 할당, 그룹 권한, 조직 관리, 문의 처리
  </Card>

  <Card title="설정" icon="gear" href="/ko/admin/settings/general">
    LLM 연결·문서·검색·가드레일·채널·코드 게이트웨이·라이선스 등 설정 탭
  </Card>

  <Card title="모니터링" icon="chart-line" href="/ko/monitoring/overview">
    대시보드·사용량·감사·가드레일·대화·파일 로그
  </Card>

  <Card title="평가" icon="star" href="/ko/monitoring/evaluations">
    아레나·리더보드·피드백·자동 평가·추적
  </Card>
</Columns>

***

## 역할별 접근 권한

Cloosphere는 세 가지 사용자 역할을 제공합니다.

* 관리자 패널 접근은 역할에 따라 결정됩니다.

| 역할          |   관리자 패널   |   워크스페이스  |     채팅    |
| ----------- | :--------: | :-------: | :-------: |
| **Admin**   |    전체 접근   |   전체 접근   |   전체 접근   |
| **User**    | 접근 불가 (기본) | 그룹 권한에 따름 | 그룹 권한에 따름 |
| **Pending** |    접근 불가   |   접근 불가   |   접근 불가   |

<Tip>
  그룹 권한 설정을 통해 일반 사용자에게도 관리자 기능의 일부(사용자 관리, 모니터링 등)를 읽기 또는 쓰기 수준으로 위임할 수 있습니다. 자세한 내용은 [그룹 및 권한](/ko/admin/groups) 페이지를 참고하세요.
</Tip>

***

## 관리자 패널 네비게이션

관리자 패널은 상단 탭 네비게이션으로 각 기능 영역을 전환합니다.

```mermaid theme={null}
flowchart LR
    A[관리자 패널] --> B["<b>사용자</b><br/>사용자 · 그룹 · 조직 · 문의"]
    A --> C["<b>설정</b><br/>일반·연결·모델 · 지식·문서·검색 · AI 기능·안전<br/>UI·채널 연동 · 데이터·운영 보안"]
    A --> F["<b>모니터링</b><br/>대시보드·사용량 · 감사·KMS·가드레일 · 대화·파일 로그"]
    A --> G["<b>평가</b><br/>평가·자동 평가 · 아레나·리더보드 · 피드백·추적"]
```

각 탭을 클릭하면 해당 영역의 하위 메뉴와 이동 경로를 확인할 수 있습니다.

<Tabs>
  <Tab title="사용자">
    사용자 계정·권한·조직을 관리합니다.

    | 항목                                | 설명                                       |
    | --------------------------------- | ---------------------------------------- |
    | [**사용자**](/ko/admin/users)        | 사용자 목록, 역할(Admin/User/Pending) 할당, 상태 관리 |
    | [**그룹 및 권한**](/ko/admin/groups)   | 그룹 생성 및 기능별 권한 위임                        |
    | [**조직**](/ko/admin/organizations) | 조직 구조 관리, Keycloak 동기화                   |
    | [**문의**](/ko/admin/inquiries)     | 사용자 문의 접수 및 처리                           |
  </Tab>

  <Tab title="설정">
    LLM 연결부터 문서·검색·보안·채널·UI까지 플랫폼 전체 구성을 관리합니다.

    **일반 및 연결**

    | 탭                                        | 설명                               |
    | ---------------------------------------- | -------------------------------- |
    | [**일반**](/ko/admin/settings/general)     | 인증, 기본 역할, 로그 수준, 사용량 제한         |
    | [**연결**](/ko/admin/settings/connections) | OpenAI, Ollama 등 LLM Provider 연결 |
    | [**모델**](/ko/admin/settings/models)      | 모델 목록 관리, 기본 모델 지정, 모델 필터        |

    **지식 및 문서**

    | 탭                                                   | 설명                                     |
    | --------------------------------------------------- | -------------------------------------- |
    | [**문서**](/ko/admin/settings/documents)              | 임베딩 엔진/모델, 청크 크기, Vector DB 설정         |
    | [**문서 템플릿**](/ko/admin/settings/document-templates) | 문서 생성용 PPT·Word·Excel 마스터 템플릿          |
    | [**검색 엔진**](/ko/admin/settings/search-engine)       | Azure Search, Elasticsearch 등 검색 엔진 연결 |
    | [**웹 검색**](/ko/admin/settings/web-search)           | SearXNG, Google PSE, Bing 등 웹 검색 엔진    |

    **AI 기능 및 안전**

    | 탭                                              | 설명                                          |
    | ---------------------------------------------- | ------------------------------------------- |
    | [**가드레일**](/ko/admin/settings/guardrails)      | 전역 가드레일, 파일 업로드 보안 검사                       |
    | [**코드 실행**](/ko/admin/settings/code-execution) | 코드 인터프리터 (Jupyter/Sandbox) 설정               |
    | [**코드 게이트웨이**](/ko/admin/code-gateway)         | AI 코딩 도구(Claude Code·Cursor 등)용 LLM API 프록시 |
    | [**오디오**](/ko/admin/settings/audio)            | STT/TTS 엔진 및 모델 설정                          |
    | [**이미지**](/ko/admin/settings/images)           | 이미지 생성 엔진 (DALL-E, Stable Diffusion)        |

    **UI 및 채널 연동**

    | 탭                                              | 설명                         |
    | ---------------------------------------------- | -------------------------- |
    | [**인터페이스**](/ko/admin/settings/interface)      | UI 커스터마이징, 기본 프롬프트, 랜딩 페이지 |
    | [**브랜딩**](/ko/admin/settings/branding)         | 로고, 파비콘, 색상, 로그인 화면 커스터마이징 |
    | [**채널**](/ko/admin/notifications)              | 이메일·웹훅 알림 채널               |
    | [**봇 연결**](/ko/admin/teams-bot)                | Microsoft Teams 봇 양방향 통합   |
    | [**임베드 위젯**](/ko/admin/settings/embed-widgets) | 외부 웹사이트 삽입용 채팅 위젯          |

    **데이터 및 운영 보안**

    | 탭                                               | 설명                        |
    | ----------------------------------------------- | ------------------------- |
    | [**데이터 보존**](/ko/admin/settings/data-retention) | 로그·트레이스 자동 정리 보존 기간       |
    | [**메모리**](/ko/admin/settings/memory)            | 메모리 추출 모델, 신뢰도, 보존 정책     |
    | [**모니터링**](/ko/admin/settings/monitoring)       | OpenTelemetry 및 관측성 스택 배포 |
    | [**데이터베이스**](/ko/admin/settings/database)       | Config·DB 백업/이관, 채팅 내보내기  |
    | [**암호화**](/ko/admin/settings/encryption)        | 민감 설정값 KMS 암호화, 무결성 감사    |
    | [**라이선스**](/ko/admin/settings/license)          | 라이선스 키 관리, 기능 활성화         |
  </Tab>

  <Tab title="모니터링">
    플랫폼 운영 지표와 로그를 조회합니다.

    | 항목                                            | 설명               |
    | --------------------------------------------- | ---------------- |
    | [**대시보드**](/ko/monitoring/dashboard)          | 커스텀 패널·필터        |
    | [**사용량**](/ko/monitoring/usage)               | 모델·사용자별 토큰·요청 통계 |
    | [**감사 로그**](/ko/monitoring/audit-logs)        | 관리자 활동 감사 기록     |
    | [**KMS 감사**](/ko/monitoring/kms-audit)        | 암호화 키 사용 감사      |
    | [**가드레일 로그**](/ko/monitoring/guardrail-logs)  | 가드레일 차단·플래그 기록   |
    | [**대화 로그**](/ko/monitoring/conversation-logs) | 대화 요청·토큰 로그      |
    | [**파일 로그**](/ko/monitoring/file-logs)         | 파일 업로드 보안 검사 로그  |
  </Tab>

  <Tab title="평가">
    모델 응답 품질을 평가·추적합니다.

    | 항목                                                 | 설명                  |
    | -------------------------------------------------- | ------------------- |
    | [**평가 개요**](/ko/monitoring/evaluations)            | 평가 대시보드             |
    | [**아레나 · 리더보드**](/ko/monitoring/arena-leaderboard) | 모델 비교·랭킹            |
    | [**피드백**](/ko/monitoring/feedback)                 | 사용자 응답 평가(승리·패배) 기록 |
    | [**자동 평가**](/ko/monitoring/auto-evaluations)       | LLM 기반 자동 품질 평가     |
    | [**추적**](/ko/monitoring/tracing)                   | 실행 추적(트레이스) 분석      |
  </Tab>
</Tabs>

***

## 빠른 시작

<Steps>
  <Step title="LLM 연결 설정">
    [연결](/ko/admin/settings/connections) 설정에서 OpenAI API 키 또는 Ollama 서버 URL을 등록합니다.
  </Step>

  <Step title="사용자 관리">
    [사용자 관리](/ko/admin/users)에서 사용자를 추가하고 역할을 할당합니다. 그룹을 생성하여 권한을 체계적으로 관리합니다.
  </Step>

  <Step title="보안 설정">
    [일반](/ko/admin/settings/general) 설정에서 인증 방식, JWT 만료 시간, 회원가입 허용 여부를 구성합니다.
  </Step>

  <Step title="알림 채널 구성">
    [채널 설정](/ko/admin/notifications)에서 이메일 또는 웹훅 채널을 등록하여 예약 작업 알림을 활성화합니다.
  </Step>
</Steps>

***

## 서비스 요청 (SR)

관리자가 Cloosphere 운영팀에 <strong>서비스 요청(사용량 증가, 기능 문의, 버그 리포트 등)</strong>을 직접 제출하는 기능입니다.

### 활성화 조건

환경변수 `SR_KEY`와 `CLOOCUS_PUBLIC_URL`이 **모두 설정**되어야 활성화됩니다.

* 설정되지 않으면 메뉴가 표시되지 않습니다.

### 사용 방법

<Steps>
  <Step title="사용자 메뉴에서 서비스 요청 선택">
    사이드바 하단의 **사용자 아바타**를 클릭하고 드롭다운에서 \*\*"서비스 요청"\*\*을 선택합니다.

    <Frame>
      <img src="https://mintcdn.com/cloocus/Jjr6o_i720oXQtQO/images/admin/overview-sr-menu.png?fit=max&auto=format&n=Jjr6o_i720oXQtQO&q=85&s=779133e333ac35490e4d15f76b1b875b" alt="사용자 아바타 드롭다운 메뉴의 서비스 요청 항목" style={{ maxWidth: '360px' }} width="1260" height="1350" data-path="images/admin/overview-sr-menu.png" />
    </Frame>
  </Step>

  <Step title="요청 작성 후 제출">
    제출 모달에서 유형·제목·콘텐츠를 입력한 뒤 **제출**합니다.

    <Frame>
      <img src="https://mintcdn.com/cloocus/Jjr6o_i720oXQtQO/images/admin/overview-sr-modal.png?fit=max&auto=format&n=Jjr6o_i720oXQtQO&q=85&s=86ca524b0f1b3b3eabbc17fd6ea1e656" alt="서비스 요청 제출 모달 — 유형·제목·콘텐츠 입력" style={{ maxWidth: '520px' }} width="1890" height="1260" data-path="images/admin/overview-sr-modal.png" />
    </Frame>
  </Step>
</Steps>

| 필드      | 설명                                       |
| ------- | ---------------------------------------- |
| **유형**  | 요청 유형 — 사용량 한도, 기능 문의, 버그 리포트, 계정/권한, 기타 |
| **제목**  | 요청 제목 (간단한 요약)                           |
| **콘텐츠** | 요청 상세 내용                                 |

<Note>
  요청자 이름과 이메일은 로그인 정보에서 자동으로 첨부됩니다. SR은 **관리자(Admin) 역할**에게만 표시됩니다.
</Note>