문서 목차

KosmosAI v1.0.2에이전트

지식기반

지식기반(Knowledge Base, KB)은 사내 문서를 주제별로 모아 검색할 수 있게 만드는 보관함입니다. 문서를 올리면 KosmosAI 가 내용을 읽어 검색 단위(청크)로 나누고 색인하며, 지식대화의 SAMANDA RAG 와 에이전트가 이 문서를 근거로 답합니다.

QUANTUM C&S

개요

항목	설명
메뉴 위치	왼쪽 메뉴 에이전트 › 지식기반
주요 작업	지식기반 만들기 · 삭제 · 문서 올리기 · 재처리 · 삭제 · 처리 로그 확인 · 청크와 문서 구조(트리) 수정
공개 범위	공개 · 그룹 · 비공개(기본값)
활용처	지식대화, 지식기반을 연결한 에이전트

지식기반 목록

지식기반 목록 — 카드마다 이름·설명·문서 수·공개 범위·소유자가 표시됩니다

영역	설명
새로고침 · 새 지식기반	화면 오른쪽 위에 있습니다. 새 지식기반 은 만들기 창을 엽니다. 만들 권한이 없으면 버튼이 비활성화되고, 마우스를 올리면 사유가 표시됩니다.
검색창	`지식기반 검색...` 에 이름 일부를 입력하면 목록이 걸러집니다.
카드	이름, 설명(없으면 "설명 없음"), 문서 N개, 공개 범위(그룹이면 그룹 이름 포함), 소유자를 표시합니다. 카드를 누르면 상세 화면으로 이동합니다.
휴지통 아이콘	카드에 마우스를 올리면 오른쪽 위에 나타나며, 지식기반을 삭제합니다.

목록에는 사용자가 볼 수 있는 지식기반만 표시됩니다. 직접 만든 지식기반, 전체 공개된 지식기반, 소속 그룹에 공개된 지식기반, 관리자가 별도로 권한을 부여한 지식기반이 여기에 해당합니다.

지식기반 만들기

새 지식기반 창 — 이름·설명·공개 범위를 입력합니다

1단계: 만들기 창 열기

지식기반 목록에서 새 지식기반 을 누르세요.

2단계: 정보 입력

항목	설명	규칙
이름 *	지식기반 이름	필수
설명	다루는 주제	선택. 지식대화의 지식기반 선택 목록에 함께 표시되므로 내용을 알 수 있게 쓰는 것을 권장합니다.
공개 범위	볼 수 있는 사람의 범위	공개 · 그룹 · 비공개 중 하나. 기본값은 비공개 입니다.

공개 범위	볼 수 있는 사람
공개	KosmosAI 의 모든 사용자
그룹	선택한 프로젝트(그룹)의 구성원. 여러 프로젝트에 소속되어 있으면 아래에 나타나는 선택 상자에서 프로젝트를 고르세요.
비공개	소유자와 관리자

3단계: 생성

생성 을 누르세요. "지식기반 "…"이 생성되었습니다." 알림이 표시되고 목록에 카드가 추가됩니다.

주의 공개 나 그룹 으로 만들려면 공유 권한(rag:kb Share)이 필요합니다. 권한이 없으면 지식기반이 만들어지지 않고 'group' 공개범위로 공유할 권한이 없습니다 (IGA › 역할에서 rag:kb Share 부여 필요) 와 같은 메시지가 표시됩니다. 이 경우 비공개 로 만들거나 관리자에게 권한을 요청하세요.

참고 지식기반 화면에서는 만든 뒤 이름 · 설명 · 공개 범위를 바꾸는 메뉴를 제공하지 않습니다. 공개 범위는 만들 때 신중히 정하세요.

지식기반 상세 화면

카드를 누르면 해당 지식기반의 문서 목록이 열립니다.

지식기반 상세 — 상태 탭·검색·문서 표

영역	설명
목록으로	지식기반 목록으로 돌아갑니다.
새로고침	문서 목록을 다시 불러옵니다.
전체 재처리	문서가 1개 이상 있을 때 표시됩니다. 처리 대기 중이거나 처리에 실패한 문서를 모두 처리합니다. 완료된 문서는 다시 처리하지 않습니다.
문서 업로드	파일을 선택해 올립니다.
상태 탭	전체 · 대기 · 처리중 · 완료 · 실패 와 각 개수를 표시합니다. 누르면 해당 상태의 문서만 보입니다.
`문서 검색...`	파일 이름 일부로 문서를 거릅니다.
페이지 이동	표 아래에서 표시 범위(예: `1-20 / 35`), 10개씩 · 20개씩 · 50개씩 · 100개씩, 이전 · 다음 페이지를 선택합니다.

문서 표의 열은 다음과 같습니다.

열	설명
선택 상자	일괄 작업할 문서를 고릅니다. 머리글의 선택 상자는 현재 페이지의 문서 전체를 선택합니다.
파일명	누르면 문서 상세 화면으로 이동합니다.
상태	처리 상태입니다. 처리 중이면 진행 중인 단계가, 실패하면 오류 메시지가 아래에 표시됩니다. 로그 를 누르면 진행 로그 창이 열립니다.
크기	파일 크기
청크 · 처리시간	만들어진 청크 수와 처리 시간(예: `7청크 · 27초`)
생성일	올린 시각
작업	▷ 재처리(처리 중이 아닐 때), 🗑 삭제

상태	설명
처리 대기 · 대기 · 큐 대기	올라왔고 처리를 기다리는 중입니다. 대기 탭에 모입니다.
처리중	문서를 처리하고 있습니다.
완료	처리가 끝나 검색에 사용됩니다.
실패	처리 중 오류가 발생했습니다. 오류 메시지와 로그를 확인한 뒤 재처리하세요.

처리 중인 문서가 있으면 화면이 3초마다 자동으로 갱신됩니다. 모든 문서가 완료나 실패 상태가 되면 자동 갱신이 멈춥니다.

문서 올리기

1단계: 파일 선택

문서 업로드 를 누르고 파일을 선택하세요(여러 개 선택 가능). 화면에 파일을 끌어다 놓아도 됩니다. 이때 "파일을 놓아서 업로드" 안내가 표시됩니다. 문서가 하나도 없으면 가운데 점선 상자를 눌러도 됩니다.

2단계: 업로드 확인

화면 위쪽 업로드 중 상자에 파일마다 진행 상태(대기 → 업로드 중 → 완료 또는 실패와 오류 메시지)가 표시됩니다.

3단계: 처리 확인

업로드가 끝나면 처리가 자동으로 시작되고 "N개 문서 업로드 완료" 알림이 표시됩니다. 문서 상태가 완료 가 되면 지식대화와 에이전트의 검색에 사용됩니다.

종류	처리할 수 있는 형식
문서	PDF · DOCX · PPTX · XLSX · XLS · HTML · HTM · MD
이미지	PNG · JPG · JPEG

참고 위 형식이 아닌 파일이나 빈 파일은 올라가지 않고 "지원하지 않는 파일 형식입니다" 또는 "빈 파일입니다." 오류가 표시됩니다. 파일 선택 창에서 원하는 형식이 보이지 않으면 파일을 화면에 끌어다 놓아 올리세요.

팁 문서를 새 판으로 바꾸려면 이전 문서를 삭제한 뒤 새 파일을 올리세요. 두 판이 함께 있으면 검색 결과에 섞여 나올 수 있습니다.

처리 과정과 진행 로그

상태 옆 로그 를 누르면 진행 창이 열립니다. 아직 처리가 시작되지 않은 문서는 로그를 열 수 없으며 "진행 정보 없음" 이 표시됩니다.

진행 로그 창 — 단계별 진행과 처리 로그

영역	설명
진행률	완료한 단계 수(예: `9 / 9 단계`)
문서 정보	파일 형식 · 크기 · 청크 수 · 처리 시간 · 시작 · 완료 시각
현재 단계	지금 진행 중이거나 마지막으로 끝난 단계
전체 단계	이 문서에 적용되는 처리 단계 목록
진행 로그	시각별 처리 기록

문서는 대체로 다음 단계를 거칩니다. 지식기반 설정에 따라 일부 단계는 생략될 수 있습니다.

단계	설명
파일 다운로드	올린 원본을 가져옵니다. DOCX 같은 문서는 PDF 로 변환합니다.
문서 파싱	제목 · 문단 · 표 · 그림 같은 요소를 읽어 냅니다.
페이지 캡처	페이지 이미지를 만듭니다. 문서 상세 화면 왼쪽에 표시됩니다.
이미지 처리	문서 안의 그림을 처리합니다.
시맨틱 청킹	문서 구조에 맞춰 청크로 나눕니다.
요약 생성 · 청크 증강	섹션 요약과 키워드를 붙여 검색 품질을 높입니다.
임베딩 생성	청크를 검색용 벡터로 변환합니다.
인덱싱	검색 색인에 넣습니다. 이 단계가 끝나면 완료 가 됩니다.

재처리와 삭제

작업	방법
문서 1건 재처리	문서 줄 오른쪽의 ▷ 를 누르세요. "문서 재처리를 시작했습니다." 알림이 표시됩니다.
여러 문서 일괄 작업	선택 상자로 문서를 고르면 "N개 선택됨" 막대가 나타납니다. 선택 재처리 또는 선택 삭제 를 누르세요. 선택 해제 로 선택을 풉니다.
대기 · 실패 문서 모두 처리	전체 재처리 를 누르세요.
문서 삭제	🗑 를 누르고 확인 창에서 삭제 를 누르세요.
지식기반 삭제	목록에서 카드의 휴지통을 누르고, 확인 창에 `delete` 를 입력한 뒤 삭제 를 누르세요.

주의 문서와 지식기반 삭제는 되돌릴 수 없습니다. 지식기반을 삭제하면 안에 든 모든 문서도 함께 삭제되며, 이 지식기반을 연결한 에이전트도 해당 문서를 더 이상 검색하지 못합니다.

문서 상세 화면

문서 목록에서 파일명을 누르면 문서 상세 화면이 열립니다. 왼쪽에는 원본 페이지, 오른쪽에는 청크 또는 문서 구조(트리)가 표시됩니다.

문서 상세 — 왼쪽은 원본 페이지, 오른쪽은 해당 페이지의 청크

영역	설명
머리글	← (문서 목록으로), 문서 이름, `페이지 1/1 · 청크 7개 / 전체 7개` 형식의 요약
청크 보기 · 트리	오른쪽 영역의 표시 방식을 전환합니다.
왼쪽	원본 페이지 이미지와 페이지 번호. 페이지 이미지가 없으면 "페이지 스크린샷 없음" 이 표시됩니다.
오른쪽(청크 보기)	현재 페이지의 청크 카드. 종류 · 섹션 제목 · 페이지 · 내용 미리보기 · 토큰 수를 표시합니다. 카드를 누르면 왼쪽 페이지에서 해당 위치가 강조되고 편집 이 나타납니다.

청크 종류	설명
텍스트	일반 문단
표	표
이미지 · 차트 · 다이어그램	그림 계열 요소

청크 수정하기

검색 결과가 부정확하거나 글자가 잘못 인식된 청크는 직접 수정할 수 있습니다.

1단계: 편집 열기

청크 카드를 눌러 선택한 뒤 편집 을 누르세요.

2단계: 내용 수정

섹션 제목과 내용(검색 텍스트)을 수정하세요. 표나 그림 청크에는 원본 표 · 이미지가 함께 표시되며, 원본 블록 글자를 고칠 수 있는 칸도 나타납니다.

3단계: 저장

버튼	사용 시점	결과
저장 (임베딩 재생성)	청크 글만 고쳤을 때	청크를 저장하고 검색 벡터를 다시 만듭니다.
저장 (트리 + 청크 재구성)	원본 블록 글자를 고쳤을 때	문서 구조를 저장하고 청크와 임베딩을 다시 만듭니다.
취소	수정을 버릴 때	변경 내용을 저장하지 않습니다.

문서 구조(트리) 수정하기

트리 를 누르면 오른쪽에 문서의 제목 구조가 표시됩니다. 청크는 이 구조를 기준으로 만들어지므로, 제목 단계가 잘못 잡혀 청크가 어색하게 나뉜 경우 여기서 바로잡으세요.

트리 보기 — 제목 단계와 각 제목 아래의 내용 블록

동작	방법
제목 이름 바꾸기	제목을 더블클릭하세요.
여러 항목 선택	Shift+클릭 하세요.
위치 옮기기	항목을 끌어다 놓으세요.
순서 · 단계 조정	위로 · 아래로 · 한 단계 올리기 · 한 단계 내리기
노드 추가 · 삭제	자식 추가 · 형제 추가 · 삭제(자식도 함께)
블록 연결	노드를 선택한 상태에서 왼쪽 페이지의 영역을 누르면 해당 블록을 노드에 넣거나 뺍니다.
저장 · 취소	위쪽에 "변경 사항 N건" 이 표시됩니다. 전체 완료 로 저장하고, 취소 로 모든 변경을 되돌립니다.

저장하면 청크와 임베딩을 다시 만드는 작업이 시작되고 진행 창이 열립니다.

팁 트리를 저장하면 문서 전체의 청크가 다시 만들어집니다. 청크 몇 개의 오타만 고칠 때는 청크 보기의 편집 을 사용하세요.

권한

모든 작업은 작업마다 IGA(통합 권한 관리)가 허용 여부를 판단합니다. 권한이 없으면 버튼이 비활성화되거나 거부 사유가 표시됩니다.

작업	필요한 권한
지식기반 만들기	`rag:kb` Create 권한이 있는 역할. 없으면 "만들 권한이 없습니다 — 역할에 rag:kb Create 권한이 필요합니다. 관리자에게 역할을 요청하세요." 가 표시됩니다.
공개 · 그룹으로 만들기	위 권한과 함께 `rag:kb` Share 권한. 그룹 공개는 본인이 소속된 프로젝트에만 할 수 있습니다.
보기 · 검색	공개 지식기반은 모든 사용자, 그룹 지식기반은 해당 그룹 구성원, 비공개 지식기반은 소유자와 관리자
문서 올리기 · 재처리 · 청크 수정 · 삭제	해당 지식기반에 대한 각 작업 권한. 일반적으로 소유자와 관리자, 그리고 역할로 그룹 범위 권한을 받은 구성원

비공개 지식기반은 같은 프로젝트 구성원도 열 수 없습니다. 팀과 함께 쓰려면 그룹 으로 만드세요.
지식기반에 보안 등급이 지정되어 있으면 등급이 낮은 사용자는 볼 수 없습니다. 보안 등급은 운영관리자만 지정할 수 있습니다.
권한이 필요하면 관리자에게 역할을 요청하세요. 자세한 내용은 IGA(권한 관리)를 참고하세요.

알아두면 좋은 점

항목	설명
검색 범위	지식대화와 에이전트는 질문한 사용자가 볼 수 있는 지식기반만 검색합니다. 다른 사람이 만든 에이전트를 사용해도 같습니다.
검색 대상	상태가 완료 인 문서만 검색됩니다.
처리 시간	스캔한 PDF 나 그림이 많은 문서는 처리 시간이 길어질 수 있습니다. 진행 로그로 단계를 확인하세요.
처리 실패	오류 메시지와 진행 로그를 확인한 뒤 재처리하세요. 반복해서 실패하면 파일을 PDF 로 변환해 다시 올려 보세요.