문서 목차
KosmosAI v1.0.2부록
용어집
이 매뉴얼과 KosmosAI 화면에서 쓰는 용어를 쉬운 말로 풀이합니다. 매뉴얼의 다른 페이지는 이 정의를 기준으로 용어를 씁니다.
QUANTUM C&S
이 매뉴얼과 KosmosAI 화면에서 쓰는 용어를 쉬운 말로 풀이합니다. 매뉴얼의 다른 페이지는 이 정의를 기준으로 용어를 씁니다.
참고 용어가 어떻게 서로 연결되는지는 핵심 개념에서 그림과 함께 설명합니다.
제품 · 에이전트
| 용어 | 뜻 | 관련 항목 |
|---|---|---|
| KosmosAI | QUANTUM C&S 의 AI 플랫폼입니다. 데이터 준비부터 학습 · 서빙 · 운영까지 한 포털에서 다루고, SAMANDA 가 작업을 돕습니다. | KosmosAI 한눈에 보기 |
| SAMANDA | KosmosAI 의 AI 에이전트입니다. 질문에 답하고, 필요한 일을 하위 에이전트에게 나눠 맡기며, 변경 작업은 계획을 보여 주고 승인받은 뒤 실행합니다. | SAMANDA와 대화하기 |
| SAMANDA Ops | 운영자용 플랫폼 에이전트입니다. 클러스터 · 노드 · 장애 · 자원 상황을 조회하고 원인을 진단합니다. | SAMANDA Ops |
| 에이전트 | 지시문 · 도구 · 지식기반을 갖추고 특정 업무를 맡아 대화하는 AI 입니다. 플랫폼 에이전트(KosmosAI 기본 제공)와 사용자가 만든 개인 에이전트가 있습니다. | 에이전트 목록 · 만들기 · 공유 |
| 페르소나 | 에이전트의 역할 설정(지시문 · 도구 · 접근 규칙)을 가리키는 내부 이름입니다. 화면의 권한 거부 메시지에 "페르소나"로 표시될 수 있으며, 사용자 입장에서는 에이전트와 같은 뜻입니다. | 에이전트 목록 · 만들기 · 공유 |
| 지시문 | 에이전트의 역할 · 절차 · 답변 형식 · 하지 말 것을 적은 글입니다. 공유받은 사람에게는 보이지 않습니다. | 에이전트 목록 · 만들기 · 공유 |
| 도구 | 에이전트가 플랫폼 기능(조회 · 생성 · 배포 등)을 실행할 때 쓰는 기능 단위입니다. 변경 도구는 데이터를 바꾸며, 실행 전 확인을 걸 수 있습니다. | 에이전트 목록 · 만들기 · 공유 |
| 에이전트 고정 | SAMANDA 대화창에서 메인 SAMANDA 대신 특정 에이전트와 직접 대화하도록 고르는 기능입니다. 입력창 모델 칩 옆의 핀 아이콘으로 씁니다. | SAMANDA와 대화하기 |
| 에이전트 채팅 | 에이전트를 13개 초대해 한 방에서 대화하는 화면입니다. @이름 호출과 토론 바퀴(13)를 지원합니다. |
에이전트 채팅 |
| 승인(실행 전 확인) | SAMANDA · 에이전트가 변경 작업을 실행하기 전에 사용자의 확인을 받는 절차입니다. 입력창 위 승인 필요 카드에서 승인 또는 거절합니다. | SAMANDA와 대화하기 |
| 아티팩트 | SAMANDA 가 만든 결과를 문서로 남긴 것입니다. 공유 범위를 정해 링크로 공유하고 HTML · Markdown · PDF 로 내보낼 수 있습니다. | SAMANDA와 대화하기 |
| 예약 작업 | 정해진 때(매일 · 평일 · 매주 · 매월 · 매시간 · 한 번 · cron)마다 SAMANDA 에게 같은 일을 시키는 기능입니다. 실행마다 대화가 남고 알림이 옵니다. | 반복 업무 자동화하기 |
데이터 · 모델
| 용어 | 뜻 | 관련 항목 |
|---|---|---|
| 데이터셋 | 학습 · 분석에 쓰는 데이터 묶음입니다. 메타데이터(이름 · 설명 · 태스크 · 포맷)와 여러 버전으로 이루어집니다. | 데이터셋 |
| 데이터셋 버전 | 데이터셋의 특정 시점 내용입니다(예: v1.0). 버전마다 파일이 따로 저장되며, 분석 · 학습에서는 항상 데이터셋 이름 + 버전을 함께 지정합니다. |
데이터셋 |
| 슬러그 | 데이터셋 · 모델 등을 가리키는 영문 식별 이름입니다(예: iris-classifier). 화면 이름과 별도로 주소 · API 에 쓰입니다. |
데이터셋 |
| 모델 레지스트리 | 모델과 그 버전 · 파일 · 모델 카드를 등록하고 공유하는 저장소입니다. 외부(HuggingFace 등)에서 가져온 모델과 플랫폼에서 학습한 모델이 함께 관리됩니다. | 모델 레지스트리 |
| 모델카(OCI modelcar) | 모델 파일을 컨테이너 이미지 안에 미리 담아 둔 형태입니다. 배포할 때 모델을 내려받는 단계가 없어 빨리 뜹니다. 화면에는 OCI 저장됨, 컨테이너 이미지 모델로 표시됩니다. | 외부 모델 가져와 서빙하기 |
| 분석 작업 | 데이터셋으로 EDA · 상관분석 · 회귀 · 분류 · 클러스터링 · 시계열 등을 실행하는 작업입니다. 회귀 · 분류는 학습된 모델을 레지스트리에 자동 등록할 수 있습니다(서빙 가능). | 분석 작업 |
| 파인튜닝 | 베이스 모델을 내 데이터셋으로 추가 학습해 새 모델 버전을 만드는 작업입니다. | 파인튜닝 · 정렬 |
| 피처스토어 | 학습에 쓸 피처(입력 변수)를 그룹 · 버전으로 관리하는 곳입니다. | 피처스토어 |
| 데이터 레이크 | 대용량 표 데이터를 테이블로 저장하고 조회하는 곳입니다. | 데이터 레이크 |
서빙 · 자원
| 용어 | 뜻 | 관련 항목 |
|---|---|---|
| 추론(서빙) | 학습된 모델을 서비스로 띄워 API 로 예측 · 응답을 받을 수 있게 하는 것입니다. KosmosAI 는 KServe 기반으로 추론 서비스를 운영합니다. | 추론(서빙) |
| 런타임 | 모델 형식에 맞춰 추론을 실행하는 서빙 엔진입니다. 배포 마법사에서 K8s 런타임, Template, Raw YAML, llm-d 중에서 고릅니다. | 추론(서빙) |
| llm-d | 생성형 언어 모델(LLM) 전용 런타임입니다. Standalone(서비스로 바로 연결) 또는 Gateway Mode(게이트웨이를 통한 라우팅)로 배포합니다. | 외부 모델 가져와 서빙하기 |
| AI Gateway(LLM 게이트웨이) | 플랫폼의 여러 LLM 을 하나의 OpenAI 호환 창구로 묶는 관문입니다(LiteLLM 기반). 추론 서비스를 AI Gateway 에 노출하면 채팅 · 에이전트가 정한 이름으로 그 모델을 부릅니다. | 외부 모델 가져와 서빙하기 |
| 내부 모델 / 외부 모델 | 내부 모델은 KosmosAI 안에서 서빙하는 모델이고, 외부 모델은 외부 업체가 제공하는 유료 LLM 입니다. 외부 모델은 외부 모델 사용 정책 · 권한 · 예산을 통과해야 쓸 수 있습니다. | 자주 묻는 질문 · 문제 해결 |
| 네임스페이스 | 팀(프로젝트)별로 나뉜 작업 공간입니다. 추론 서비스 · 작업 공간 · 작업이 이 안에서 실행되고, 할당량이 이 단위로 적용됩니다. | 프로젝트 |
| 할당량(쿼터) | 팀이 쓸 수 있는 CPU · 메모리 · GPU · 스토리지의 상한입니다. 넘으면 작업이 시작되지 않으며, GPU 증설 등 결재로 늘릴 수 있습니다. | 리소스 현황 |
| DRA | GPU 같은 장치를 작업에 나눠 주는 방식(Dynamic Resource Allocation)입니다. 배포 화면에서 전용 장치(DRA · Dedicated) 또는 공유 그룹(DRA · Shared group)으로 고릅니다. | 리소스 현황 |
| MIG | GPU 한 장을 여러 개의 독립된 작은 GPU 로 나누어 쓰는 기능(Multi-Instance GPU)입니다. | 리소스 현황 |
지식 · 플로우
| 용어 | 뜻 | 관련 항목 |
|---|---|---|
| 지식기반(RAG) | 문서를 올려 두면 AI 가 그 문서를 검색해 근거로 답하게 하는 저장소입니다. 검색으로 근거를 찾아 답을 만드는 방식을 RAG(검색 증강 생성)라고 합니다. | 지식기반 |
| 청크 | 지식기반이 문서를 검색하기 좋게 나눈 조각입니다. 문서 상세의 청크 보기에서 확인합니다. | 지식기반 |
| 지식대화 | 지식기반을 근거로 질문하고 출처와 함께 답을 받는 채팅 화면입니다. | 지식대화 |
| AI플로우 | SAMANDA 가 자연어 요청으로 만든 재사용 가능한 자동화입니다. 다시 실행하거나 스케줄로 예약하고 편집할 수 있습니다. | AI플로우 |
| 자동화플로우 | 데이터 가져오기 · 분석 · 모델 등록 · 배포 같은 작업 단계를 순서대로 이어 실행하는 워크플로입니다. 앞 단계가 성공하면 다음 단계가 실행됩니다. | 자동화플로우 |
| 트리거 | 자동화플로우를 시작하는 조건입니다. 스케줄 트리거(시각), 이벤트 트리거(이벤트 발생), 수동 실행이 있습니다. | 자동화플로우 |
| 차수 | 자동화플로우의 실행 한 번을 가리킵니다. 실행 이력에 차수별 진행과 결과가 남습니다. | 자동화플로우 |
계정 · 권한
| 용어 | 뜻 | 관련 항목 |
|---|---|---|
| IGA | KosmosAI 의 권한 관리 체계(Identity Governance & Administration)입니다. 모든 화면 · API · 에이전트의 허용 여부를 IGA 가 같은 기준으로 판정하고, 거부할 때는 사유와 필요한 조치를 알려 줍니다. | IGA(권한 관리) |
| 역할 | 사용자에게 부여되는 작업 권한의 묶음입니다(예: 운영 관리자, 보안 관리자, ML 엔지니어, 데이터 엔지니어, 분석가, 지식 관리자, 구성원). 역할 부여는 보안관리자가 합니다. | IGA(권한 관리) |
| 그룹 | 부서 · 프로젝트처럼 사용자를 묶은 단위입니다. 공개 범위를 그룹으로 정하면 그 구성원이 리소스를 씁니다. | 그룹 관리 |
| 프로젝트 | 팀이 함께 일하는 그룹으로, 네임스페이스 · 할당량 · 기간을 가집니다. 한 사람이 여러 프로젝트에 참여할 수 있습니다. SAMANDA 작업 공간의 "프로젝트"(대화 묶음)와는 다른 것입니다. | 프로젝트 |
| 공개 범위 | 리소스를 누가 볼 수 있는지 정하는 설정입니다. 대부분 비공개(나만), 그룹, 공개(전체) 세 가지이며, 에이전트의 전체 공유처럼 승인이 필요한 경우도 있습니다. | 팀 에이전트 만들어 함께 쓰기 |
| KRN | KosmosAI 리소스를 하나로 가리키는 이름 형식입니다(예: krn:kosmos:datasets::dataset/my-dataset). 권한 거부 메시지의 "대상"에 표시됩니다. |
IGA(권한 관리) |
| PAT(개인 액세스 토큰) | 외부 프로그램 · 스크립트에서 내 계정으로 KosmosAI API 를 부를 때 쓰는 토큰입니다. 내 프로필 › 액세스 토큰에서 만들고, 범위(읽기 · 쓰기)와 만료일을 정합니다. | 내 프로필 · 접근 토큰 |
| 위임(OBO) 토큰 | 학습 · 다운로드처럼 오래 도는 작업이 요청한 사용자의 신원과 권한으로 실행되도록 넘겨받는 토큰입니다(On-Behalf-Of). 공유 키를 쓰지 않으므로 작업 기록도 요청한 사람에게 남습니다. | IGA(권한 관리) |
| 결재 | 권한 · 자원(GPU 증설, 스토리지, 외부 모델 사용 등)을 요청하고 승인받는 절차입니다. 내 프로필 › 내 권한 › 권한 · 자원 요청에서 올리고 결재함에서 확인합니다. | 내 프로필 · 접근 토큰 |
| 운영 관리자 / 보안 관리자 | 운영 관리자는 플랫폼 운영(사용자 · 자원 · 설정)을, 보안 관리자는 역할 · 정책 등 권한 관리를 맡습니다. 보안 관리자는 보안 기능만 사용하는 배타 역할로, 다른 역할 · 팀 소속 · 소유 권한이 적용되지 않습니다(직무 분리). | IGA(권한 관리) |