문서 목차

KosmosAI v1.0.2부록

자주 묻는 질문·문제 해결

KosmosAI 를 쓰다가 자주 만나는 메시지와 상황별 해결 방법을 정리했습니다.

QUANTUM C&S

KosmosAI 를 쓰다가 자주 만나는 메시지와 상황별 해결 방법을 정리했습니다.

참고 아래 따옴표 안의 문구는 화면에 실제로 표시되는 메시지입니다. <…> 부분에는 상황에 따라 실제 이름 · 값이 들어갑니다.

권한이 없다는 메시지가 나와요

KosmosAI 의 모든 권한은 IGA(권한 관리)가 판정합니다. 권한이 없어 거부되면 메시지에 무엇이 거부되었는지, 왜 거부되었는지, 무엇을 하면 되는지가 함께 표시됩니다.

권한이 없어 요청이 거부되었습니다. · 거부된 작업: <작업> — 대상 <리소스 KRN> · 사유: <사유> · 필요한 조치: <조치>

사유별 해결 방법

사유(화면 문구)	뜻	해결 방법
"이 작업을 허용하는 역할 · 정책 · 소유권 · 공유가 없습니다(기본 거부)."	이 작업을 주는 역할이나 공유가 없습니다	필요한 조치에 안내된 역할을 관리자에게 요청하거나, 리소스 소유자에게 공유를 요청하세요
"이 작업을 허용하는 역할 · 정책이 없습니다(기본 거부). 대상이 아직 없는 작업(생성 등)은 소유권 · 공유로는 허용되지 않고 역할로만 받습니다."	만들기처럼 대상이 없는 작업은 역할로만 허용됩니다	안내된 역할을 요청하세요
"역할은 이 작업을 허용하지만, 이 리소스는 그 역할의 적용 범위(본인 소유 · 소속 그룹 등) 밖이고 나에게 공유되지도 않았습니다 — 역할이 아니라 공유 범위의 문제입니다."	역할은 있지만 남의 리소스입니다	리소스 소유자에게 내 프로젝트(그룹)로 공유해 달라고 요청하거나, 그 리소스가 공개된 프로젝트에 참여를 요청하세요
"정책이 이 작업을 명시적으로 차단합니다(…). 역할을 받아도 풀리지 않으며, 차단 정책은 보안관리자가 관리합니다."	보안관리자가 명시적으로 막았습니다	보안관리자에게 차단 정책 검토를 요청하세요
"권한 판정 서버(IGA PDP)에 물어볼 수 없어 안전하게 거부했습니다. 잠시 후 다시 시도하거나 관리자에게 알려 주세요."	일시적으로 권한을 확인할 수 없습니다	잠시 후 다시 시도하고, 계속되면 운영관리자에게 알려 주세요
"비활성화되었거나 삭제된 계정입니다. 이 토큰으로는 더 이상 작업할 수 없습니다 — 관리자에게 문의하세요."	계정이 비활성 상태입니다	운영 관리자에게 계정 상태를 문의하세요

권한 · 자원을 요청하려면

오른쪽 위 내 이름 › 내 프로필 › 내 권한에서 현재 역할 · 소속 · 할 수 있는 일을 확인합니다.
같은 화면의 권한 · 자원 요청으로 결재를 올립니다. 요청 종류에는 GPU 증설, 그룹 스토리지 확장, 개인 스토리지 신청, 외부 모델 사용이 있습니다.
진행 상황은 내 프로필 › 결재함에서 확인합니다.

참고 역할 변경은 보안관리자가 IGA 에서 합니다. 자세한 내용은 IGA(권한 관리)와 내 프로필 · 접근 토큰을 참고하세요.

에이전트를 쓸 권한이 없다고 나와요

공유받은 에이전트(다른 사람이 만든 에이전트)는 공유 범위 안에서만 쓸 수 있습니다.

'<에이전트 이름>' 에이전트를 쓸 권한이 없습니다. · 사유: 이 에이전트는 공유 범위(나만 보기 · 그룹 공개) 밖입니다. · 필요한 조치: <만든 사람> 에게 그룹 공개 또는 전체 공유를 요청하세요.

이 경우 역할을 받는 것이 아니라 만든 사람이 공유해야 풀립니다.
"이 에이전트는 지워졌거나 쓸 수 없는 상태입니다." 는 만든 사람이 에이전트를 지운 경우입니다.
플랫폼 에이전트(SAMANDA Ops 등)가 거부되면 "'<에이전트 식별자>' 페르소나를 쓸 권한이 없습니다." 와 함께 요청할 IGA 권한이 안내됩니다. 안내된 권한을 보안관리자에게 요청하세요.

자세한 내용은 팀 에이전트 만들어 함께 쓰기를 참고하세요.

외부 AI 모델 사용이 거부돼요

외부 업체의 유료 LLM(외부 모델)은 조직의 외부 모델 사용 정책과 권한을 통과해야 쓸 수 있습니다. 거부되면 다음과 같이 표시됩니다.

외부 AI 모델(<모델>) 사용이 거부되었습니다. · 사유: <사유> · 필요한 조치: <조치>

사유(화면 문구)	필요한 조치(화면 문구)
"외부 모델은 직급(권한 등급) … 이상 · 보안등급 … 이상이 필요한데, 현재 직급 … · 보안등급 … 입니다."	"필요하면 결재(외부 모델 사용 승인)를 요청하거나 관리자에게 등급 조정을 요청하세요."
"승인받은 외부 모델 월 예산을 모두 사용했습니다(사용 $… / 한도 $…)."	"추가 예산 결재를 요청하세요."
"이 모델은 허용된 모델 카탈로그에 없어 외부로 보낼 수 없습니다."	"관리자에게 모델 등록을 요청하세요."
"IGA 에 사용자 정보(직급 · 보안등급)가 등록되어 있지 않습니다."	보안관리자에게 외부 모델 사용 권한 또는 IGA 사용자 등록(직급 · 보안등급)을 요청하세요
"소속 도메인에 외부 모델 정책이 없고, 외부 모델 사용 권한(IGA)도 없습니다."	보안관리자에게 외부 모델 사용 권한을 요청하거나, 소속 도메인의 외부 모델 정책 등록을 요청하세요
"보안관리자가 이 계정의 외부 모델 사용을 명시적으로 막았습니다(IGA Deny)."	"보안관리자에게 문의하세요."

내 프로필 › 내 권한의 외부 모델(유료 LLM) 항목에서 허가 여부 · 기간 · 월 한도와 이번 달 사용액을 확인할 수 있습니다.
허가가 없으면 권한 · 자원 요청에서 외부 모델 사용을 요청하세요.
플랫폼 안에서 서빙한 내부 모델은 이 정책의 대상이 아닙니다. 에이전트의 기본 LLM 목록에는 모델마다 내부 · 외부가 표시되고, 쓸 수 없는 모델에는 "사용 권한 없음"이 붙습니다.

로그인 · 비밀번호

증상(화면 문구)	해결 방법
"이메일 또는 비밀번호가 올바르지 않습니다."	이메일과 비밀번호를 다시 확인하세요. 비밀번호는 8자 이상입니다
"비활성화된 계정입니다 — 로그인할 수 없습니다. 관리자에게 문의하세요."	운영 관리자에게 계정 활성화를 요청하세요
"이메일 인증을 완료해야 로그인할 수 있습니다."	받은 메일의 인증 링크를 누르세요. 메일이 없으면 인증 이메일 재발송을 누르세요
"임시 비밀번호로 로그인하셨습니다. 새 비밀번호를 설정해주세요."	관리자가 비밀번호를 초기화한 경우입니다. 화면에서 새 비밀번호를 정하세요. 임시 비밀번호와 같은 비밀번호는 쓸 수 없습니다
"세션이 만료되었습니다. 다시 로그인하세요."	다시 로그인하세요
"이 시스템은 SSO(Keycloak) 인증만 지원합니다."	Keycloak으로 로그인을 눌러 회사 계정으로 로그인하세요

비밀번호 변경은 내 프로필 › 계정 · 보안에서 합니다. SSO 로 로그인하는 계정은 "SSO 사용자는 비밀번호를 변경할 수 없습니다. IdP에서 변경해주세요." 가 표시되며, 회사 인증 시스템에서 바꿔야 합니다.
비밀번호를 잊었다면 운영 관리자에게 비밀번호 초기화를 요청하세요. 관리자는 사용자 관리에서 임시 비밀번호를 발급합니다.

자세한 내용은 로그인과 내 프로필 · 접근 토큰을 참고하세요.

작업이 대기 상태에서 시작되지 않아요

학습 · 분석 · 추론 같은 작업은 팀(프로젝트)의 할당량(쿼터) 과 클러스터의 남은 자원 안에서만 시작됩니다.

화면	확인할 곳	해결 방법
파인튜닝 · 학습 상세 "리소스 할당 대기중..."	팀의 GPU 할당량, 다른 작업의 GPU 사용	다른 작업이 끝나기를 기다리거나 GPU 수를 줄여 다시 실행하세요. 계속 부족하면 GPU 증설을 요청하세요
추론 서비스 상세 왜 실행되지 않나요?	원인과 해결 방법이 한국어로 표시됨	아래 표 참고
배포 마법사 "팀 쿼터 초과 — 요청 …, 남은 할당량 …(…). 값을 줄이세요."	이 서비스에 쓸 수 있는 남은 할당량	CPU · 메모리 요청을 남은 할당량 안으로 줄이세요

추론 서비스 "왜 실행되지 않나요?" 원인별 조치

원인(화면 문구)	조치(화면 문구)
"팀(프로젝트) 쿼터를 넘어 파드를 만들지 못했습니다."	"CPU · 메모리를 남은 할당량 안으로 줄여 다시 배포하세요. 다른 서비스를 멈춰 할당량을 비워도 됩니다."
"이 요청을 받을 수 있는 노드가 없습니다(부족: …)."	"CPU · 메모리 · GPU 요청을 줄이거나 GPU 할당 방식(DRA 템플릿)을 확인하세요."
"메모리가 부족해 컨테이너가 종료됐습니다(OOMKilled)."	"메모리 한도를 늘려 다시 배포하세요(팀 쿼터 안에서)."
"컨테이너가 시작 직후 계속 종료되고 있습니다."	"로그에서 오류를 확인하세요. 런타임 · 모델 형식 불일치나 모델 파일 문제인 경우가 많습니다."
"지정한 서빙 런타임이 없거나 이 모델 형식을 지원하지 않습니다."	"모델 형식에 맞는 런타임(표 형식 모델은 kserve-mlserver)으로 다시 배포하세요."
"모델 파일을 내려받지 못했습니다."	"모델 경로(S3)와 자격증명을 확인하세요. 로그의 storage-initializer 출력에 원인이 있습니다."
"컨테이너 이미지를 받지 못했습니다(…)."	"이미지 주소 · 태그가 맞는지, 레지스트리 접근 권한이 있는지 확인하세요."

팁 같은 영역의 리소스 줄여 재배포 또는 메모리 늘려 재배포를 누르면 GPU · 모델 설정은 그대로 두고 CPU · 메모리만 바꿔 다시 배포합니다.

팀의 할당량과 사용량은 리소스 현황과 프로젝트의 사용량 · 쿼터에서 확인합니다.

모델 다운로드가 실패해요

HuggingFace 에서 모델을 가져올 때 자주 보이는 메시지입니다.

메시지(화면 문구)	해결 방법
"'<저장소>' 은 게이트(gated) 모델입니다." / "이 모델은 접근 제한(gated) 모델입니다."	HuggingFace 웹사이트에서 라이선스에 동의한 계정의 토큰이 플랫폼 설정 › 모델 레지스트리에 등록되어 있어야 합니다. 관리자에게 요청하세요
"HuggingFace에서 라이선스 동의가 필요하거나 비공개 모델입니다."	위와 같습니다. 비공개 저장소는 접근 권한이 있는 토큰이 필요합니다
"'<저장소>' 을 HuggingFace에서 찾을 수 없습니다."	저장소 ID(예: `조직/모델이름`)의 철자를 확인하세요
"HuggingFace API 에 연결할 수 없습니다."	잠시 후 다시 시도하고, 계속되면 운영관리자에게 알려 주세요
"HuggingFace 연동이 비활성화 상태입니다."	관리자에게 HuggingFace 연동 활성화를 요청하세요

다운로드 진행 상황은 왼쪽 아래 다운로드 메뉴에서 확인합니다. 다운로드는 백그라운드 작업이라 브라우저를 닫아도 계속됩니다.
데이터셋도 같은 방식입니다. 데이터셋 상세에서 "다운로드 실패" 가 보이면 다시 S3 다운로드를 누르거나, 누락된 파일만 다시 받을 수 있습니다.

자세한 내용은 모델 레지스트리와 다운로드를 참고하세요.

지식기반 검색이 잘 안 돼요

증상	확인할 것	해결 방법
답에 내 문서가 인용되지 않음	지식기반 상세의 문서 상태가 완료인지	처리 대기 · 처리중이면 끝날 때까지 기다리세요. 실패면 진행 로그 보기로 원인을 보고 재처리하세요
엉뚱한 지식기반에서 답함	검색 대상 지식기반	지식대화에서 위쪽 칩으로 지식기반을 지정하거나 메시지에 `@지식기반이름` 을 넣으세요. 에이전트라면 도구 · 지식 단계에서 지식기반을 연결하세요
공유받은 사람은 문서를 못 찾음	지식기반의 공개 범위	에이전트는 쓰는 사람의 권한으로 검색합니다. 지식기반을 그 사람이 볼 수 있는 범위(그룹 · 공개)로 공유하세요
업로드 시 "파일 형식을 알 수 없습니다." / "빈 파일입니다."	파일 형식 · 내용	PDF · DOCX · TXT · MD · HTML · JSON · CSV 파일인지, 내용이 비어 있지 않은지 확인하세요
"검색 실패: …"	일시적인 오류	잠시 후 다시 시도하고, 계속되면 운영관리자에게 알려 주세요

팁 표나 그림이 많은 문서는 문서 상세의 청크 보기 · 트리에서 잘린 내용을 확인하고 고칠 수 있습니다. 고친 뒤 저장하면 검색용 색인이 다시 만들어집니다.

자세한 내용은 지식기반과 지식대화를 참고하세요.

SAMANDA 가 실행 전에 승인을 기다려요

SAMANDA 는 만들기 · 배포 · 삭제처럼 무언가를 바꾸는 작업은 계획을 먼저 보여 주고 승인을 받은 뒤 실행합니다.

입력창 바로 위에 승인 필요 카드가 나타납니다. 자세히로 계획을 확인한 뒤 승인 또는 거절을 누르세요. "응"이라고 답해도 승인과 같습니다.
SAMANDA 를 통해서도 내 권한 밖의 작업은 할 수 없습니다. 거부되면 위의 권한 메시지와 같은 형식으로 사유가 표시됩니다.

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

접근 토큰(PAT) 관련

메시지(화면 문구)	해결 방법
"유효하지 않거나 만료된 API 토큰(PAT)입니다"	내 프로필 › 액세스 토큰에서 만료일을 확인하고 새 토큰을 만드세요
"API 토큰(PAT)으로는 새 API 토큰을 발급할 수 없습니다 — 포털에 로그인해 발급하세요."	새 토큰은 포털에 로그인한 상태에서만 만들 수 있습니다

주의 토큰을 삭제하면 그 토큰을 쓰는 자동화 · 스크립트는 즉시 인증에 실패합니다.

어디에 물어보면 되나요

대상	방법
모든 사용자	SAMANDA 에게 "내가 할 수 있는 일 알려줘", "내 소속 프로젝트 · 네임스페이스 알려줘" 처럼 물어보세요. 사용 방법은 이 매뉴얼(왼쪽 아래 매뉴얼)을 참고하세요
권한 · 역할 문제	거부 메시지의 필요한 조치에 안내된 담당자(보안관리자 · 운영관리자 · 리소스 소유자)에게 요청하세요
운영자	SAMANDA Ops 에서 플랫폼 상태 · 인시던트 · 자원 사용을 조회하고 원인을 진단하세요 — SAMANDA Ops 참고