문서 목차

KosmosAI v1.0.2운영·관리

플랫폼 설정

KosmosAI 플랫폼 전체의 동작(일반 값, 인프라 연결, AI·모델, 조직·보안)을 정하는 운영 관리자용 화면입니다.

QUANTUM C&S

KosmosAI 플랫폼 전체의 동작(일반 값, 인프라 연결, AI · 모델, 조직 · 보안)을 정하는 운영 관리자용 화면입니다.

메뉴 플랫폼 설정 을 누르면 왼쪽 메뉴가 설정 메뉴로 바뀝니다. 설정 메뉴는 네 묶음으로 나뉘며, 메인 메뉴로 를 누르면 원래 메뉴로 돌아갑니다.

설정 메뉴 한눈에 보기

묶음	메뉴	하는 일
플랫폼	일반	플랫폼 이름, 관리자 이메일, 기본 GPU 할당량, 프로젝트 기본 스토리지, 세션 타임아웃, 기본 사용자 그룹
	알림	이벤트 종류별 알림 받기(본인 설정)
	이메일	비밀번호 재설정 메일 등을 보내는 SMTP 서버
인프라	Kubernetes	클러스터 연결
	S3 스토리지	오브젝트 스토리지 연결과 플랫폼 버킷
	GPU	GPU 현황, 공유 방식, 할당, DRA 템플릿, 원격 GPU
	잡 리소스	분석 · 학습 · 평가 · 전처리 잡의 기본 CPU · 메모리 · GPU
	Observability	추적 · 지표 · 로그 시스템 연결
	OpenSearch	로그 저장소 상태와 보관 정책
	장애 실험	장애 주입 시나리오 실행과 결과(기능이 켜진 사이트에서만 보임)
AI · 모델	Model Registry	MLflow · HuggingFace · AkashiQ · Harbor · Internal 연동
	Inference	서빙 런타임과 배포 템플릿
	Agentic AI	SAMANDA 의 모델 · 도구 · 에이전트 · 프롬프트 · 자동조치 · 지식 에이전트(RAG) 설정
	AI Gateway	모든 LLM 호출을 모으는 게이트웨이의 모델 · 사용량 · API 키
	플로우 템플릿	AI플로우 화면 갤러리의 가이드 대화 템플릿
조직 · 보안	플랫폼 프로필	업종과 앱(기능) 켜고 끄기
	직급 · 직책 · 보안등급	결재 서열과 직책 · 보안등급 목록
	조직 & 도메인	도메인 → 회사 → 공장 마스터
	보안	회원가입 허용 등 보안 설정
	SSO	Keycloak · Google 로그인 연동

각 탭은 주소(/settings?tab=<탭>)를 가지므로 새로고침하거나 링크로 공유해도 같은 탭이 열립니다. 장애 실험 은 /settings/chaos 로 열립니다.

플랫폼

일반

플랫폼 설정 — 일반

항목	설명	규칙
플랫폼 이름	화면에 쓰이는 플랫폼 이름	—
관리자 이메일	플랫폼 관리자 연락처	—
기본 GPU 할당량	새 프로젝트의 기본 GPU 수	—
프로젝트 기본 스토리지(GB)	프로젝트를 만들 때 이 크기로 기본 버킷을 자동으로 만듭니다.	이미 만든 버킷의 크기는 바뀌지 않습니다.
세션 타임아웃	로그인 세션이 만료되기까지의 시간(분)	1~1440분. 설정 후 새로운 로그인부터 적용됩니다.
기본 사용자 그룹	신규 사용자가 가입할 때 자동으로 배정되는 그룹	기본 그룹 없음 선택 가능

값을 바꾼 뒤 저장 을 누르세요.

알림

플랫폼 설정 — 알림

왼쪽 카테고리(일반 · 데이터셋 · 분석 · 자동화 플로우 · SAMANDA · 평가 · 학습 · 추론)를 고르고 이벤트별 스위치를 켜고 끕니다. 변경은 즉시 저장되며, 이 설정은 본인 의 알림 수신 설정입니다(내 프로필 · 접근 토큰의 알림 과 같습니다).

이메일

항목	설명
SMTP 서버 · 포트 · 암호화	메일 서버 접속 정보
사용자명 · 비밀번호	메일 서버 인증 정보
발신자 이메일 · 발신자 이름	보내는 사람 표시

연결 테스트 로 설정이 맞는지 확인하세요. SMTP 가 설정되지 않으면 비밀번호 재설정 메일을 보낼 수 없습니다. 회원가입에는 이메일 인증이 필요하므로 회원가입을 허용하려면 SMTP 를 먼저 설정하세요.

인프라

Kubernetes

플랫폼 설정 — Kubernetes

연결된 클러스터 이름 · 서버 · 컨텍스트가 Kubernetes 연결됨 상자에 보입니다. 연결되지 않았으면 Kubeconfig 파일을 고르거나 내용을 붙여 넣고 컨텍스트 이름(비우면 현재 컨텍스트)을 정해 연결합니다. 연결 테스트, 설정 삭제 버튼이 있습니다.

S3 스토리지

플랫폼 설정 — S3 스토리지

하위 탭	내용
일반 설정	스토리지 연결 — 타입(Ceph RGW · RustFS · MinIO · AWS S3), Endpoint, Region, SSL, Access/Secret Key(저장된 값은 "설정됨" 으로만 표시). 연결 테스트, 설정 삭제. Ceph 이면 Ceph Admin API 설정 에서 팀별 스토리지 사용자 · 한도 · 자격 증명 자동 발급을 켭니다.
버킷 관리	플랫폼 공용 버킷 — 용도와 버킷의 연결, 버킷 만들기 · 삭제, 버킷 내용 보기

참고 스토리지 관리자 API 를 쓸 수 있는 백엔드에서는 그룹 · 개인 스토리지마다 전용 접속 계정 · 버킷 정책 · 한도를 자동으로 만듭니다. 관리자 API 가 꺼진 백엔드는 공용 키로 접근합니다.

GPU

플랫폼 설정 — GPU 관리

하위 탭	내용
개요	GPU Operator 설치 상태 · 버전, 전체 · 할당됨 · 사용 가능 GPU 수, 노드별 GPU(모델 · VRAM · 드라이버 · CUDA)
공유 설정	노드별 GPU 공유 방식 — None · Time-Slicing · MPS · MIG(지원 GPU 만)
GPU 할당	클러스터의 GPU 할당 현황
DRA 템플릿	동적 자원 할당(DRA) 방식으로 GPU 를 요청할 때 쓰는 템플릿
원격 GPU	다른 KosmosAI 클러스터의 GPU 를 요청 · 승인해 공유하는 설정

주의 MIG 구성 변경은 그 GPU 를 쓰는 작업에 영향을 줍니다. 사용 중이 아닐 때 바꾸세요.

잡 리소스

플랫폼 설정 — 잡 리소스

잡 종류	항목
분석 (Analysis)	CPU(cores), Memory(GiB)
학습 (Training)	CPU, Memory, GPU
평가 (Evaluation)	CPU, Memory, GPU
전처리 (Preprocessing)	CPU, Memory

CPU 는 요청값이며 상한은 자동으로 두 배가 됩니다. GPU 0 은 CPU 전용입니다. 메모리 부족으로 잡이 반복해서 종료되면 메모리 기본값을 늘리세요.

참고 이 설정은 새로 만드는 잡에만 적용됩니다. 실행 중인 잡에는 영향이 없고, 각 서비스에 1~2분 안에 반영됩니다. 다시 로드 로 저장된 값을 다시 불러옵니다.

Observability

플랫폼 설정 — Observability

하위 탭	내용
Tracing	OpenTelemetry Collector(활성화 · Endpoint · Sampling Rate), Jaeger UI
Metrics	Prometheus · Grafana
Logging	OpenSearch

각 항목에 연결 테스트 와 설정 저장 이 있습니다. 금융권은 Sampling Rate 100% 를 권장합니다. 여기서 연결한 도구는 Observability 화면에서 씁니다.

OpenSearch

플랫폼 설정 — OpenSearch

영역	내용
클러스터 상태	Status(GREEN 등), 샤드 수, 인덱스 수 · 문서 수, 저장 용량, 노드별 디스크 사용률
보관 정책 (ISM) — 패턴 그룹별	인덱스 패턴마다 Hot → Warm → Cold(S3) → 삭제 단계와 기간. 같은 인덱스에 여러 정책이 맞으면 priority 가 높은 정책이 우선합니다. 새 정책, 편집
Snapshot Repository	영구 보관용 스냅숏 저장소 상태와 스냅숏 검색
인덱스 목록	tier 별 필터, 이름 검색, 인덱스별 수동 스냅숏 · 닫기 · 스냅숏으로부터 복원

장애 실험

시나리오대로 장애를 일부러 주입하고, 그동안 핵심 API 가 정상인지(정상 상태 성공률 · 지연) 측정해 통과/실패 를 판정합니다. 사이트에서 기능이 꺼져 있으면 메뉴가 보이지 않습니다.

장애 실험 — 시나리오

영역	내용
머리글	대상 네임스페이스, 새로고침, Chaos Dashboard 열기
실행 이력	시각 · 시나리오 · 실행자 · 상태 · 성공률 · 판정 사유. 검색과 상태 필터
시나리오	시나리오 카드(이름, 종류, 설명, 가설, 대상, 지속 시간, 기준 성공률, 실행). 종류 필터와 카드/목록 보기

상태	설명
실행 중	장애가 주입되어 측정 중입니다.
통과	정상 상태 성공률이 기준 이상이었습니다.
실패	기준에 못 미쳤습니다.
중단됨	사람이 중단해 장애를 원복했습니다.
오류	실험 자체가 실행되지 못했습니다.

장애 실험 — 실행 이력

1단계: 시나리오 고르기

시나리오 탭에서 카드의 가설과 대상 · 지속 시간을 확인하세요.

2단계: 실행

실행 을 누르면 "이 장애 실험을 실행할까요?" 창에 대상과 주입 시간이 나옵니다. 확인하면 실제 장애가 주입됩니다.

3단계: 관찰

실행 상세에서 시작 · 주입 · 원복 · 종료 시각, 정상상태 타임라인 (10초 버킷), 오류, Chaos 이벤트를 봅니다. 문제가 있으면 중단 을 눌러 즉시 원복하세요(이 실행은 "중단됨" 으로 기록됩니다).

4단계: 결과 확인

실험이 끝나면 리포트 가 저장되고 실행 이력에 판정이 남습니다.

주의 장애 실험은 실제 서비스에 장애를 넣습니다. 운영 환경에서는 영향 범위를 확인한 뒤 실행하세요. 새 실험은 SAMANDA Ops 에게 "(서비스)에 300ms 지연 실험 만들어줘" 처럼 말해 만들 수 있고, 결과는 여기에 보입니다.

AI · 모델

Model Registry

플랫폼 설정 — Model Registry

하위 탭	내용
MLflow	MLflow Tracking Server 연동(활성화, Tracking URI, Artifact S3 경로), 연결 테스트
HuggingFace	HuggingFace Hub 연동(활성화, API 토큰 — 비공개 · gated 모델에 필요, 가져온 모델을 저장할 S3 버킷)
AkashiQ	데이터셋 'AkashiQ Sync' 가 AkashiQ 데이터 레이크를 부를 때 쓰는 API 키. 저장한 키는 다시 표시되지 않으며, 비운 채 저장하면 기존 키를 유지합니다.
Harbor	모델을 컨테이너 이미지(OCI)로 올리고 서빙이 받아 쓰는 저장소. 기본은 클러스터에 설치된 Harbor 이며 외부 Harbor 도 지정할 수 있습니다. 비밀번호는 저장 후 다시 표시되지 않습니다.
Internal	직접 업로드한 모델이 저장되는 S3 버킷

탭 이름 옆 점은 연동이 켜져 있다는 표시입니다.

Inference

플랫폼 설정 — Inference

하위 탭	내용
런타임	클러스터에 등록된 모델 서빙 런타임 목록과 런타임 등록 · 편집 · 삭제
배포 템플릿	추론(서빙)을 만들 때 고르는 배포 템플릿

Agentic AI

SAMANDA 의 동작을 정합니다. 모든 설정은 에이전트를 다시 시작하지 않아도 즉시 반영됩니다. 위쪽 되돌리기 · 저장 은 아래 접이식 설정 묶음에 적용됩니다.

플랫폼 설정 — Agentic AI

카드	하는 일
MCP 도구 관리	SAMANDA 가 쓰는 도구를 켜고 끄고 설명을 고칩니다. 비활성화된 도구는 SAMANDA 가 쓸 수 없습니다. 외부 API 를 부르는 커스텀 도구를 추가할 수 있습니다.
외부 MCP 서버	외부 MCP 서버를 등록해 그 도구를 SAMANDA 에게 노출합니다.
내부 MCP 서버	플랫폼 내장 도구 목록(읽기 전용)
커스텀 MCP 도구	외부 MCP 도구에 전/후 필터를 붙여 새 도구를 만듭니다.
에이전트 관리	에이전트 생성 · 구성 · 버전 관리(프롬프트 + 스킬 + 도구 + 플로우)
Laya 위임 라우터	메인 SAMANDA 가 질문을 어느 하위 에이전트에 맡길지 고르는 판정 모델의 주소 · 모델 이름 · 동작 모드(off · shadow · hint · auto) · 자동 위임 임계값(0~1) · 타임아웃. 질문을 넣어 시험 할 수 있습니다.
프롬프트 관리	에이전트별 시스템 프롬프트 버전 관리와 A/B 테스트
자동조치 카탈로그	사고 종류별 자동 · 승인 조치 목록과 등급(T0~T3)
장애 사례 KB	시스템 · 자산 장애 조치 사례. 비슷한 사고가 나면 SAMANDA Ops 가 찾아 답변에 인용합니다.
Ops 관제 네임스페이스	SAMANDA 가 직접 감시하는 작업 공간 목록

Agentic AI — 자동조치 카탈로그

등급	설명
T0 자동	정보 수집만, 부작용 없음 — 즉시 자동 실행
T1 자동	학습된 안전 회복(Pod 재시작 등) — 즉시 자동 실행
T2 승인	사용자 승인 후 실행
T3 금지	자동 실행 금지(사람만)

접이식 설정 묶음:

묶음	설명
LLM — app 프로파일	SAMANDA 에이전트의 기본 LLM 엔드포인트와 샘플링 값. OpenAI 호환 엔드포인트면 연결할 수 있습니다.
Embedding (의미 기억)	과거 대화를 의미로 찾기 위한 임베딩 서비스
메모리 행동	세션 지속 시간, 대화 버퍼 크기, 자가 반성 주기
에이전트 루프	한 번 답할 때 도구를 연속으로 부를 수 있는 최대 횟수(기본 16)
Judge LLM	쓰기 · 파괴적 도구 실행 전에 독립 LLM 이 계획을 검토
코딩 특화 LLM — code 프로파일	코딩 관련 질문을 보낼 모델
지식 에이전트 (RAG)	지식대화의 LLM, 문서 처리용 LLM, 임베딩, 재정렬(Reranker), 이미지 · 표 해석(VLM), OCR, 벡터 DB, 문서 파서, 검색 루프, 청킹 전략
이미지 분석 (Vision)	채팅 이미지 첨부를 보낼 비전 모델. 끄면 이미지 첨부가 막힙니다.
음성 입력 (STT)	마이크 입력을 글로 바꾸는 서비스. 끄면 마이크 버튼이 사라집니다.
음성 출력 (TTS)	SAMANDA Ops 음성 응답. 이 브라우저에만 저장됩니다.
Sandbox 이미지	SAMANDA 가 사용자별 작업을 쌓는 전용 작업 환경 이미지
웹 검색	외부 웹 검색 사용 여부(기본 꺼짐). 외부망이 막힌 환경에서는 꺼 두세요.
AkashiQ Kafka	제조 설비 센서 실시간 스트림 구독

Agentic AI — 지식 에이전트(RAG)

참고 지식 에이전트(RAG) 설정은 변경 후 30초 안에 자동 반영됩니다. 임베딩 모델을 바꾸면 기존 지식기반 문서를 다시 처리해야 합니다.

AI Gateway

플랫폼 설정 — AI Gateway

모든 LLM 호출을 모으는 단일 게이트웨이입니다. 오른쪽 위에 상태(정상 · 모델 수)가 보입니다.

하위 탭	내용
모델 & 라우팅	모델 · 용도 · 위치(내부/외부) · 백엔드 목록. 내부 모델은 추론 화면에서 노출하고, 외부 프로바이더 모델은 외부 모델 추가 로 넣습니다.
사용량 & 비용	게이트웨이를 거친 LLM 호출의 사용량과 비용
API 키	게이트웨이 API 키 발급 · 회수. 키마다 허용 모델(비우면 모든 모델)과 예산 · 기간을 제한할 수 있습니다. 발급된 키는 발급 직후 한 번만 보이며, 게이트웨이는 키를 해시로만 보관합니다.
콘솔 & 정책	게이트웨이 관리 콘솔 열기(별도 로그인 필요), 그룹 · 사용자별 모델 공개는 IGA(권한 관리)의 AI 거버넌스 로 안내

플로우 템플릿

AI플로우 화면 위쪽 갤러리에 보이는 가이드 대화 템플릿을 관리합니다. 새 템플릿 에서 Slug, 이름, 설명, 카테고리, 아이콘, 순서, 색상, 프롬프트(가이드 지시문)를 정하고, 템플릿마다 활성화 · 비활성화 · 삭제할 수 있습니다(삭제할 때는 delete 입력). 템플릿이 없으면 서비스가 시작될 때 기본 8개가 만들어집니다.

조직 · 보안

참고 플랫폼 프로필, 직급 · 직책 · 보안등급, 조직 & 도메인 은 보안관리자가 정합니다. 운영 관리자에게는 "…보안관리자가 정합니다 — 조회만 할 수 있습니다(직무 분리)." 안내와 함께 읽기 전용으로 보입니다. 보안관리자는 플랫폼 설정에서 이 세 탭만 봅니다.

플랫폼 프로필

항목	설명	규칙
업종	제조 · 금융 · 공공 중 해당하는 것(여러 개 가능)	고른 업종이 없으면 공통 기능(LLMOps · MLOps)만 씁니다.
앱(기능)	자산(제조 AX 앱 — 자산 · 자산 타입 · 제조 · 시뮬레이션) 켜기/끄기	제조를 새로 고르면 자산을 켜자고 제안하지만 끌 수 있습니다. 끄면 메뉴가 사라지고 자산 API 도 닫힙니다(조직 & 도메인 마스터는 남습니다).

저장하면 메뉴가 바로 바뀝니다.

직급 · 직책 · 보안등급

플랫폼 설정 — 직급·직책·보안등급

항목	설명	규칙
직급 → 결재 서열	직급마다 서열 0~10	같은 서열에 여러 직급을 둘 수 있습니다. 직급의 서열을 바꾸면 그 직급인 사용자의 서열도 다시 맞춥니다.
임원 기준 서열	이 서열 이상이면 임원	임원은 팀장 결재를 건너뛰고 임원 결재자가 됩니다.
직책	팀장 · 본부장 등	서열이 아닙니다(과장이 팀장일 수 있습니다).
보안등급	정보 취급 인가 등급(예: 대외비)	숫자가 클수록 높은 등급입니다. IGA 정책 조건에서 "등급 2 이상" 처럼 씁니다.

사용자 편집 화면의 직급 · 직책 선택 목록은 여기서 온 값입니다.

조직 & 도메인

자산(제조 AX) 기능의 마스터 데이터입니다. 계층은 도메인(업종, 예: 제약 · 반도체 · 자동차) → 회사 → 공장 → 자산입니다. 도메인은 기본 제공 팩에서 만들어지고, 고객은 회사 · 공장을 입력합니다. 도메인마다 역할 카탈로그와 기본 지식(자산 명세서 시드)을 편집할 수 있습니다.

보안

플랫폼 설정 — 보안

항목	설명
회원가입 허용	신규 사용자가 이메일로 직접 가입할 수 있게 합니다. 이메일 인증이 필요하므로 SMTP 를 먼저 설정하세요. Keycloak 전용 모드가 켜져 있으면 SSO 설정에서 전용 모드를 해제해야 로컬 회원가입을 쓸 수 있습니다.
추가 보안 설정 (준비 중)	2단계 인증(2FA), IP 화이트리스트, 비밀번호 정책 선택은 준비 중이라 바꿀 수 없습니다. 감사 로그는 항상 활성화되어 있습니다.

참고 현재 적용되는 비밀번호 규칙은 "대문자 · 소문자 · 숫자 · 특수문자 중 3종류 이상 8자 이상, 또는 2종류 이상 10자 이상" 입니다. 내 프로필 · 접근 토큰을 보세요.

SSO

항목	설명
Keycloak SSO 활성화	Keycloak 을 통한 SSO 로그인
Keycloak 전용 모드	일반 로그인을 끄고 Keycloak 으로만 로그인
Google 로그인 활성화	Google 계정 로그인. Google Cloud Console 의 OAuth 2.0 Client ID 와, 화면에 표시되는 Redirect URI 를 Google 쪽에 등록해야 합니다.

비밀값(클라이언트 시크릿 등)은 저장 후 다시 표시되지 않습니다. 바꾸려면 새 값을 입력하세요.

정보

버전 정보

설치된 KosmosAI의 버전과 구성 요소, 사용된 오픈소스 목록(SBOM)을 확인합니다. 운영 관리자와 보안 관리자 모두 볼 수 있으며, 읽기 전용입니다.

버전 탭

버전 정보 — 플랫폼 버전과 서비스별 버전(1.0.0 발행 직전 빌드 화면)

항목	설명
플랫폼 버전	설치된 KosmosAI 제품 버전(예: KosmosAI 1.0.0)입니다. 매뉴얼의 버전과 같습니다.
KosmosAI 서비스	포털과 각 API 서비스의 버전과 빌드(커밋) 식별자입니다.
플랫폼 구성 요소	함께 배포되는 오픈소스 구성 요소(인증 · 게이트웨이 · 데이터베이스 · 메시지 큐 등)의 버전입니다.
상태	이 설치에서 쓰는지(사용 / 사용 안 함) 표시합니다.
배포 리비전	배포한 횟수입니다. 배포할 때마다 이 화면의 정보가 자동으로 갱신됩니다.

SBOM 탭

SBOM — 오픈소스 구성 요소와 라이선스

SBOM(Software Bill of Materials)은 KosmosAI를 이루는 오픈소스 구성 요소와 라이선스 목록입니다.

항목	설명
구성 요소 수	Python 패키지(의존성 포함), JavaScript 패키지, 컨테이너 이미지, 선행 스택(설치에 필요한 별도 구성 요소)으로 나눠 셉니다.
라이선스 분포	라이선스별 개수입니다. 누르면 그 라이선스로 목록을 거릅니다.
확인할 라이선스	카피레프트(GPL · LGPL · AGPL)나 사용 조건이 있는 라이선스(SSPL · RSAL 등)는 노란색으로 표시하고, 이것만 보기로 모아 볼 수 있습니다.
검색 · 구분	이름 · 라이선스 · 사용처로 찾고, 구분(Python · JavaScript · 컨테이너 · 선행 스택)으로 거릅니다.
내려받기	CycloneDX(JSON)은 표준 SBOM 형식 원본, CSV는 지금 보이는 목록입니다.

참고 SBOM은 버전을 발행할 때마다 다시 만들어집니다. 화면 위쪽에 형식(CycloneDX 1.5)과 생성 시각이 표시됩니다.

권한

역할	허용 작업
운영 관리자(`platform:operation` Admin)	모든 탭 보기 · 변경. 단 플랫폼 프로필 · 직급 · 직책 · 보안등급 · 조직 & 도메인은 조회만
보안관리자(`auth:policy` Deny)	플랫폼 프로필 · 직급 · 직책 · 보안등급 · 조직 & 도메인 탭만 보기 · 변경
그 밖의 사용자	메뉴가 보이지 않습니다.