핵심 개념

KosmosAI를 쓰기 전에 알아 두면 좋은 개념 — 권한(IGA·역할·그룹·공개 범위), 자산과 버전, SAMANDA의 위임과 승인, 에이전트의 실행 권한 — 을 설명합니다.

QUANTUM C&S

KosmosAI를 쓰기 전에 알아 두면 좋은 개념 — 권한(IGA · 역할 · 그룹 · 공개 범위), 자산과 버전, SAMANDA의 위임과 승인, 에이전트의 실행 권한 — 을 설명합니다.

권한은 IGA가 작업마다 판정합니다

KosmosAI의 모든 인가(무엇을 해도 되는지)는 IGA(Identity Governance & Administration, 권한 관리)가 정합니다. 화면의 버튼 · 메뉴와 서버의 실제 처리가 같은 판정을 따르므로, 버튼이 켜져 있으면 실제로도 할 수 있고, 권한이 없으면 버튼이 꺼지거나 거부 사유가 표시됩니다.

판정에는 다음이 함께 쓰입니다.

요소	설명
역할	사용자에게 부여된 직무 묶음입니다(아래 표). 역할이 정한 동작을 서비스 전체에서 할 수 있습니다.
소유	내가 만든 리소스에는 모든 동작을 할 수 있습니다.
그룹(소속)	부서 · 프로젝트팀입니다. 그룹에 공개된 리소스는 그 그룹 구성원이 읽을 수 있습니다.
공개 범위	리소스마다 정하는 공개 대상입니다(아래 절).
정책	보안관리자가 IGA에서 정한 허용 · 차단 규칙입니다.

주요 역할

역할(화면 표시)	설명
운영 관리자	플랫폼 운영 전반을 맡습니다. 대부분의 작업을 할 수 있습니다.
보안관리자	사용자 · 그룹 · IGA · 감사 같은 보안 기능만 사용합니다. 데이터 · 모델 · 자원 메뉴는 보이지 않습니다.
데이터 엔지니어	데이터셋 등록 · 관리와 데이터 처리 작업을 합니다.
ML 엔지니어	데이터에서 분석 · 모델 학습 · 평가 · 서빙까지 모델 개발 전 과정을 합니다.
분석가	데이터 분석 작업을 합니다.
조회자	조회 중심으로 사용합니다.
RAG 관리자 · RAG 개발자 · RAG 조회자	지식기반을 관리 · 구성 · 조회합니다.
감사 열람	감사 기록을 열람합니다.

참고 역할마다 할 수 있는 동작의 정확한 목록은 설치 환경의 IGA 설정을 따릅니다. 내가 지금 무엇을 할 수 있는지는 내 프로필 › 내 권한의 할 수 있는 일에서 서비스별로 확인하세요. 진한 칩은 전체 대상, 점선 칩은 본인 · 소속 리소스에만 할 수 있는 일입니다.

그룹과 팀

그룹은 부서나 프로젝트팀입니다. 한 사용자가 여러 그룹에 속할 수 있고, 헤더의 내 이름 아래에 소속이 표시됩니다(여러 개면 "첫 이름 외 N").

개념	설명
구성원	그룹에 공개된 리소스를 읽을 수 있습니다.
팀장	역할이 아니라 그룹과의 관계입니다. 팀장은 그룹 관리 화면을 볼 수 있고, GPU 증설 · 스토리지 확장 · 공유 요청 같은 결재의 첫 승인자가 됩니다.

공개 범위

데이터셋 · 모델 · 에이전트 · 아티팩트 같은 리소스는 만든 사람이 공개 범위를 정합니다.

공개 범위	누가 볼 수 있나요	화면 표시 예
나만	만든 사람만	비공개, 나만 보기
그룹	고른 그룹(내가 속한 그룹)의 구성원	그룹 공개
전체	로그인한 모든 사용자	전체 공개, 전체 공유

참고 공개 범위의 이름은 화면마다 조금 다릅니다(예: 에이전트는 나만 보기 · 그룹 공개 · 전체 공유). 에이전트를 전체에 공유하려면 에이전트 관리자의 승인이 필요합니다(에이전트 목록 · 만들기 · 공유).

내가 속하지 않은 그룹에 데이터셋을 보여 주려면 데이터셋 상세의 다른 그룹에 공유 요청으로 결재를 올리세요(데이터셋 소유자에게만 보입니다). 공유할 그룹과 기간(30 · 90 · 180 · 365일)을 고르면 팀장 결재 후 그 그룹에 읽기 권한이 기간 동안 적용됩니다.

권한이 없을 때

상황	보이는 것	할 일
만들 권한이 없음	만들기 버튼이 꺼지고, 마우스를 올리면 "만들 권한이 없습니다 — 역할에 … 권한이 필요합니다. 관리자에게 역할을 요청하세요."가 표시됩니다.	보안관리자에게 역할을 요청하세요.
작업이 거부됨	서버가 알려 준 거부 사유가 알림이나 화면에 그대로 표시됩니다(예: "이 에이전트를 고칠 권한이 없습니다(만든 사람만).").	사유에 적힌 조건을 확인하고, 필요하면 소유자에게 공유를 요청하거나 역할을 요청하세요.
메뉴가 안 보임	권한이 없는 관리 메뉴는 왼쪽 메뉴에 나타나지 않고, 주소로 들어가도 대시보드로 돌아갑니다.	필요한 권한을 요청하세요.

권한 · 자원 요청하기

내 프로필 › 내 권한에서 권한 · 자원 요청을 누르면 다음 결재를 올릴 수 있습니다. 진행 상황은 결재함에서 봅니다.

요청	결재선
GPU 증설	그룹 팀장 → 운영 관리자
그룹 스토리지 확장	그룹 팀장 → 운영 관리자
개인 스토리지 신청	팀장 → 운영 관리자
외부 모델 사용	팀장 → 임원

참고 역할 변경은 보안관리자가 IGA에서 합니다. 역할을 받으면 해당 메뉴와 버튼이 자동으로 나타납니다.

자산과 버전

개념	설명
버전	데이터셋과 모델은 버전으로 관리합니다. 같은 이름 아래 여러 버전이 쌓이며, 데이터셋 · 모델을 가리킬 때는 이름과 버전을 함께 씁니다.
계보	모델 상세에서 최신 버전을 학습한 데이터셋(이름 · 버전)을 볼 수 있고, 버전별 계보는 각 버전의 모델 카드에 있습니다.
KRN	리소스마다 붙는 고유 식별자로, IGA 정책에서 리소스를 가리키는 주소입니다. 데이터셋 · 모델 화면에서 KRN 복사로 복사할 수 있습니다.

SAMANDA의 위임과 승인

개념	설명
메인 SAMANDA	질문을 받아 직접 답하거나, 영역별 하위 에이전트(App · Ops · RAG · AkashiQ · Code)에게 맡깁니다.
승인	무언가를 바꾸는 작업(만들기 · 실행 · 삭제 등)은 실행 전에 계획을 보여 주고 승인을 받습니다. 거절하면 실행하지 않습니다.
작업 현황	오래 걸리는 일은 하위 에이전트가 백그라운드에서 진행하며, 진행 상황을 볼 수 있습니다.

자세한 내용은 SAMANDA와 대화하기를 참고하세요.

에이전트는 호출한 사람의 권한으로 동작합니다

SAMANDA와 모든 에이전트(내가 만든 것, 공유받은 것 포함)는 에이전트를 부른 사람의 권한으로 실행됩니다. 공유용 공용 키나 별도의 강한 계정을 쓰지 않습니다.

공유받은 에이전트가 내가 쓸 권한이 없는 도구나 지식기반을 쓰려 하면 거부됩니다.
에이전트가 한 작업은 감사 기록에 부른 사람의 이름으로 남습니다.
에이전트의 공유가 거두어지면 다음 호출부터 쓸 수 없고, 그 사유가 표시됩니다.