문서 업로드, RAG 파이프라인, 동적 필터, AI 메타데이터 추출을 통한 지식기반 구축 및 관리
AI에게 질문했을 때 “모르겠습니다”라고 답하거나, 엉뚱한 답변을 하는 경우가 있습니다. 지식기반은 사내 문서를 AI가 직접 참조할 수 있도록 변환하여, 문서 근거 기반의 정확한 답변을 가능하게 합니다.
예시
“우리 회사 연차 규정이 어떻게 되나요?”
상태
동작
결과
지식기반 없음
AI의 일반 지식으로 답변
부정확하거나 “모르겠습니다”
지식기반 연결
인사규정.pdf에서 관련 내용 검색 후 답변
정확한 규정 + 출처 표시
지식기반별로 문서 처리 프로파일을 선택하여 추출 방식과 청킹 전략을 다르게 적용할 수 있습니다. 자세한 내용은 아래 문서 처리 프로파일 선택 섹션을 참조하세요.
워크스페이스 > 지식기반에서 생성된 지식기반 목록을 확인할 수 있습니다
컬렉션과 라이브러리
지식 기반 목록에는 두 가지 카드가 섞여 있습니다. 카드 왼쪽 위 배지로 구분되며(라이브러리는 파란 배지, 컬렉션은 초록 배지), 목록 오른쪽 위의 + 새 지식 기반 · 새 라이브러리 버튼으로 각각 만듭니다.
컬렉션
라이브러리
구조
폴더 없는 평평한 문서 묶음
폴더 트리를 가진 컨테이너
카드에 표시
파일 수 · 마지막 업데이트
폴더 수 · 파일 수
적합한 경우
한 주제의 문서를 한곳에 모을 때
이미 폴더로 분류된 문서 뭉치를 구조째 옮길 때
라이브러리 다루기
라이브러리를 열면 왼쪽에 폴더 트리, 오른쪽에 선택한 폴더의 파일 목록이 나옵니다.
조작
위치
동작
폴더 및 파일 검색
트리 위 검색창
라이브러리 전체 폴더를 한 번에 검색
폴더 가져오기 · 구조+파일
트리 아래
내 PC 폴더를 하위 구조 그대로 통째로 가져오기
+ 새 컬렉션
트리 아래
라이브러리 안에 새 폴더 만들기
전체 처리 · 미처리 N
트리 아래 (미처리 파일이 있을 때만)
라이브러리 전체의 미처리 파일을 한 번에 임베딩
폴더 하나하나가 독립된 지식기반처럼 동작합니다. 새 폴더는 만들 때 부모의 필터 스키마·추출 모드·추출 모델·검색 설정·접근 권한을 그대로 물려받고, 이후 폴더별로 따로 고칠 수 있습니다.단 도구 설명만은 상속하지 않습니다. “이 폴더를 언제 검색할지”는 폴더마다 달라야 해서 빈 칸으로 시작합니다.
라이브러리 폴더에서는 도구 설명 옆의 AI 버튼이 그 폴더 하나가 아니라 하위 트리 전체를 채웁니다. 하위 폴더는 파일명을 표본으로, 상위 폴더는 하위 폴더 설명을 요약해 아래에서 위로 생성되므로 루트 폴더에서 한 번 누르면 라이브러리 전체가 채워집니다. 이미 설명이 있는 폴더는 건너뛰고, 끝나면 “폴더 N개의 도구 설명을 생성했습니다” 알림이 표시됩니다.
에이전트에는 라이브러리를 통째로 연결할 수 있습니다. 에이전트 편집 화면의 지식 선택 모달에 라이브러리 / 컬렉션 / 문서 필터가 있어 유형별로 골라낼 수 있습니다.
라이브러리나 폴더를 삭제하면 하위 트리 전체가 파일·벡터까지 함께 삭제됩니다. “소속만 해제”가 아니라 구조 자체를 지우는 동작이며 되돌릴 수 없습니다. 삭제 전 확인 창이 표시됩니다.
이름 규칙도 다릅니다. 컬렉션 이름은 워크스페이스 전체에서 유일해야 하지만, 라이브러리 안의 폴더 이름은 같은 부모 아래에서만 겹치지 않으면 됩니다. 부서별 라이브러리마다 “계약서” 폴더를 두는 식이 가능합니다.
폴더 이름 자체가 분류 축이라면(예: 사업번호/문서종류/파일), 필터의 폴더 매핑을 함께 설정하세요. 폴더째 업로드할 때 폴더 이름이 그대로 메타데이터 값으로 채워져 LLM 추출이 필요 없습니다. 자세한 내용은 동적 필터 상세 가이드를 참조하세요.
RAG 파이프라인
문서가 업로드되면 다음 파이프라인을 거쳐 검색 가능한 상태로 변환됩니다.
단계
설명
프로파일 적용
KB에 설정된 문서 처리 프로파일의 추출/청킹 전략을 적용합니다
텍스트 추출
문서에서 텍스트를 추출합니다 (기본, OCR, LLM 비전 등 프로파일에 따라 결정)
청킹
긴 문서를 검색에 적합한 크기로 분할합니다 (고정 크기 또는 시맨틱)
테이블 보존
테이블을 분리하지 않고 인접 청크에 통째로 보존합니다 (프로파일 설정에 따라)
문맥 보존
각 청크에 전체 문서 맥락 요약을 LLM이 추가합니다 (프로파일 설정에 따라)
임베딩
텍스트를 고차원 벡터로 변환합니다
유사도 검색
질문과 가장 유사한 문서 청크를 검색합니다
LLM 응답 생성
검색된 문서를 컨텍스트로 활용하여 답변을 생성합니다
지식기반 생성
1
기본 정보 입력
워크스페이스 > 지식기반에서 우측 상단의 + 새 지식 기반을 누르면 생성 폼이 열립니다.
이름과 설명을 입력하고 권한을 설정합니다.
이름과 설명을 입력하고 접근 권한을 설정합니다
필드
설명
예시
이름
지식기반 이름 (필수)
“인사 규정 2024”
설명
용도 및 내용 설명 (필수)
“인사팀 규정 및 가이드라인”
권한
공개 / 비공개. 비공개면 아래 그룹 카드에서 대상 지정
비공개 + “영업팀”
2
문서 업로드
생성된 지식기반에 문서를 추가합니다. 내용 추가(+) 버튼을 클릭하여 업로드 방법을 선택합니다.
내용 추가(+) 버튼으로 파일 업로드, 텍스트 입력, 클라우드 소스를 선택합니다
업로드 방법:
방법
설명
드래그 앤 드롭
파일을 업로드 영역으로 끌어다 놓기
파일 업로드
”내용 추가” 메뉴에서 “파일 업로드” 선택
디렉토리 업로드
”내용 추가” 메뉴에서 “디렉토리 업로드” 선택 — 폴더 내 모든 파일을 일괄 업로드
클라우드 스토리지
Google Drive, OneDrive, SharePoint (관리자가 연동 설정 시 표시)
글 추가
텍스트를 직접 작성하여 추가
3
처리 대기
업로드된 문서는 자동으로 텍스트 추출 → 청킹 → 임베딩 → 인덱싱 과정을 거칩니다.
처리가 완료되면 실시간 알림이 표시됩니다.
파일 처리가 30분 이상 걸리면 자동으로 실패 처리됩니다. 이 경우 파일을 삭제 후 다시 업로드하세요.
대용량 업로드 시:
5개 이상 파일 또는 디렉토리 업로드 시 배치 모드로 전환됩니다
상단에 진행률 바가 표시되며 (업로드 → 처리 단계별), 실패 건수가 빨간색으로 표기됩니다
동시 3개 파일을 병렬 처리합니다
페이지를 새로고침해도 진행 상태가 복원됩니다
4
확인 및 검증
문서를 클릭하여 추출된 텍스트 내용을 확인하고, 에이전트에 연결하여 검색 품질을 검증합니다. 파일 목록에서 요약 토글을 켜면 AI가 생성한 문서 요약을 확인할 수 있습니다.
지원 파일 형식
기본 추출 엔진 기준으로 다음 형식의 텍스트를 인식합니다. 추출 엔진을 변경하면 인식 범위가 넓어집니다 (아래 추출 엔진 참조).
카테고리
지원 형식
문서
PDF, DOCX, RST, EPUB, MSG (Outlook 메일)
스프레드시트
XLSX, XLS, CSV
프레젠테이션
PPTX, PPT
웹·마크업
HTML, HTM, XML, MD
텍스트·소스코드
TXT, PY, JS, TS, JSON, SQL, JAVA, GO, C, C++, CS, RB, RS, PHP, SH 등 50여 종
목록에 없는 확장자도 업로드는 가능하며 텍스트로 읽기를 시도합니다. 다만 ZIP·실행파일 같은 이진 파일은 내용이 깨진 채로 들어갈 수 있으므로 위 형식 위주로 업로드하는 것을 권장합니다. 관리자가 허용 확장자 화이트리스트를 설정하면 지정한 형식만 업로드되도록 제한할 수 있습니다.
최대 크기 / 개수
항목
기본값
변경 위치
업로드 최대 사이즈
제한 없음
관리자 패널 > 설정 > 문서 > 파일 (단위: MB)
업로드 최대 수
제한 없음
관리자 패널 > 설정 > 문서 > 파일
두 값 모두 기본적으로 무제한입니다. 관리자가 값을 비워두면 제한이 없고, 숫자를 입력하면 그 한도를 초과하는 파일은 업로드 시 거부됩니다.
동적 필터
동적 필터를 사용하면 지식기반 내 문서를 메타데이터 기준으로 분류하고, 검색 시 자동으로 범위를 제한할 수 있습니다.
동적 필터의 내부 동작 원리, Manual vs AI 비교, 5단계 검색 흐름 등 상세한 내용은 동적 필터 상세 가이드를 참조하세요.
필터 스키마 정의 후, 각 파일에 메타데이터 값을 지정합니다. 파일 행 오른쪽 끝의 채워진 항목 수 / 전체 필터 수 배지로 설정 상태를 한눈에 볼 수 있습니다.
파일별 메타데이터 설정 상태가 채움 배지로 표시됩니다
배지 색
의미
초록
모든 필터 필드에 값이 설정됨
파랑
필수 필드는 채워졌고 선택 필드 일부가 비어 있음
주황
필수 필드가 비어 있음
회색
채워진 값이 없고 필수 필터도 없음
AI 추출 중에는 숫자 대신 “추출 중” 배지가 표시되며, 필터를 하나도 만들지 않았다면 배지 자체가 나타나지 않습니다. 색은 채운 개수가 아니라 필수 항목 충족 여부로 정해집니다.
메타데이터 변경 시 벡터 인덱스가 자동으로 업데이트됩니다. 재임베딩 없이 기존 벡터를 유지합니다.
AI 자동 추출
필터 스키마에 추출 프롬프트를 설정하면, 파일 업로드 시 LLM이 문서 내용과 파일 제목을 분석하여 메타데이터를 자동으로 추출합니다.
1
추출 모드 설정
필터 스키마에서 수동 / AI 토글 버튼을 클릭하여 AI 모드로 전환합니다.
2
추출 프롬프트 작성
각 필터에 추출 프롬프트를 작성합니다.
예: “파일 제목에서 국가명을 추출하세요”
3
AI 모델 선택
추출에 사용할 LLM 모델을 선택합니다.
4
추출 실행
파일 업로드 시 자동 실행되거나, 수동으로 단일/전체 추출을 실행합니다.
추출 방법
설명
자동 추출
파일 업로드 직후 자동 실행 (AI 모드 + 추출 힌트가 있을 때)
AI 추출
파일을 클릭하면 열리는 메타데이터 패널에서 그 파일만 다시 추출
추출 (N)
파일 목록 상단 도구 막대에서 체크한 파일을 일괄 추출
추출 프롬프트에서 “파일 제목”을 조건으로 활용할 수 있습니다.
예: “파일 제목 앞에 [XX] 국가명이 있으면 해당 국가 코드를 추출하세요”
검색 시 필터 활용
에이전트에 연결된 지식기반에 동적 필터가 설정되어 있으면, AI가 사용자 질문에서 필터 조건을 자동으로 추론하여 검색 범위를 제한합니다.
Q: 재무팀의 2024년 규정을 알려주세요→ 필터 자동 적용: 부서=재무팀, 연도=2024→ 해당 조건에 맞는 문서만 검색
도구 설명
지식기반 상세 화면 상단의 도구 설명은 에이전트가 이 지식기반을 언제, 어떤 상황에서 검색해야 하는지 안내하는 AI 전용 설명입니다. 화면에도 “에이전트가 이 지식기반을 언제 검색해야 할지 설명하세요.” 라고 표시됩니다.
좋은 도구 설명 예시
회사 인사 규정 및 내부 가이드라인에 대한 질문이 있을 때 사용합니다.연차, 복리후생, 출장 정책 등 HR 관련 문의에 참조하세요.
도구 설명이 비어 있으면 지식기반의 일반 설명이 대신 사용됩니다. AI가 여러 지식기반 중 적절한 것을 선택하도록 구체적인 도구 설명을 작성하는 것을 권장합니다.AI 자동 생성: 도구 설명 옆의 AI 버튼을 클릭하면, 지식기반 이름·설명·파일 목록·필터 정보를 종합하여 AI가 도구 설명을 자동 작성합니다. 바로 옆 드롭다운에서 생성에 쓸 모델을 고를 수 있습니다.
도구 설명이 빈 지식기반을 에이전트에 연결하면 지식 목록 위에 “도구 설명이 누락되었습니다” 경고가 뜨고 해당 항목 이름이 나열됩니다. 저장은 되지만, 에이전트가 그 지식기반을 언제 써야 할지 판단하기 어려워집니다.
필터 편집 폼 안에도 에이전트 설명이라는 입력란이 따로 있습니다. 이쪽은 필터 하나에 대한 설명이고, 여기 도구 설명은 지식기반 전체에 대한 설명입니다. 두 항목의 차이는 동적 필터 상세 가이드에서 정리했습니다.
지식기반 관리
문서 관리
작업
방법
문서 추가
내용 추가(+) 버튼 또는 드래그 앤 드롭
문서 삭제
문서 선택 후 삭제 버튼
내용 확인
문서 클릭 시 추출된 텍스트 미리보기
검색
파일명으로 검색 (서버 사이드, 대규모 KB에서도 빠름)
정렬
최신순(기본) / 오래된순 / 이름순
변경 이력 확인
상단 활동 이력 버튼
파일 목록은 무한 스크롤로 50건 단위로 자동 로드됩니다.파일 상태 뱃지:
뱃지
의미
실패 (빨강)
처리 실패 — 옆의 재시도 버튼으로 다시 시도
처리 중 (주황)
처리 진행 중
요약 (토글)
처리 완료 + 요약 있음 — 클릭하여 인라인 요약 확인
N/M (채움 배지)
필터가 있을 때만 표시되는 메타데이터 채움 상태
같은 이름의 파일을 다시 업로드하면 중복 확인 다이얼로그가 표시됩니다.
선택지
동작
Overwrite
기존 파일을 삭제하고 새 파일로 교체
Skip
중복 파일을 건너뛰고 기존 파일 유지
Cancel
업로드 취소
재색인
전체 지식기반의 벡터 인덱스를 재구축하려면 관리자 패널 > 설정 > 문서 페이지에서 재색인 버튼을 클릭하여 지식 베이스 벡터 재색인을 실행합니다. 이 기능은 관리자 전용이며 모든 지식기반을 대상으로 일괄 처리됩니다.개별 파일의 내용을 수정하고 저장하면 해당 파일만 자동으로 재처리됩니다.
채팅에서 사용
@ 명령어
에이전트 연결
채팅 중 @지식기반이름으로 직접 참조합니다.
@인사규정 연차 신청 절차가 어떻게 되나요?
에이전트 설정에서 지식기반을 연결하면 자동으로 참조합니다. 사용자는 별도 명령 없이 대화하면 됩니다.
AI 응답에 포함된 인용 번호를 클릭하면 원문 내용을 확인할 수 있습니다.
문서 처리 프로파일 선택
신규 기능 — 지식기반별로 서로 다른 문서 처리 전략(추출 엔진, 청킹 방식, 테이블 보존 등)을 적용할 수 있습니다.
관리자가 관리자 패널 > 설정 > 문서에서 사전에 정의한 프로파일 중 하나를 선택합니다. 프로파일을 선택하지 않으면 기본(default) 프로파일이 적용됩니다.
프로파일 활용 예시
지식기반
추천 프로파일
이유
인사 규정 (텍스트 PDF)
기본 추출
단순 텍스트, 추가 비용 없음
재무보고서 (표 많음)
테이블 보존 활성
표 데이터 검색 정확도 향상
스캔 문서 (이미지 PDF)
LLM 비전
이미지 속 텍스트까지 정확하게 추출
기술 문서 (긴 보고서)
시맨틱 청킹 + 문맥 보존
주제별 분리 + 앞부분 맥락 유지
프로파일은 관리자만 생성할 수 있습니다. 필요한 프로파일이 없으면 관리자에게 요청하세요. 프로파일 설정 방법은 관리자 패널 > 설정 > 문서를 참조하세요.
고급 설정
관리자 설정에서 문서 처리 방식과 검색 파라미터를 조정할 수 있습니다.
아래 설정은 문서 처리 프로파일이 지정되지 않은 경우의 전역 기본값입니다. 프로파일이 지정된 KB는 프로파일 설정이 우선 적용됩니다.
이미지 파일(PNG, JPG 등) 은 기본적으로 텍스트 인덱싱 대상이 아닙니다 — 업로드해도 저장만 되고 내용은 검색되지 않습니다. 이미지 속 텍스트까지 검색하려면 해당 지식기반의 문서 처리 프로파일을 Google Cloud Document AI 또는 LLM 비전 으로 지정하세요. (문서 인텔리전스·Mistral OCR은 PDF·오피스 문서는 처리하지만 단독 이미지 파일은 지원하지 않습니다.)
문서 처리 프로파일 옵션
설정
설명
기본값
이름
문서 처리 프로파일 이름 입력
-
기본 엔진
엔진 매핑되지 않은 확장자의 파일 처리에 사용할 엔진
기본 내장 엔진
확장자 → 엔진 매핑
등록된 특정 확장자에 대하여 선택된 엔진 사용
-
텍스트 나누기
텍스트를 나눌 유형을 선택 (기본값, 토큰, 시멘틱)
기본값 (캐릭터)
테이블 보존
청킹 시 테이블을 분리하지 않고 앞 텍스트 청크에 붙여서 보존
활성화
문맥 보존 청킹
청크별 문맥 요약을 추가하여 검색 정확도를 향상
아래 주의 참고
문맥 보존 청킹은 문맥 모델 을 함께 지정해야 실제로 동작합니다. 새 프로파일에서는 스위치가 켜진 상태로 표시되지만 모델이 비어 있어 적용되지 않습니다. 사용하려면 모델을 고른 뒤 저장하세요. 또한 채팅에 그때그때 첨부하는 파일에는 적용되지 않고, 지식 기반에 적재하는 문서에만 적용됩니다.
텍스트 나누기 옵션:
설정
설명
기본값
적용 모드
Chunk 크기
문서 분할 단위 (문자 수)
1,000
기본값(캐릭터), 토큰
Chunk 오버랩
청크 간 중복 문자 수
100
기본값(캐릭터), 토큰, 시멘틱
청크당 최소 토큰
청크를 생성할 최소 문자 수
-
기본값(캐릭터), 토큰, 시멘틱
청크당 최대 토큰
청크를 생성할 최대 문자 수
-
기본값(캐릭터), 토큰, 시멘틱
임계값 유형
청크를 나누는 유사도 기준의 유형
백분위 (권장)
시멘틱
임계값
임계값 유형 별 분할 결정 임계값
-
시멘틱
임베딩 모델 엔진
엔진
특징
기본값 (SentenceTransformers)
외부 전송 없음, 보안 우수
Ollama
로컬 서버, 커스텀 모델
OpenAI
높은 품질, API 비용 발생
Azure OpenAI
기업 환경 최적화
Gemini
Google 임베딩 모델, GCP 연동
Vertex AI
GCP 관리형 임베딩 서비스
검색 설정
검색 설정은 전역 설정(관리자)과 KB별 설정 두 레벨로 관리됩니다.
설정
기본값
설명
Top K
전역 설정 값
벡터 검색에서 가져올 청크 수
리랭커 Top K
전역 설정 값
리랭킹 후 최종 반환할 청크 수
리랭커 임계값
전역 설정 값
리랭킹 최소 점수 (낮을수록 더 많이 통과)
지식기반별로 검색 설정을 오버라이드할 수 있습니다. 지식기반 편집 화면 > 설정 아이콘을 클릭하세요.
세 항목 모두 빈 값으로 두면 전역 설정을 따르며, 입력란에 흐리게 보이는 숫자가 현재 적용 중인 전역 값입니다.
전역 값은 관리자 › 설정 › 검색 엔진 에서 확인·변경합니다.
KB별 문서 요약 설정
지식기반별로 문서 요약 생성을 개별 제어할 수 있습니다. 검색 설정 모달의 “파일 요약” 섹션에서 설정합니다.
설정
설명
기본값
문서 내용 요약 활성화
파일 처리 완료 시 AI 요약 자동 생성
켜짐
요약 모델
요약에 사용할 LLM 모델
작업 모델 사용
요약이 생성된 파일은 목록에서 “요약” 토글로 인라인 확인할 수 있습니다.
질의예시 생성 (Multi-Vector Search)
질의예시 생성을 활성화하면, 문서 청크마다 “이 내용을 찾기 위해 사용자가 할 법한 질문”을 LLM이 미리 생성하여 별도 벡터로 저장합니다.
상태
검색 방식
효과
비활성
콘텐츠 벡터만 사용
기본 검색
활성
콘텐츠 + 질문 벡터 가중 합산
사용자 질문과 유사한 표현으로 검색 정확도 향상
질의예시 생성을 활성화하면 문서 처리 시 LLM 호출이 추가됩니다. 처리 시간과 비용이 증가할 수 있습니다.
KB별로 질의예시 생성을 개별 설정할 수 있습니다. 검색 설정 모달의 “질의예시 생성” 섹션에서 글로벌 설정과 독립적으로 활성화/비활성화하고, 사용할 LLM 모델을 선택합니다.
베스트 프랙티스
문서 준비
깔끔한 포맷: 제목, 소제목을 명확히 구분하고 일관된 스타일을 유지하세요
최신 버전 유지: 정기적으로 문서를 업데이트하고 오래된 문서는 삭제하세요
적절한 크기: 너무 큰 문서는 주제별로 분리하고, 관련 내용끼리 그룹화하세요
지식기반 구성
주제별 분리: “인사규정”, “IT가이드”, “제품매뉴얼” 등 주제별로 별도 지식기반을 구성하세요
접근 권한 세분화: 민감한 정보는 별도로 관리하고 부서별로 접근을 제한하세요
도구 설명 작성: 에이전트가 적절한 지식기반을 자동 선택하도록 구체적인 도구 설명을 작성하세요
활용 사례
신입 사원 온보딩
인사 규정, 업무 매뉴얼, IT 가이드를 지식기반으로 구축하면 신입 사원이 AI에게 질문하며 빠르게 적응할 수 있습니다.
지식기반: “인사규정”, “업무매뉴얼”, “IT이용가이드”
에이전트에 3개 지식기반 연결
도구 설명으로 각 KB의 용도를 명확히 구분
고객 지원 자동화
제품 매뉴얼, FAQ, 기술 문서를 지식기반으로 구축하여 고객 문의에 정확한 답변을 제공합니다.
동적 필터: 제품명, 버전으로 필터링
에이전트: 고객 지원용 시스템 프롬프트 + 지식기반 연결
인용 출처 표시로 답변 신뢰도 확보
부서별 규정 관리
부서별 문서를 동적 필터로 분류하고, 부서에 따라 정확한 규정을 검색합니다.
동적 필터: 부서, 연도, 문서 유형
AI 자동 추출로 메타데이터 자동 분류
접근 권한으로 민감 문서 보호
FAQ
지식기반 용량 제한이 있나요?
기본 설정에서는 파일 수나 용량에 제한이 없습니다. 관리자가 환경 변수를 통해 제한을 설정할 수 있습니다.
같은 파일을 다시 업로드하면 어떻게 되나요?
같은 이름의 파일이 감지되면 중복 확인 다이얼로그가 표시됩니다. Overwrite(교체), Skip(건너뛰기), Cancel(취소) 중 선택할 수 있습니다.
PDF 이미지의 텍스트도 인식되나요?
기본 추출 엔진은 PDF에 포함된 이미지에서 제한적으로 텍스트를 추출하지만, 스캔 문서나 이미지가 많은 PDF는 문서 인텔리전스, Google Cloud Document AI, LLM 비전 엔진을 사용하면 훨씬 정확합니다. 단독 이미지 파일(PNG·JPG)을 업로드해 텍스트를 검색하려면 Google Cloud Document AI 또는 LLM 비전 프로파일이 필요합니다. 관리자에게 추출 엔진 설정을 확인하세요.
동적 필터의 메타데이터를 변경하면 재임베딩이 필요한가요?
아니요. 메타데이터 변경은 벡터 인덱스의 필터 필드만 업데이트하며, 기존 벡터는 그대로 유지됩니다. 재임베딩 없이 빠르게 처리됩니다.
여러 지식기반을 하나의 에이전트에 연결하면 검색 설정은 어떻게 되나요?
여러 KB를 연결하면 검색 설정은 다음 규칙으로 병합됩니다:
Top K, 리랭커 Top K: 각 KB 중 가장 큰 값 적용
리랭커 임계값: 각 KB 중 가장 낮은 값 적용 (더 많은 결과 통과)
문서 처리 프로파일을 변경하면 기존 문서에 영향이 있나요?
프로파일을 변경해도 이미 처리된 문서의 벡터는 자동으로 재처리되지 않습니다. 변경된 프로파일을 기존 문서에 적용하려면 해당 문서를 삭제 후 다시 업로드하거나, 관리자 설정에서 전체 재색인을 실행하세요.
LLM 비전이나 문맥 보존 사용 시 비용이 얼마나 드나요?
LLM 비전: 페이지 수 × 1회 LLM 호출 + 제목 단계 정규화 1회
문맥 보존: 청크 수 × 1회 LLM 호출
10페이지 PDF + 20개 청크 기준으로 LLM 비전(11회) + 문맥 보존(20회) = 약 31회 LLM 호출입니다. 대용량 문서를 일괄 업로드하면 비용이 크게 증가할 수 있으므로 중요 문서에 선별적으로 사용하세요.
관련 페이지
동적 필터 상세
필터 내부 동작 원리, Manual vs AI 비교, 5단계 검색 흐름
지식 그래프
지식기반 + 용어집 + DB를 하나의 그래프로 통합 연결
에이전트
지식기반을 에이전트에 연결하여 활용
용어집
도메인 용어를 정의하여 AI 이해도 향상
이 페이지가 도움이 되었나요?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cloosphere Guide","colors":{"primary":"#5f22d0","light":"#7c3aed","dark":"#4c1d95"},"logo":{"light":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","dark":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","href":"/ko/index"},"favicon":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/favicon.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=0e41ff0755aa623d52e26f279f285f71","appearance":{"default":"system","strict":false},"interaction":{"drilldown":true},"styling":{"latex":false},"navigation":{"languages":[{"language":"ko","default":true,"href":"ko"},{"language":"en","href":"en"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cloocus","hasAudioNarration":false,"actualSubdomain":"cloocus","customDomains":["docs.cloosphere.ai"],"gitSource":{"type":"github","owner":"ais-cloocus","repo":"cloosphere-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6a954066df6b735599399868","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"en","tag":"Admin","count":30},{"language":"ko","tag":"관리자","count":30},{"language":"en","tag":"Settings","count":24},{"language":"ko","tag":"설정","count":24},{"language":"en","tag":"Monitoring","count":21},{"language":"ko","tag":"모니터링","count":21},{"language":"en","tag":"Workspace","count":16},{"language":"ko","tag":"워크스페이스","count":16},{"language":"en","tag":"Chat","count":11},{"language":"ko","tag":"채팅","count":11},{"language":"en","tag":"Getting Started","count":10},{"language":"ko","tag":"시작하기","count":10},{"language":"en","tag":"Collaboration","count":8},{"language":"ko","tag":"협업","count":8},{"language":"en","tag":"Data \u0026 Operations","count":6},{"language":"ko","tag":"운영 · 지원","count":6},{"language":"ko","tag":"데이터 및 운영 보안","count":6},{"language":"en","tag":"AI Features \u0026 Safety","count":5},{"language":"en","tag":"UI \u0026 Channels","count":5},{"language":"ko","tag":"AI 기능 및 안전","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--brand-primary: #5f22d0;--brand-light: #7c3aed;--brand-dark: #4c1d95;--brand-subtle: #ede9fe;--brand-glow: rgba(95, 34, 208, 0.15);--page-text: #0f172a;--page-muted: #6b7280}body{font-family:\"DM Sans\", sans-serif;color:var(--page-text);font-size:17px}.prose h1,.prose h2,.prose h3,.prose h4{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;letter-spacing:-0.015em}.prose h1{font-size:44px}.prose h2{font-size:28px;margin-top:36px;margin-bottom:10px}.prose h3{font-size:22px;margin-top:28px;margin-bottom:8px}.prose p,.prose li{color:var(--page-text);line-height:1.75;font-size:1rem}.prose hr{border:0;height:1px;background:linear-gradient(90deg, rgba(148, 163, 184, 0.4), rgba(148, 163, 184, 0.05));margin:28px 0}.dark body{color:#e2e8f0}.dark .prose p,.dark .prose li{color:#e2e8f0}.dark .prose hr{background:linear-gradient(90deg, rgba(148, 163, 184, 0.3), rgba(148, 163, 184, 0.05))}[class*=\"Card\"] svg,.card svg,a[href] svg{color:var(--brand-primary)!important}.card [data-component-part=\"card-icon\"]{margin-bottom:8px}.card [data-component-part=\"card-title\"]{margin-top:12px!important}[class*=\"Card\"],.card{border-radius:16px!important;border-color:rgba(148, 163, 184, 0.25)!important;transition:border-color 0.2s ease, box-shadow 0.2s ease, transform 0.2s ease}[class*=\"Card\"]:hover,.card:hover{transform:translateY(-2px);border-color:var(--brand-light)!important;box-shadow:0 4px 20px var(--brand-glow)!important}a:not([class*=\"Card\"]):hover{color:var(--brand-primary)!important}.stable-scrollbar-gutter.overflow-auto{width:220px!important;min-width:220px!important}.stable-scrollbar-gutter.overflow-auto+div,.stable-scrollbar-gutter.overflow-auto~main{flex:1!important}.flex.flex-row-reverse.gap-12{gap:32px!important}.xl\\:flex.self-start.sticky{max-width:15rem!important}.xl\\:flex.box-border.max-h-full.pl-10{width:14rem!important;padding-left:24px!important}.text-sm.leading-6.w-\\[16\\.5rem\\]{width:100%!important;font-size:13px!important;line-height:1.6!important}#table-of-contents-content a{padding:5px 0!important;display:block}#table-of-contents-content,#table-of-contents-content ul{list-style:none!important;padding-left:0!important;margin-left:0!important}#table-of-contents-content li::marker{content:\"\"!important}#table-of-contents-content>li{border-left:2px solid rgba(148, 163, 184, 0.1);padding-left:12px;transition:border-color 0.15s ease}.dark #table-of-contents-content>li{border-left-color:rgba(148, 163, 184, 0.08)}#table-of-contents-content a{color:var(--page-muted)!important;font-weight:400!important;transition:color 0.15s ease}.dark #table-of-contents-content a{color:#94a3b8!important}#table-of-contents-content>li>a{color:var(--page-text)!important;font-weight:500!important}.dark #table-of-contents-content>li>a{color:#e2e8f0!important}#table-of-contents-content>li>ul{padding-left:12px!important}#table-of-contents-content a:hover{color:var(--brand-dark)!important}.dark #table-of-contents-content a:hover{color:#e2e8f0!important}#table-of-contents-content a.text-primary,#table-of-contents-content a.font-semibold,#table-of-contents-content>li.is-active-item>a{color:var(--brand-primary)!important;font-weight:600!important}.dark #table-of-contents-content a.text-primary,.dark #table-of-contents-content a.font-semibold,.dark #table-of-contents-content a[class*=\"dark:text-primary\"],.dark #table-of-contents-content>li.is-active-item>a{color:var(--brand-light)!important;font-weight:600!important}#table-of-contents-content>li.is-active-item{border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li.is-active-item{border-left-color:var(--brand-light)!important}#table-of-contents-content>li:has(>a.border-primary),#table-of-contents-content>li:has(>a.text-primary){border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li:has(>a.border-primary),.dark #table-of-contents-content>li:has(>a.text-primary),.dark #table-of-contents-content>li:has(>a[class*=\"dark:text-primary\"]),.dark #table-of-contents-content>li:has(>a[class*=\"dark:border-primary\"]){border-left-color:var(--brand-light)!important}.landing-hero{text-align:center;padding:72px 32px 24px;max-width:860px;margin:0 auto}.landing-hero h1{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:52px;font-weight:700;letter-spacing:-0.03em;margin:0 0 20px;background:linear-gradient(135deg, var(--brand-dark), var(--brand-primary), var(--brand-light));-webkit-background-clip:text;-webkit-text-fill-color:transparent;background-clip:text}.dark .landing-hero h1{background:linear-gradient(135deg, var(--brand-light), #a78bfa, #c4b5fd);-webkit-background-clip:text;background-clip:text}.landing-hero p{font-size:19px;line-height:1.7;color:var(--page-muted);margin:0}.dark .landing-hero p{color:#94a3b8}.landing-section{max-width:1280px;margin:0 auto;padding:0 40px 56px}.landing-section h2{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:26px;font-weight:600;letter-spacing:-0.015em;margin:0 0 6px;color:var(--page-text)}.dark .landing-section h2{color:#e2e8f0}.landing-section>p{color:var(--page-muted);font-size:16px;margin:0 0 24px}.dark .landing-section>p{color:#94a3b8}.landing-cta{max-width:1280px;margin:0 auto;padding:0 40px 48px}.landing-divider{max-width:1280px;margin:0 auto 48px;padding:0 40px}.landing-divider hr{border:0;height:1px;background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.3), transparent);margin:0}.dark .landing-divider hr{background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.15), transparent)}.landing-section [role=\"tablist\"]{margin-bottom:12px}.landing-section [role=\"tabpanel\"]>p:first-child{color:var(--page-muted);font-size:15px;margin-bottom:20px}.dark .landing-section [role=\"tabpanel\"]>p:first-child{color:#94a3b8}.group:has(>.mermaid){background:linear-gradient(135deg, #faf8ff 0%, #f3f0ff 100%);border:1px solid rgba(95, 34, 208, 0.08);border-radius:12px;padding:28px 24px;margin:24px 0}.dark .group:has(>.mermaid){background:linear-gradient(135deg, rgba(95, 34, 208, 0.06) 0%, rgba(95, 34, 208, 0.03) 100%);border-color:rgba(124, 58, 237, 0.12)}.mermaid svg .node rect,.mermaid svg .node circle,.mermaid svg .node ellipse,.mermaid svg .node polygon,.mermaid svg .node path{fill:#ede9fe!important;stroke:#7c3aed!important;stroke-width:1.5px!important;rx:8px}.dark .mermaid svg .node rect,.dark .mermaid svg .node circle,.dark .mermaid svg .node ellipse,.dark .mermaid svg .node polygon,.dark .mermaid svg .node path{fill:rgba(124, 58, 237, 0.15)!important;stroke:#a78bfa!important}.mermaid svg .node.rhombus rect,.mermaid svg .node polygon[points]{fill:#ddd6fe!important;stroke:#6d28d9!important}.dark .mermaid svg .node.rhombus rect,.dark .mermaid svg .node polygon[points]{fill:rgba(109, 40, 217, 0.2)!important;stroke:#a78bfa!important}.mermaid svg .cluster rect{fill:rgba(237, 233, 254, 0.4)!important;stroke:rgba(124, 58, 237, 0.25)!important;stroke-width:1.5px!important;rx:10px!important}.dark .mermaid svg .cluster rect{fill:rgba(124, 58, 237, 0.08)!important;stroke:rgba(167, 139, 250, 0.2)!important}.mermaid svg .cluster-label .nodeLabel,.mermaid svg .cluster span{fill:var(--brand-dark)!important;color:var(--brand-dark)!important;font-weight:600!important}.dark .mermaid svg .cluster-label .nodeLabel,.dark .mermaid svg .cluster span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg .edgePath path.path{stroke:#8b5cf6!important;stroke-width:1.5px!important}.dark .mermaid svg .edgePath path.path{stroke:#a78bfa!important}.mermaid svg .marker{fill:#8b5cf6!important;stroke:#8b5cf6!important}.dark .mermaid svg .marker{fill:#a78bfa!important;stroke:#a78bfa!important}.mermaid svg .label,.mermaid svg .nodeLabel,.mermaid svg .label text,.mermaid svg span{fill:#1e1b4b!important;color:#1e1b4b!important;font-family:\"DM Sans\", sans-serif!important}.dark .mermaid svg .label,.dark .mermaid svg .nodeLabel,.dark .mermaid svg .label text,.dark .mermaid svg span{fill:#e2e8f0!important;color:#e2e8f0!important}.mermaid svg .edgeLabel{background-color:#faf8ff!important}.dark .mermaid svg .edgeLabel{background-color:transparent!important}.mermaid svg .edgeLabel span{fill:#6d28d9!important;color:#6d28d9!important;font-size:13px!important}.dark .mermaid svg .edgeLabel span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg{background:transparent!important}#localization-select-trigger>div:first-child{display:none!important}[data-relocated-lang]{gap:0!important}::selection{background:var(--brand-subtle);color:var(--brand-dark)}.dark ::selection{background:var(--brand-dark);color:#ffffff}*:focus-visible{outline-color:var(--brand-primary)!important}::-webkit-scrollbar-thumb{background:var(--brand-light);border-radius:4px}::-webkit-scrollbar-thumb:hover{background:var(--brand-primary)}.cloo-badge{display:inline-block;font-family:\"DM Sans\", sans-serif;font-size:12px;font-weight:600;line-height:1.5;padding:0 8px;border-radius:6px;letter-spacing:-0.01em;vertical-align:middle;white-space:nowrap;margin-right:2px}.cloo-badge--required{background:#fef2f2;color:#b91c1c}.cloo-badge--multiworker{background:#fff7ed;color:#c2410c}.cloo-badge--recommended{background:#eff6ff;color:#1d4ed8}.cloo-badge--optional{background:#f1f5f9;color:#475569}.dark .cloo-badge--required{background:rgba(185, 28, 28, 0.2);color:#fca5a5}.dark .cloo-badge--multiworker{background:rgba(194, 65, 12, 0.2);color:#fdba74}.dark .cloo-badge--recommended{background:rgba(29, 78, 216, 0.22);color:#93c5fd}.dark .cloo-badge--optional{background:rgba(71, 85, 105, 0.28);color:#cbd5e1}"}]}
{"page":{"pagePath":"ko/workspace/knowledge","slug":"/ko/workspace/knowledge","pageMetadata":{"title":"지식기반","description":"문서 업로드, RAG 파이프라인, 동적 필터, AI 메타데이터 추출을 통한 지식기반 구축 및 관리","href":"/ko/workspace/knowledge"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"문서 업로드, RAG 파이프라인, 동적 필터, AI 메타데이터 추출을 통한 지식기반 구축 및 관리\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,blockquote:`blockquote`,code:`code`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,CodeBlock,Columns,Frame,Heading,Info,Mermaid,Note,OptimizedImage,Step,Steps,Tab,Table,Tabs,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`AI에게 질문했을 때 “모르겠습니다”라고 답하거나, 엉뚱한 답변을 하는 경우가 있습니다. 지식기반은 사내 문서를 AI가 직접 참조할 수 있도록 변환하여, `,_jsx(_components.strong,{children:`문서 근거 기반의 정확한 답변`}),`을 가능하게 합니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`예시`,children:`예시`}),`\n`,_jsxs(_components.blockquote,{children:[`\n`,_jsx(_components.p,{children:`“우리 회사 연차 규정이 어떻게 되나요?”`}),`\n`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`상태`}),_jsx(_components.th,{children:`동작`}),_jsx(_components.th,{children:`결과`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`지식기반 없음`}),_jsx(_components.td,{children:`AI의 일반 지식으로 답변`}),_jsx(_components.td,{children:`부정확하거나 “모르겠습니다”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`지식기반 연결`}),_jsx(_components.td,{children:`인사규정.pdf에서 관련 내용 검색 후 답변`}),_jsx(_components.td,{children:`정확한 규정 + 출처 표시`})]})]})]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`지식기반별로 `,_jsx(_components.strong,{children:`문서 처리 프로파일`}),`을 선택하여 추출 방식과 청킹 전략을 다르게 적용할 수 있습니다. 자세한 내용은 아래 `,_jsx(_components.a,{href:`#%EB%AC%B8%EC%84%9C-%EC%B2%98%EB%A6%AC-%ED%94%84%EB%A1%9C%ED%8C%8C%EC%9D%BC-%EC%84%A0%ED%83%9D`,children:`문서 처리 프로파일 선택`}),` 섹션을 참조하세요.`]})}),`\n`,_jsx(Frame,{caption:`워크스페이스 > 지식기반에서 생성된 지식기반 목록을 확인할 수 있습니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-list.png?fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=71604cb78f8532da68df08b6c1269880`,alt:`지식기반 목록`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/workspace/knowledge-list.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-list.png?w=280\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=dfb0b231fb20b2fdc0759f41d561af82 280w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-list.png?w=560\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=f8213c454ec1850071fffc2ba1bb225b 560w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-list.png?w=840\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=354c13e2df7c91f886fcede8f7bccc09 840w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-list.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=1562ea2cc184265c4438b749217f7d7a 1100w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-list.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=2e219a27f2a7a661c1bf51a40385f058 1650w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-list.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=ebf619f72881adbc17d08f31ff72de39 2500w`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`컬렉션과-라이브러리`,children:`컬렉션과 라이브러리`}),`\n`,_jsxs(_components.p,{children:[`지식 기반 목록에는 두 가지 카드가 섞여 있습니다. 카드 왼쪽 위 배지로 구분되며(`,_jsx(_components.strong,{children:`라이브러리`}),`는 파란 배지, `,_jsx(_components.strong,{children:`컬렉션`}),`은 초록 배지), 목록 오른쪽 위의 `,_jsx(_components.strong,{children:`+ 새 지식 기반`}),` · `,_jsx(_components.strong,{children:`새 라이브러리`}),` 버튼으로 각각 만듭니다.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{}),_jsx(_components.th,{children:_jsx(_components.strong,{children:`컬렉션`})}),_jsx(_components.th,{children:_jsx(_components.strong,{children:`라이브러리`})})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`구조`})}),_jsx(_components.td,{children:`폴더 없는 평평한 문서 묶음`}),_jsx(_components.td,{children:`폴더 트리를 가진 컨테이너`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`카드에 표시`})}),_jsx(_components.td,{children:`파일 수 · 마지막 업데이트`}),_jsx(_components.td,{children:`폴더 수 · 파일 수`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`적합한 경우`})}),_jsx(_components.td,{children:`한 주제의 문서를 한곳에 모을 때`}),_jsx(_components.td,{children:`이미 폴더로 분류된 문서 뭉치를 구조째 옮길 때`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`라이브러리-다루기`,children:`라이브러리 다루기`}),`\n`,_jsx(_components.p,{children:`라이브러리를 열면 왼쪽에 폴더 트리, 오른쪽에 선택한 폴더의 파일 목록이 나옵니다.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`조작`}),_jsx(_components.th,{children:`위치`}),_jsx(_components.th,{children:`동작`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`폴더 및 파일 검색`})}),_jsx(_components.td,{children:`트리 위 검색창`}),_jsxs(_components.td,{children:[`라이브러리 `,_jsx(_components.strong,{children:`전체 폴더`}),`를 한 번에 검색`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`폴더 가져오기 · 구조+파일`})}),_jsx(_components.td,{children:`트리 아래`}),_jsx(_components.td,{children:`내 PC 폴더를 하위 구조 그대로 통째로 가져오기`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`+ 새 컬렉션`})}),_jsx(_components.td,{children:`트리 아래`}),_jsx(_components.td,{children:`라이브러리 안에 새 폴더 만들기`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`전체 처리 · 미처리 N`})}),_jsx(_components.td,{children:`트리 아래 (미처리 파일이 있을 때만)`}),_jsx(_components.td,{children:`라이브러리 전체의 미처리 파일을 한 번에 임베딩`})]})]})]}),`\n`,_jsxs(Note,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`폴더 하나하나가 독립된 지식기반처럼 동작합니다.`}),` 새 폴더는 만들 때 부모의 `,_jsx(_components.strong,{children:`필터 스키마·추출 모드·추출 모델·검색 설정·접근 권한`}),`을 그대로 물려받고, 이후 폴더별로 따로 고칠 수 있습니다.`]}),_jsxs(_components.p,{children:[`단 `,_jsx(_components.strong,{children:`도구 설명만은 상속하지 않습니다.`}),` “이 폴더를 언제 검색할지”는 폴더마다 달라야 해서 빈 칸으로 시작합니다.`]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`라이브러리 폴더에서는 도구 설명 옆의 `,_jsx(_components.strong,{children:`AI`}),` 버튼이 그 폴더 하나가 아니라 `,_jsx(_components.strong,{children:`하위 트리 전체`}),`를 채웁니다. 하위 폴더는 파일명을 표본으로, 상위 폴더는 하위 폴더 설명을 요약해 아래에서 위로 생성되므로 `,_jsx(_components.strong,{children:`루트 폴더에서 한 번 누르면 라이브러리 전체`}),`가 채워집니다. 이미 설명이 있는 폴더는 건너뛰고, 끝나면 “폴더 N개의 도구 설명을 생성했습니다” 알림이 표시됩니다.`]})}),`\n`,_jsxs(_components.p,{children:[`에이전트에는 `,_jsx(_components.strong,{children:`라이브러리를 통째로 연결`}),`할 수 있습니다. 에이전트 편집 화면의 지식 선택 모달에 `,_jsx(_components.strong,{children:`라이브러리 / 컬렉션 / 문서`}),` 필터가 있어 유형별로 골라낼 수 있습니다.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`라이브러리나 폴더를 삭제하면 하위 트리 전체가 파일·벡터까지 함께 삭제됩니다.`}),` “소속만 해제”가 아니라 구조 자체를 지우는 동작이며 되돌릴 수 없습니다. 삭제 전 확인 창이 표시됩니다.`]})}),`\n`,_jsxs(_components.p,{children:[`이름 규칙도 다릅니다. 컬렉션 이름은 워크스페이스 전체에서 유일해야 하지만, 라이브러리 안의 폴더 이름은 `,_jsx(_components.strong,{children:`같은 부모 아래에서만`}),` 겹치지 않으면 됩니다. 부서별 라이브러리마다 “계약서” 폴더를 두는 식이 가능합니다.`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`폴더 이름 자체가 분류 축이라면(예: `,_jsx(_components.code,{children:`사업번호/문서종류/파일`}),`), 필터의 `,_jsx(_components.strong,{children:`폴더 매핑`}),`을 함께 설정하세요. 폴더째 업로드할 때 폴더 이름이 그대로 메타데이터 값으로 채워져 LLM 추출이 필요 없습니다. 자세한 내용은 `,_jsx(_components.a,{href:`/ko/workspace/knowledge-filters#%ED%8F%B4%EB%8D%94-%EC%97%85%EB%A1%9C%EB%93%9C%EB%A1%9C-%EB%A9%94%ED%83%80%EB%8D%B0%EC%9D%B4%ED%84%B0-%EC%B1%84%EC%9A%B0%EA%B8%B0`,children:`동적 필터 상세 가이드`}),`를 참조하세요.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`rag-파이프라인`,children:`RAG 파이프라인`}),`\n`,_jsx(_components.p,{children:`문서가 업로드되면 다음 파이프라인을 거쳐 검색 가능한 상태로 변환됩니다.`}),`\n`,_jsx(Mermaid,{chart:`flowchart LR\n subgraph 문서_처리\n P[프로파일 적용] --> B[텍스트 추출]\n A[파일 업로드] --> P\n B --> C[청킹]\n C --> T{테이블 보존?}\n T -->|Yes| T2[테이블 분리 후 인접 청크에 보존]\n T -->|No| C2[일반 청킹]\n T2 --> CTX{문맥 보존?}\n C2 --> CTX\n CTX -->|Yes| CTX2[LLM 문맥 요약 추가]\n CTX -->|No| D[임베딩]\n CTX2 --> D\n D --> E[(벡터 DB)]\n end\n\n subgraph 검색_및_응답\n F[사용자 질문] --> G[쿼리 임베딩]\n G --> H[유사도 검색]\n E --> H\n H --> I[관련 문서]\n I --> J[LLM 응답 생성]\n J --> K[출처와 함께 답변]\n end`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`단계`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`프로파일 적용`})}),_jsx(_components.td,{children:`KB에 설정된 문서 처리 프로파일의 추출/청킹 전략을 적용합니다`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`텍스트 추출`})}),_jsx(_components.td,{children:`문서에서 텍스트를 추출합니다 (기본, OCR, LLM 비전 등 프로파일에 따라 결정)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`청킹`})}),_jsx(_components.td,{children:`긴 문서를 검색에 적합한 크기로 분할합니다 (고정 크기 또는 시맨틱)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`테이블 보존`})}),_jsx(_components.td,{children:`테이블을 분리하지 않고 인접 청크에 통째로 보존합니다 (프로파일 설정에 따라)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`문맥 보존`})}),_jsx(_components.td,{children:`각 청크에 전체 문서 맥락 요약을 LLM이 추가합니다 (프로파일 설정에 따라)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`임베딩`})}),_jsx(_components.td,{children:`텍스트를 고차원 벡터로 변환합니다`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`유사도 검색`})}),_jsx(_components.td,{children:`질문과 가장 유사한 문서 청크를 검색합니다`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`LLM 응답 생성`})}),_jsx(_components.td,{children:`검색된 문서를 컨텍스트로 활용하여 답변을 생성합니다`})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`지식기반-생성`,children:`지식기반 생성`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`기본 정보 입력`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`워크스페이스 > 지식기반`}),`에서 우측 상단의 `,_jsx(_components.strong,{children:`+ 새 지식 기반`}),`을 누르면 생성 폼이 열립니다.\n이름과 설명을 입력하고 권한을 설정합니다.`]}),_jsx(Frame,{caption:`이름과 설명을 입력하고 접근 권한을 설정합니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/knowledge-create.png?fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=94126c1301715019dae8f56288b44572`,alt:`지식기반 생성 폼`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/workspace/knowledge-create.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/knowledge-create.png?w=280\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=b84b17775185b8b41244aaa8c743d954 280w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/knowledge-create.png?w=560\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=5971d1b643e707766b1058e40fd588b1 560w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/knowledge-create.png?w=840\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=8111e3f4700c363a58639f5960138207 840w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/knowledge-create.png?w=1100\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=9999e1132761e1c84945514d66dd4a23 1100w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/knowledge-create.png?w=1650\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=980b7b9e5fb49d14fd40e5d6c0493903 1650w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/knowledge-create.png?w=2500\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=a5c32661b82b739e7650e97861c92502 2500w`})}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`필드`}),_jsx(_components.th,{children:`설명`}),_jsx(_components.th,{children:`예시`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`이름`})}),_jsx(_components.td,{children:`지식기반 이름 (필수)`}),_jsx(_components.td,{children:`“인사 규정 2024”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`설명`})}),_jsx(_components.td,{children:`용도 및 내용 설명 (필수)`}),_jsx(_components.td,{children:`“인사팀 규정 및 가이드라인”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`권한`})}),_jsxs(_components.td,{children:[`공개 / 비공개. 비공개면 아래 `,_jsx(_components.strong,{children:`그룹`}),` 카드에서 대상 지정`]}),_jsx(_components.td,{children:`비공개 + “영업팀”`})]})]})]})]}),_jsxs(Step,{title:`문서 업로드`,children:[_jsxs(_components.p,{children:[`생성된 지식기반에 문서를 추가합니다. `,_jsx(_components.strong,{children:`내용 추가`}),`(+) 버튼을 클릭하여 업로드 방법을 선택합니다.`]}),_jsx(Frame,{caption:`내용 추가(+) 버튼으로 파일 업로드, 텍스트 입력, 클라우드 소스를 선택합니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-detail.png?fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=fcdb58815ee5cc5e6462290a2525d03a`,alt:`지식기반 상세`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/workspace/knowledge-detail.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-detail.png?w=280\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=d141a60d46bac77e069d25431ad9affd 280w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-detail.png?w=560\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=132ef9ff783b6cc0db708ac66bfa23d2 560w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-detail.png?w=840\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=ed2e3e8fe6791128f5be284231bdba3a 840w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-detail.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=0eb83e5ec548e11aa9e16058eb1178a1 1100w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-detail.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=0e6a93a66871e7fd8ae4318dac8d8b21 1650w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-detail.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=67d48b13b1dc550749f2498f8221da6f 2500w`})}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`업로드 방법:`})}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`방법`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`드래그 앤 드롭`})}),_jsx(_components.td,{children:`파일을 업로드 영역으로 끌어다 놓기`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`파일 업로드`})}),_jsx(_components.td,{children:`”내용 추가” 메뉴에서 “파일 업로드” 선택`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`디렉토리 업로드`})}),_jsx(_components.td,{children:`”내용 추가” 메뉴에서 “디렉토리 업로드” 선택 — 폴더 내 모든 파일을 일괄 업로드`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`클라우드 스토리지`})}),_jsx(_components.td,{children:`Google Drive, OneDrive, SharePoint (관리자가 연동 설정 시 표시)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`글 추가`})}),_jsx(_components.td,{children:`텍스트를 직접 작성하여 추가`})]})]})]})]}),_jsxs(Step,{title:`처리 대기`,children:[_jsx(_components.p,{children:`업로드된 문서는 자동으로 텍스트 추출 → 청킹 → 임베딩 → 인덱싱 과정을 거칩니다.\n처리가 완료되면 실시간 알림이 표시됩니다.`}),_jsx(Note,{children:_jsx(_components.p,{children:`파일 처리가 30분 이상 걸리면 자동으로 실패 처리됩니다. 이 경우 파일을 삭제 후 다시 업로드하세요.`})}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`대용량 업로드 시:`})}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`5개 이상 파일 또는 디렉토리 업로드 시 `,_jsx(_components.strong,{children:`배치 모드`}),`로 전환됩니다`]}),`\n`,_jsx(_components.li,{children:`상단에 진행률 바가 표시되며 (업로드 → 처리 단계별), 실패 건수가 빨간색으로 표기됩니다`}),`\n`,_jsx(_components.li,{children:`동시 3개 파일을 병렬 처리합니다`}),`\n`,_jsx(_components.li,{children:`페이지를 새로고침해도 진행 상태가 복원됩니다`}),`\n`]})]}),_jsx(Step,{title:`확인 및 검증`,children:_jsxs(_components.p,{children:[`문서를 클릭하여 추출된 텍스트 내용을 확인하고, 에이전트에 연결하여 검색 품질을 검증합니다. 파일 목록에서 `,_jsx(_components.strong,{children:`요약`}),` 토글을 켜면 AI가 생성한 문서 요약을 확인할 수 있습니다.`]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`지원-파일-형식`,children:`지원 파일 형식`}),`\n`,_jsxs(_components.p,{children:[`기본 추출 엔진 기준으로 다음 형식의 텍스트를 인식합니다. 추출 엔진을 변경하면 인식 범위가 넓어집니다 (아래 `,_jsx(_components.a,{href:`#%EC%B6%94%EC%B6%9C-%EC%97%94%EC%A7%84`,children:`추출 엔진`}),` 참조).`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`카테고리`}),_jsx(_components.th,{children:`지원 형식`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`문서`})}),_jsx(_components.td,{children:`PDF, DOCX, RST, EPUB, MSG (Outlook 메일)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`스프레드시트`})}),_jsx(_components.td,{children:`XLSX, XLS, CSV`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`프레젠테이션`})}),_jsx(_components.td,{children:`PPTX, PPT`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`웹·마크업`})}),_jsx(_components.td,{children:`HTML, HTM, XML, MD`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`텍스트·소스코드`})}),_jsx(_components.td,{children:`TXT, PY, JS, TS, JSON, SQL, JAVA, GO, C, C++, CS, RB, RS, PHP, SH 등 50여 종`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`목록에 없는 확장자도 업로드는 가능하며 텍스트로 읽기를 시도합니다. 다만 ZIP·실행파일 같은 이진 파일은 내용이 깨진 채로 들어갈 수 있으므로 위 형식 위주로 업로드하는 것을 권장합니다. 관리자가 `,_jsx(_components.strong,{children:`허용 확장자 화이트리스트`}),`를 설정하면 지정한 형식만 업로드되도록 제한할 수 있습니다.`]})}),`\n`,_jsx(Heading,{level:`4`,id:`최대-크기-/-개수`,children:`최대 크기 / 개수`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`항목`}),_jsx(_components.th,{style:{textAlign:`center`},children:`기본값`}),_jsx(_components.th,{children:`변경 위치`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`업로드 최대 사이즈`})}),_jsx(_components.td,{style:{textAlign:`center`},children:`제한 없음`}),_jsx(_components.td,{children:`관리자 패널 > 설정 > 문서 > 파일 (단위: MB)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`업로드 최대 수`})}),_jsx(_components.td,{style:{textAlign:`center`},children:`제한 없음`}),_jsx(_components.td,{children:`관리자 패널 > 설정 > 문서 > 파일`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`두 값 모두 기본적으로 `,_jsx(_components.strong,{children:`무제한`}),`입니다. 관리자가 값을 비워두면 제한이 없고, 숫자를 입력하면 그 한도를 초과하는 파일은 업로드 시 거부됩니다.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`동적-필터`,children:`동적 필터`}),`\n`,_jsx(_components.p,{children:`동적 필터를 사용하면 지식기반 내 문서를 메타데이터 기준으로 분류하고, 검색 시 자동으로 범위를 제한할 수 있습니다.`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`동적 필터의 내부 동작 원리, Manual vs AI 비교, 5단계 검색 흐름 등 상세한 내용은 `,_jsx(_components.a,{href:`/ko/workspace/knowledge-filters`,children:`동적 필터 상세 가이드`}),`를 참조하세요.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`필터-스키마-정의`,children:`필터 스키마 정의`}),`\n`,_jsxs(_components.p,{children:[`지식기반 설정에서 `,_jsx(_components.strong,{children:`“필터 설정”`}),` → `,_jsx(_components.strong,{children:`“필터 추가”`}),` 버튼을 클릭하여 필터 필드를 정의합니다.`]}),`\n`,_jsx(Frame,{caption:`필터 필드를 정의하여 문서를 메타데이터 기준으로 분류합니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/V5hK-EjP5aTzhpjg/images/workspace/knowledge-filter-schema.png?fit=max\u0026auto=format\u0026n=V5hK-EjP5aTzhpjg\u0026q=85\u0026s=62f9be72af53961de5609fc548bea942`,alt:`필터 스키마 정의`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1920`,height:`1920`,\"data-path\":`images/workspace/knowledge-filter-schema.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/V5hK-EjP5aTzhpjg/images/workspace/knowledge-filter-schema.png?w=280\u0026fit=max\u0026auto=format\u0026n=V5hK-EjP5aTzhpjg\u0026q=85\u0026s=8515099deb54cc40ab8074a17985f350 280w, https://mintcdn.com/cloocus/V5hK-EjP5aTzhpjg/images/workspace/knowledge-filter-schema.png?w=560\u0026fit=max\u0026auto=format\u0026n=V5hK-EjP5aTzhpjg\u0026q=85\u0026s=32e7a6389990ba7d3d36c84eff364840 560w, https://mintcdn.com/cloocus/V5hK-EjP5aTzhpjg/images/workspace/knowledge-filter-schema.png?w=840\u0026fit=max\u0026auto=format\u0026n=V5hK-EjP5aTzhpjg\u0026q=85\u0026s=4b0898af3045ea5de4fa23ac0a021b27 840w, https://mintcdn.com/cloocus/V5hK-EjP5aTzhpjg/images/workspace/knowledge-filter-schema.png?w=1100\u0026fit=max\u0026auto=format\u0026n=V5hK-EjP5aTzhpjg\u0026q=85\u0026s=40ab2dbc1f2554d0e2316807e9f1e693 1100w, https://mintcdn.com/cloocus/V5hK-EjP5aTzhpjg/images/workspace/knowledge-filter-schema.png?w=1650\u0026fit=max\u0026auto=format\u0026n=V5hK-EjP5aTzhpjg\u0026q=85\u0026s=7b387bea6fc5a665e002e1ec3dde7a7b 1650w, https://mintcdn.com/cloocus/V5hK-EjP5aTzhpjg/images/workspace/knowledge-filter-schema.png?w=2500\u0026fit=max\u0026auto=format\u0026n=V5hK-EjP5aTzhpjg\u0026q=85\u0026s=3ad5b777f4400a85107a01d8b4a5a9e7 2500w`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`설정`}),_jsx(_components.th,{children:`설명`}),_jsx(_components.th,{children:`예시`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`항목명`})}),_jsx(_components.td,{children:`필터 필드 이름`}),_jsx(_components.td,{children:`”부서”, “연도”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`유형`})}),_jsx(_components.td,{children:`데이터 유형`}),_jsx(_components.td,{children:`단일 선택, 다중 선택, 용어집, 날짜, 숫자`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`필수 항목으로 지정`})}),_jsx(_components.td,{children:`필수 필드 설정 시 미입력 파일에 경고 표시`}),_jsx(_components.td,{children:`필수 여부 ON/OFF 토글`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`폴더 매핑`})}),_jsx(_components.td,{children:`폴더 업로드 시 해당 깊이의 폴더명을 값으로 자동 저장`}),_jsx(_components.td,{children:`없음 / 1~3단계 폴더`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`필터 옵션`})}),_jsx(_components.td,{children:`선택 가능한 값 목록 (단일 선택/다중 선택 타입)`}),_jsx(_components.td,{children:`“재무팀, 인사팀, 개발팀”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`에이전트 설명`})}),_jsx(_components.td,{children:`AI가 필터를 이해하기 위한 설명`}),_jsx(_components.td,{children:`”문서가 속한 부서를 필터링합니다”`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`필터-타입`,children:`필터 타입`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`타입`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`단일 선택`})}),_jsx(_components.td,{children:`미리 정의된 옵션 중 단일 선택`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`다중 선택`})}),_jsx(_components.td,{children:`미리 정의된 옵션 중 복수 선택`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`용어집`})}),_jsx(_components.td,{children:`용어집을 선정하여 필터 정의`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`날짜`})}),_jsx(_components.td,{children:`날짜 범위 필터`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`숫자`})}),_jsx(_components.td,{children:`정수값 필터`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`파일별-메타데이터-설정`,children:`파일별 메타데이터 설정`}),`\n`,_jsxs(_components.p,{children:[`필터 스키마 정의 후, 각 파일에 메타데이터 값을 지정합니다. 파일 행 오른쪽 끝의 `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`채워진 항목 수 / 전체 필터 수`})}),` 배지로 설정 상태를 한눈에 볼 수 있습니다.`]}),`\n`,_jsx(Frame,{caption:`파일별 메타데이터 설정 상태가 채움 배지로 표시됩니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-metadata.png?fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=4a90106118a57aada1a7c20c75f9dae2`,alt:`파일 메타데이터 입력`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/workspace/knowledge-metadata.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-metadata.png?w=280\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=c3bd026cfff98b2a880a2fd604d08d0f 280w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-metadata.png?w=560\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=7fb49643d781f2901cda77f588127e36 560w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-metadata.png?w=840\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=8e17f6d86e5644305ef6b299a5ff0b7f 840w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-metadata.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=fdec5c0f1e8a20a753a2de29fc2997fc 1100w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-metadata.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=a39826ea1541248210dd619b08c74332 1650w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-metadata.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=b192fdc6a10a458d59268a53860a3dd6 2500w`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`배지 색`}),_jsx(_components.th,{children:`의미`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`초록`})}),_jsx(_components.td,{children:`모든 필터 필드에 값이 설정됨`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`파랑`})}),_jsx(_components.td,{children:`필수 필드는 채워졌고 선택 필드 일부가 비어 있음`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`주황`})}),_jsx(_components.td,{children:`필수 필드가 비어 있음`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`회색`})}),_jsx(_components.td,{children:`채워진 값이 없고 필수 필터도 없음`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`AI 추출 중에는 숫자 대신 `,_jsx(_components.strong,{children:`“추출 중”`}),` 배지가 표시되며, 필터를 하나도 만들지 않았다면 배지 자체가 나타나지 않습니다. 색은 채운 개수가 아니라 `,_jsx(_components.strong,{children:`필수 항목 충족 여부`}),`로 정해집니다.`]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`메타데이터 변경 시 벡터 인덱스가 자동으로 업데이트됩니다. 재임베딩 없이 기존 벡터를 유지합니다.`})}),`\n`,_jsx(Heading,{level:`3`,id:`ai-자동-추출`,children:`AI 자동 추출`}),`\n`,_jsxs(_components.p,{children:[`필터 스키마에 `,_jsx(_components.strong,{children:`추출 프롬프트`}),`를 설정하면, 파일 업로드 시 LLM이 문서 내용과 파일 제목을 분석하여 메타데이터를 자동으로 추출합니다.`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`추출 모드 설정`,children:_jsxs(_components.p,{children:[`필터 스키마에서 `,_jsx(_components.strong,{children:`수동 / AI`}),` 토글 버튼을 클릭하여 AI 모드로 전환합니다.`]})}),_jsx(Step,{title:`추출 프롬프트 작성`,children:_jsx(_components.p,{children:`각 필터에 추출 프롬프트를 작성합니다.\n예: “파일 제목에서 국가명을 추출하세요”`})}),_jsx(Step,{title:`AI 모델 선택`,children:_jsx(_components.p,{children:`추출에 사용할 LLM 모델을 선택합니다.`})}),_jsx(Step,{title:`추출 실행`,children:_jsx(_components.p,{children:`파일 업로드 시 자동 실행되거나, 수동으로 단일/전체 추출을 실행합니다.`})})]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`추출 방법`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`자동 추출`})}),_jsx(_components.td,{children:`파일 업로드 직후 자동 실행 (AI 모드 + 추출 힌트가 있을 때)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`AI 추출`})}),_jsx(_components.td,{children:`파일을 클릭하면 열리는 메타데이터 패널에서 그 파일만 다시 추출`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`추출 (N)`})}),_jsx(_components.td,{children:`파일 목록 상단 도구 막대에서 체크한 파일을 일괄 추출`})]})]})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`추출 프롬프트에서 “파일 제목”을 조건으로 활용할 수 있습니다.\n예: “파일 제목 앞에 [XX] 국가명이 있으면 해당 국가 코드를 추출하세요”`})}),`\n`,_jsx(Heading,{level:`3`,id:`검색-시-필터-활용`,children:`검색 시 필터 활용`}),`\n`,_jsx(_components.p,{children:`에이전트에 연결된 지식기반에 동적 필터가 설정되어 있으면, AI가 사용자 질문에서 필터 조건을 자동으로 추론하여 검색 범위를 제한합니다.`}),`\n`,_jsx(CodeBlock,{numberOfLines:`4`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Q: 재무팀의 2024년 규정을 알려주세요`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`→ 필터 자동 적용: 부서=재무팀, 연도=2024`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`→ 해당 조건에 맞는 문서만 검색`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`도구-설명`,children:`도구 설명`}),`\n`,_jsxs(_components.p,{children:[`지식기반 상세 화면 상단의 `,_jsx(_components.strong,{children:`도구 설명`}),`은 에이전트가 이 지식기반을 `,_jsx(_components.strong,{children:`언제, 어떤 상황에서`}),` 검색해야 하는지 안내하는 AI 전용 설명입니다. 화면에도 “에이전트가 이 지식기반을 언제 검색해야 할지 설명하세요.” 라고 표시됩니다.`]}),`\n`,_jsx(Accordion,{title:`좋은 도구 설명 예시`,id:`%ED%9A%8C%EC%82%AC-%EC%9D%B8%EC%82%AC-%EA%B7%9C%EC%A0%95-%EB%B0%8F-%EB%82%B4%EB%B6%80-%EA%B0%80%EC%9D%B4%EB%93%9C%EB%9D%BC%EC%9D%B8%EC%97%90-%EB%8C%80%ED%95%9C-%EC%A7%88%EB%AC%B8%EC%9D%B4-%EC%9E%88%EC%9D%84-%EB%95%8C-%EC%82%AC%EC%9A%A9%ED%95%A9%EB%8B%88%EB%8B%A4.-%EC%97%B0%EC%B0%A8%2C-%EB%B3%B5%EB%A6%AC%ED%9B%84%EC%83%9D%2C-%EC%B6%9C%EC%9E%A5-%EC%A0%95%EC%B1%85-%EB%93%B1-hr-%EA%B4%80%EB%A0%A8-%EB%AC%B8%EC%9D%98%EC%97%90-%EC%B0%B8%EC%A1%B0%ED%95%98%EC%84%B8%EC%9A%94.`,children:_jsx(CodeBlock,{numberOfLines:`3`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`회사 인사 규정 및 내부 가이드라인에 대한 질문이 있을 때 사용합니다.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`연차, 복리후생, 출장 정책 등 HR 관련 문의에 참조하세요.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})}),`\n`,_jsx(_components.p,{children:`도구 설명이 비어 있으면 지식기반의 일반 설명이 대신 사용됩니다. AI가 여러 지식기반 중 적절한 것을 선택하도록 구체적인 도구 설명을 작성하는 것을 권장합니다.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`AI 자동 생성:`}),` 도구 설명 옆의 `,_jsx(_components.strong,{children:`AI`}),` 버튼을 클릭하면, 지식기반 이름·설명·파일 목록·필터 정보를 종합하여 AI가 도구 설명을 자동 작성합니다. 바로 옆 드롭다운에서 생성에 쓸 모델을 고를 수 있습니다.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`도구 설명이 빈 지식기반을 에이전트에 연결하면 지식 목록 위에 `,_jsx(_components.strong,{children:`“도구 설명이 누락되었습니다”`}),` 경고가 뜨고 해당 항목 이름이 나열됩니다. 저장은 되지만, 에이전트가 그 지식기반을 언제 써야 할지 판단하기 어려워집니다.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`필터 편집 폼 안에도 `,_jsx(_components.strong,{children:`에이전트 설명`}),`이라는 입력란이 따로 있습니다. 이쪽은 `,_jsx(_components.strong,{children:`필터 하나`}),`에 대한 설명이고, 여기 도구 설명은 `,_jsx(_components.strong,{children:`지식기반 전체`}),`에 대한 설명입니다. 두 항목의 차이는 `,_jsx(_components.a,{href:`/ko/workspace/knowledge-filters#%EB%8F%84%EA%B5%AC-%EC%84%A4%EB%AA%85%EA%B3%BC-%ED%95%84%ED%84%B0%EB%B3%84-%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8-%EC%84%A4%EB%AA%85`,children:`동적 필터 상세 가이드`}),`에서 정리했습니다.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`지식기반-관리`,children:`지식기반 관리`}),`\n`,_jsx(Heading,{level:`3`,id:`문서-관리`,children:`문서 관리`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`작업`}),_jsx(_components.th,{children:`방법`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`문서 추가`})}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`내용 추가`}),`(+) 버튼 또는 드래그 앤 드롭`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`문서 삭제`})}),_jsx(_components.td,{children:`문서 선택 후 삭제 버튼`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`내용 확인`})}),_jsx(_components.td,{children:`문서 클릭 시 추출된 텍스트 미리보기`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`검색`})}),_jsx(_components.td,{children:`파일명으로 검색 (서버 사이드, 대규모 KB에서도 빠름)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`정렬`})}),_jsx(_components.td,{children:`최신순(기본) / 오래된순 / 이름순`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`변경 이력 확인`})}),_jsxs(_components.td,{children:[`상단 `,_jsx(_components.strong,{children:`활동 이력`}),` 버튼`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`파일 목록은 `,_jsx(_components.strong,{children:`무한 스크롤`}),`로 50건 단위로 자동 로드됩니다.`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`파일 상태 뱃지:`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`뱃지`}),_jsx(_components.th,{style:{textAlign:`left`},children:`의미`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.strong,{children:`실패`}),` (빨강)`]}),_jsx(_components.td,{style:{textAlign:`left`},children:`처리 실패 — 옆의 재시도 버튼으로 다시 시도`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.strong,{children:`처리 중`}),` (주황)`]}),_jsx(_components.td,{style:{textAlign:`left`},children:`처리 진행 중`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.strong,{children:`요약`}),` (토글)`]}),_jsx(_components.td,{style:{textAlign:`left`},children:`처리 완료 + 요약 있음 — 클릭하여 인라인 요약 확인`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.strong,{children:`N/M`}),` (채움 배지)`]}),_jsx(_components.td,{style:{textAlign:`left`},children:`필터가 있을 때만 표시되는 메타데이터 채움 상태`})]})]})]}),`\n`,_jsxs(Note,{children:[_jsxs(_components.p,{children:[`같은 이름의 파일을 다시 업로드하면 `,_jsx(_components.strong,{children:`중복 확인 다이얼로그`}),`가 표시됩니다.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`선택지`}),_jsx(_components.th,{style:{textAlign:`left`},children:`동작`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Overwrite`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`기존 파일을 삭제하고 새 파일로 교체`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Skip`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`중복 파일을 건너뛰고 기존 파일 유지`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Cancel`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`업로드 취소`})]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`재색인`,children:`재색인`}),`\n`,_jsxs(_components.p,{children:[`전체 지식기반의 벡터 인덱스를 재구축하려면 `,_jsx(_components.strong,{children:`관리자 패널 > 설정 > 문서`}),` 페이지에서 `,_jsx(_components.strong,{children:`재색인`}),` 버튼을 클릭하여 `,_jsx(_components.strong,{children:`지식 베이스 벡터 재색인`}),`을 실행합니다. 이 기능은 관리자 전용이며 모든 지식기반을 대상으로 일괄 처리됩니다.`]}),`\n`,_jsx(_components.p,{children:`개별 파일의 내용을 수정하고 저장하면 해당 파일만 자동으로 재처리됩니다.`}),`\n`,_jsx(Heading,{level:`3`,id:`채팅에서-사용`,children:`채팅에서 사용`}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`@ 명령어`,id:`%40-%EB%AA%85%EB%A0%B9%EC%96%B4`,children:[_jsxs(_components.p,{children:[`채팅 중 `,_jsx(_components.code,{children:`@지식기반이름`}),`으로 직접 참조합니다.`]}),_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`@인사규정 연차 신청 절차가 어떻게 되나요?`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsx(Tab,{title:`에이전트 연결`,id:`%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8-%EC%97%B0%EA%B2%B0`,children:_jsx(_components.p,{children:`에이전트 설정에서 지식기반을 연결하면 자동으로 참조합니다. 사용자는 별도 명령 없이 대화하면 됩니다.`})})]}),`\n`,_jsx(_components.p,{children:`AI 응답에 포함된 인용 번호를 클릭하면 원문 내용을 확인할 수 있습니다.`}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`문서-처리-프로파일-선택`,children:`문서 처리 프로파일 선택`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`신규 기능`}),` — 지식기반별로 서로 다른 문서 처리 전략(추출 엔진, 청킹 방식, 테이블 보존 등)을 적용할 수 있습니다.`]})}),`\n`,_jsxs(_components.p,{children:[`관리자가 `,_jsx(_components.strong,{children:`관리자 패널 > 설정 > 문서`}),`에서 사전에 정의한 프로파일 중 하나를 선택합니다. 프로파일을 선택하지 않으면 기본(default) 프로파일이 적용됩니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`프로파일-활용-예시`,children:`프로파일 활용 예시`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`지식기반`}),_jsx(_components.th,{children:`추천 프로파일`}),_jsx(_components.th,{children:`이유`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`인사 규정 (텍스트 PDF)`}),_jsx(_components.td,{children:`기본 추출`}),_jsx(_components.td,{children:`단순 텍스트, 추가 비용 없음`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`재무보고서 (표 많음)`}),_jsx(_components.td,{children:`테이블 보존 활성`}),_jsx(_components.td,{children:`표 데이터 검색 정확도 향상`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`스캔 문서 (이미지 PDF)`}),_jsx(_components.td,{children:`LLM 비전`}),_jsx(_components.td,{children:`이미지 속 텍스트까지 정확하게 추출`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`기술 문서 (긴 보고서)`}),_jsx(_components.td,{children:`시맨틱 청킹 + 문맥 보존`}),_jsx(_components.td,{children:`주제별 분리 + 앞부분 맥락 유지`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`프로파일은 관리자만 생성할 수 있습니다. 필요한 프로파일이 없으면 관리자에게 요청하세요. 프로파일 설정 방법은 `,_jsx(_components.a,{href:`/ko/admin/settings/documents#%EB%AC%B8%EC%84%9C-%EC%B2%98%EB%A6%AC-%ED%94%84%EB%A1%9C%ED%8C%8C%EC%9D%BC`,children:`관리자 패널 > 설정 > 문서`}),`를 참조하세요.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`고급-설정`,children:`고급 설정`}),`\n`,_jsx(_components.p,{children:`관리자 설정에서 문서 처리 방식과 검색 파라미터를 조정할 수 있습니다.`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`아래 설정은 `,_jsx(_components.strong,{children:`문서 처리 프로파일이 지정되지 않은 경우`}),`의 전역 기본값입니다. 프로파일이 지정된 KB는 프로파일 설정이 우선 적용됩니다.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`추출-엔진`,children:`추출 엔진`}),`\n`,_jsx(_components.p,{children:`문서에서 텍스트를 추출하는 엔진을 선택할 수 있습니다. 관리자 설정에서 변경합니다.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`엔진`}),_jsx(_components.th,{children:`특징`}),_jsx(_components.th,{children:`적합한 경우`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`기본 내장 엔진`})}),_jsx(_components.td,{children:`PyPDF/Langchain 기반 추출, 별도 설정 불필요`}),_jsx(_components.td,{children:`일반 텍스트 PDF, DOCX`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`티카(Tika)`})}),_jsx(_components.td,{children:`서버 필요, 다양한 포맷 지원`}),_jsx(_components.td,{children:`다양한 파일 형식 혼합`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Docling`})}),_jsx(_components.td,{children:`서버 필요`}),_jsx(_components.td,{children:`레이아웃이 복잡한 문서`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`문서 인텔리전스`})}),_jsx(_components.td,{children:`Azure Document Intelligence (Azure 구독 필요), 고정밀 OCR`}),_jsx(_components.td,{children:`스캔 문서, 표가 많은 PDF`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Mistral OCR`})}),_jsx(_components.td,{children:`Mistral API 필요`}),_jsx(_components.td,{children:`PDF OCR`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Google Cloud Document AI`})}),_jsx(_components.td,{children:`GCP 구독 필요`}),_jsx(_components.td,{children:`이미지 포함 문서`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`LLM 비전`})}),_jsx(_components.td,{children:`Vision LLM 기반, 고정밀`}),_jsx(_components.td,{children:`복잡한 레이아웃, 차트 포함 문서`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`이미지 파일(PNG, JPG 등)`}),` 은 기본적으로 텍스트 인덱싱 대상이 아닙니다 — 업로드해도 저장만 되고 내용은 검색되지 않습니다. 이미지 속 텍스트까지 검색하려면 해당 지식기반의 문서 처리 프로파일을 `,_jsx(_components.strong,{children:`Google Cloud Document AI`}),` 또는 `,_jsx(_components.strong,{children:`LLM 비전`}),` 으로 지정하세요. (문서 인텔리전스·Mistral OCR은 PDF·오피스 문서는 처리하지만 단독 이미지 파일은 지원하지 않습니다.)`]})}),`\n`,_jsx(Heading,{level:`3`,id:`문서-처리-프로파일-옵션`,children:`문서 처리 프로파일 옵션`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`설정`}),_jsx(_components.th,{children:`설명`}),_jsx(_components.th,{children:`기본값`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`이름`})}),_jsx(_components.td,{children:`문서 처리 프로파일 이름 입력`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`-`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`기본 엔진`})}),_jsx(_components.td,{children:`엔진 매핑되지 않은 확장자의 파일 처리에 사용할 엔진`}),_jsx(_components.td,{children:`기본 내장 엔진`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`확장자 → 엔진 매핑`})}),_jsx(_components.td,{children:`등록된 특정 확장자에 대하여 선택된 엔진 사용`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`-`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`텍스트 나누기`})}),_jsx(_components.td,{children:`텍스트를 나눌 유형을 선택 (기본값, 토큰, 시멘틱)`}),_jsx(_components.td,{children:`기본값 (캐릭터)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`테이블 보존`})}),_jsx(_components.td,{children:`청킹 시 테이블을 분리하지 않고 앞 텍스트 청크에 붙여서 보존`}),_jsx(_components.td,{children:`활성화`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`문맥 보존 청킹`})}),_jsx(_components.td,{children:`청크별 문맥 요약을 추가하여 검색 정확도를 향상`}),_jsx(_components.td,{children:`아래 주의 참고`})]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[`문맥 보존 청킹은 `,_jsx(_components.code,{children:`문맥 모델`}),` 을 함께 지정해야 실제로 동작합니다.`]}),` 새 프로파일에서는 스위치가 켜진 상태로 표시되지만 모델이 비어 있어 적용되지 않습니다. 사용하려면 모델을 고른 뒤 저장하세요. 또한 채팅에 그때그때 첨부하는 파일에는 적용되지 않고, 지식 기반에 적재하는 문서에만 적용됩니다.`]})}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`텍스트 나누기 옵션:`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`설정`}),_jsx(_components.th,{children:`설명`}),_jsx(_components.th,{style:{textAlign:`center`},children:`기본값`}),_jsx(_components.th,{children:`적용 모드`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Chunk 크기`})}),_jsx(_components.td,{children:`문서 분할 단위 (문자 수)`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:`1,000`}),_jsx(_components.td,{children:`기본값(캐릭터), 토큰`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Chunk 오버랩`})}),_jsx(_components.td,{children:`청크 간 중복 문자 수`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:`100`}),_jsx(_components.td,{children:`기본값(캐릭터), 토큰, 시멘틱`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`청크당 최소 토큰`})}),_jsx(_components.td,{children:`청크를 생성할 최소 문자 수`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:`-`}),_jsx(_components.td,{children:`기본값(캐릭터), 토큰, 시멘틱`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`청크당 최대 토큰`})}),_jsx(_components.td,{children:`청크를 생성할 최대 문자 수`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:`-`}),_jsx(_components.td,{children:`기본값(캐릭터), 토큰, 시멘틱`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`임계값 유형`})}),_jsx(_components.td,{children:`청크를 나누는 유사도 기준의 유형`}),_jsx(_components.td,{style:{textAlign:`center`},children:`백분위 (권장)`}),_jsx(_components.td,{children:`시멘틱`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`임계값`})}),_jsx(_components.td,{children:`임계값 유형 별 분할 결정 임계값`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:`-`}),_jsx(_components.td,{children:`시멘틱`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`임베딩-모델-엔진`,children:`임베딩 모델 엔진`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`엔진`}),_jsx(_components.th,{children:`특징`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`기본값 (SentenceTransformers)`})}),_jsx(_components.td,{children:`외부 전송 없음, 보안 우수`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Ollama`})}),_jsx(_components.td,{children:`로컬 서버, 커스텀 모델`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`OpenAI`})}),_jsx(_components.td,{children:`높은 품질, API 비용 발생`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Azure OpenAI`})}),_jsx(_components.td,{children:`기업 환경 최적화`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Gemini`})}),_jsx(_components.td,{children:`Google 임베딩 모델, GCP 연동`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Vertex AI`})}),_jsx(_components.td,{children:`GCP 관리형 임베딩 서비스`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`검색-설정`,children:`검색 설정`}),`\n`,_jsxs(_components.p,{children:[`검색 설정은 `,_jsx(_components.strong,{children:`전역 설정`}),`(관리자)과 `,_jsx(_components.strong,{children:`KB별 설정`}),` 두 레벨로 관리됩니다.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`설정`}),_jsx(_components.th,{style:{textAlign:`center`},children:`기본값`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Top K`})}),_jsx(_components.td,{style:{textAlign:`center`},children:`전역 설정 값`}),_jsx(_components.td,{children:`벡터 검색에서 가져올 청크 수`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`리랭커 Top K`})}),_jsx(_components.td,{style:{textAlign:`center`},children:`전역 설정 값`}),_jsx(_components.td,{children:`리랭킹 후 최종 반환할 청크 수`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`리랭커 임계값`})}),_jsx(_components.td,{style:{textAlign:`center`},children:`전역 설정 값`}),_jsx(_components.td,{children:`리랭킹 최소 점수 (낮을수록 더 많이 통과)`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`지식기반별로 검색 설정을 오버라이드할 수 있습니다. 지식기반 편집 화면 > `,_jsx(_components.strong,{children:`설정`}),` 아이콘을 클릭하세요.\n세 항목 모두 `,_jsx(_components.strong,{children:`빈 값으로 두면 전역 설정을 따르며`}),`, 입력란에 흐리게 보이는 숫자가 현재 적용 중인 전역 값입니다.\n전역 값은 `,_jsx(_components.strong,{children:_jsx(_components.a,{href:`/ko/admin/settings/search-engine`,children:`관리자 › 설정 › 검색 엔진`})}),` 에서 확인·변경합니다.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`kb별-문서-요약-설정`,children:`KB별 문서 요약 설정`}),`\n`,_jsxs(_components.p,{children:[`지식기반별로 `,_jsx(_components.strong,{children:`문서 요약 생성`}),`을 개별 제어할 수 있습니다. 검색 설정 모달의 `,_jsx(_components.strong,{children:`“파일 요약”`}),` 섹션에서 설정합니다.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`설정`}),_jsx(_components.th,{style:{textAlign:`left`},children:`설명`}),_jsx(_components.th,{style:{textAlign:`center`},children:`기본값`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`문서 내용 요약 활성화`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`파일 처리 완료 시 AI 요약 자동 생성`}),_jsx(_components.td,{style:{textAlign:`center`},children:`켜짐`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`요약 모델`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`요약에 사용할 LLM 모델`}),_jsx(_components.td,{style:{textAlign:`center`},children:`작업 모델 사용`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`요약이 생성된 파일은 목록에서 `,_jsx(_components.strong,{children:`“요약”`}),` 토글로 인라인 확인할 수 있습니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`질의예시-생성-multi-vector-search`,children:`질의예시 생성 (Multi-Vector Search)`}),`\n`,_jsxs(_components.p,{children:[`질의예시 생성을 활성화하면, 문서 청크마다 “`,_jsx(_components.strong,{children:`이 내용을 찾기 위해 사용자가 할 법한 질문`}),`”을 LLM이 미리 생성하여 별도 벡터로 저장합니다.`]}),`\n`,_jsx(Mermaid,{chart:`flowchart LR\n A[문서 청크] --> B[콘텐츠 벡터]\n A --> C[LLM이 예상 질문 생성]\n C --> D[질문 벡터]\n E[사용자 질문] --> F{검색}\n B --> F\n D --> F\n F --> G[가중 합산 결과]`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`상태`}),_jsx(_components.th,{children:`검색 방식`}),_jsx(_components.th,{children:`효과`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`비활성`}),_jsx(_components.td,{children:`콘텐츠 벡터만 사용`}),_jsx(_components.td,{children:`기본 검색`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`활성`}),_jsx(_components.td,{children:`콘텐츠 + 질문 벡터 가중 합산`}),_jsx(_components.td,{children:`사용자 질문과 유사한 표현으로 검색 정확도 향상`})]})]})]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`질의예시 생성을 활성화하면 문서 처리 시 LLM 호출이 추가됩니다. 처리 시간과 비용이 증가할 수 있습니다.`})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`KB별로 질의예시 생성을 개별 설정할 수 있습니다. 검색 설정 모달의 `,_jsx(_components.strong,{children:`“질의예시 생성”`}),` 섹션에서 글로벌 설정과 독립적으로 활성화/비활성화하고, 사용할 LLM 모델을 선택합니다.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`베스트-프랙티스`,children:`베스트 프랙티스`}),`\n`,_jsx(Heading,{level:`3`,id:`문서-준비`,children:`문서 준비`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`깔끔한 포맷`}),`: 제목, 소제목을 명확히 구분하고 일관된 스타일을 유지하세요`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`최신 버전 유지`}),`: 정기적으로 문서를 업데이트하고 오래된 문서는 삭제하세요`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`적절한 크기`}),`: 너무 큰 문서는 주제별로 분리하고, 관련 내용끼리 그룹화하세요`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`지식기반-구성`,children:`지식기반 구성`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`주제별 분리`}),`: “인사규정”, “IT가이드”, “제품매뉴얼” 등 주제별로 별도 지식기반을 구성하세요`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`접근 권한 세분화`}),`: 민감한 정보는 별도로 관리하고 부서별로 접근을 제한하세요`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`도구 설명 작성`}),`: 에이전트가 적절한 지식기반을 자동 선택하도록 구체적인 도구 설명을 작성하세요`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`활용-사례`,children:`활용 사례`}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`신입 사원 온보딩`,icon:`user-plus`,id:`-1`,children:[_jsx(_components.p,{children:`인사 규정, 업무 매뉴얼, IT 가이드를 지식기반으로 구축하면 신입 사원이 AI에게 질문하며 빠르게 적응할 수 있습니다.`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`지식기반: “인사규정”, “업무매뉴얼”, “IT이용가이드”`}),`\n`,_jsx(_components.li,{children:`에이전트에 3개 지식기반 연결`}),`\n`,_jsx(_components.li,{children:`도구 설명으로 각 KB의 용도를 명확히 구분`}),`\n`]})]}),_jsxs(Accordion,{title:`고객 지원 자동화`,icon:`headset`,id:`-2`,children:[_jsx(_components.p,{children:`제품 매뉴얼, FAQ, 기술 문서를 지식기반으로 구축하여 고객 문의에 정확한 답변을 제공합니다.`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`동적 필터: 제품명, 버전으로 필터링`}),`\n`,_jsx(_components.li,{children:`에이전트: 고객 지원용 시스템 프롬프트 + 지식기반 연결`}),`\n`,_jsx(_components.li,{children:`인용 출처 표시로 답변 신뢰도 확보`}),`\n`]})]}),_jsxs(Accordion,{title:`부서별 규정 관리`,icon:`building`,id:`-3`,children:[_jsx(_components.p,{children:`부서별 문서를 동적 필터로 분류하고, 부서에 따라 정확한 규정을 검색합니다.`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`동적 필터: 부서, 연도, 문서 유형`}),`\n`,_jsx(_components.li,{children:`AI 자동 추출로 메타데이터 자동 분류`}),`\n`,_jsx(_components.li,{children:`접근 권한으로 민감 문서 보호`}),`\n`]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`지식기반 용량 제한이 있나요?`,icon:`circle-question`,id:`-4`,children:_jsx(_components.p,{children:`기본 설정에서는 파일 수나 용량에 제한이 없습니다. 관리자가 환경 변수를 통해 제한을 설정할 수 있습니다.`})}),_jsx(Accordion,{title:`같은 파일을 다시 업로드하면 어떻게 되나요?`,icon:`circle-question`,id:`-5`,children:_jsxs(_components.p,{children:[`같은 이름의 파일이 감지되면 `,_jsx(_components.strong,{children:`중복 확인 다이얼로그`}),`가 표시됩니다. Overwrite(교체), Skip(건너뛰기), Cancel(취소) 중 선택할 수 있습니다.`]})}),_jsx(Accordion,{title:`PDF 이미지의 텍스트도 인식되나요?`,icon:`circle-question`,id:`pdf`,children:_jsxs(_components.p,{children:[`기본 추출 엔진은 PDF에 포함된 이미지에서 제한적으로 텍스트를 추출하지만, 스캔 문서나 이미지가 많은 PDF는 `,_jsx(_components.strong,{children:`문서 인텔리전스`}),`, `,_jsx(_components.strong,{children:`Google Cloud Document AI`}),`, `,_jsx(_components.strong,{children:`LLM 비전`}),` 엔진을 사용하면 훨씬 정확합니다. 단독 이미지 파일(PNG·JPG)을 업로드해 텍스트를 검색하려면 Google Cloud Document AI 또는 LLM 비전 프로파일이 필요합니다. 관리자에게 추출 엔진 설정을 확인하세요.`]})}),_jsx(Accordion,{title:`동적 필터의 메타데이터를 변경하면 재임베딩이 필요한가요?`,icon:`circle-question`,id:`-6`,children:_jsx(_components.p,{children:`아니요. 메타데이터 변경은 벡터 인덱스의 필터 필드만 업데이트하며, 기존 벡터는 그대로 유지됩니다. 재임베딩 없이 빠르게 처리됩니다.`})}),_jsxs(Accordion,{title:`여러 지식기반을 하나의 에이전트에 연결하면 검색 설정은 어떻게 되나요?`,icon:`circle-question`,id:`-7`,children:[_jsx(_components.p,{children:`여러 KB를 연결하면 검색 설정은 다음 규칙으로 병합됩니다:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Top K, 리랭커 Top K`}),`: 각 KB 중 `,_jsx(_components.strong,{children:`가장 큰 값`}),` 적용`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`리랭커 임계값`}),`: 각 KB 중 `,_jsx(_components.strong,{children:`가장 낮은 값`}),` 적용 (더 많은 결과 통과)`]}),`\n`]})]}),_jsx(Accordion,{title:`문서 처리 프로파일을 변경하면 기존 문서에 영향이 있나요?`,icon:`circle-question`,id:`-8`,children:_jsx(_components.p,{children:`프로파일을 변경해도 이미 처리된 문서의 벡터는 자동으로 재처리되지 않습니다. 변경된 프로파일을 기존 문서에 적용하려면 해당 문서를 삭제 후 다시 업로드하거나, 관리자 설정에서 전체 재색인을 실행하세요.`})}),_jsxs(Accordion,{title:`LLM 비전이나 문맥 보존 사용 시 비용이 얼마나 드나요?`,icon:`circle-question`,id:`llm`,children:[_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`LLM 비전`}),`: 페이지 수 × 1회 LLM 호출 + 제목 단계 정규화 1회`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`문맥 보존`}),`: 청크 수 × 1회 LLM 호출`]}),`\n`]}),_jsx(_components.p,{children:`10페이지 PDF + 20개 청크 기준으로 LLM 비전(11회) + 문맥 보존(20회) = 약 31회 LLM 호출입니다. 대용량 문서를 일괄 업로드하면 비용이 크게 증가할 수 있으므로 중요 문서에 선별적으로 사용하세요.`})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`관련-페이지`,children:`관련 페이지`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`동적 필터 상세`,icon:`filter`,href:`/ko/workspace/knowledge-filters`,children:_jsx(_components.p,{children:`필터 내부 동작 원리, Manual vs AI 비교, 5단계 검색 흐름`})}),_jsx(Card,{title:`지식 그래프`,icon:`share-nodes`,href:`/ko/workspace/knowledge-graph`,children:_jsx(_components.p,{children:`지식기반 + 용어집 + DB를 하나의 그래프로 통합 연결`})}),_jsx(Card,{title:`에이전트`,icon:`robot`,href:`/ko/workspace/agents`,children:_jsx(_components.p,{children:`지식기반을 에이전트에 연결하여 활용`})}),_jsx(Card,{title:`용어집`,icon:`book`,href:`/ko/workspace/glossary`,children:_jsx(_components.p,{children:`도메인 용어를 정의하여 AI 이해도 향상`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"지식기반","description":"문서 업로드, RAG 파이프라인, 동적 필터, AI 메타데이터 추출을 통한 지식기반 구축 및 관리","href":"/ko/workspace/knowledge"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"예시","slug":"예시","depth":3,"children":[]},{"title":"컬렉션과 라이브러리","slug":"컬렉션과-라이브러리","depth":2,"children":[{"title":"라이브러리 다루기","slug":"라이브러리-다루기","depth":3,"children":[]}]},{"title":"RAG 파이프라인","slug":"rag-파이프라인","depth":2,"children":[]},{"title":"지식기반 생성","slug":"지식기반-생성","depth":2,"children":[{"title":"지원 파일 형식","slug":"지원-파일-형식","depth":3,"children":[]},{"title":"최대 크기 / 개수","slug":"최대-크기-/-개수","depth":4,"children":[]}]},{"title":"동적 필터","slug":"동적-필터","depth":2,"children":[{"title":"필터 스키마 정의","slug":"필터-스키마-정의","depth":3,"children":[]},{"title":"필터 타입","slug":"필터-타입","depth":3,"children":[]},{"title":"파일별 메타데이터 설정","slug":"파일별-메타데이터-설정","depth":3,"children":[]},{"title":"AI 자동 추출","slug":"ai-자동-추출","depth":3,"children":[]},{"title":"검색 시 필터 활용","slug":"검색-시-필터-활용","depth":3,"children":[]}]},{"title":"도구 설명","slug":"도구-설명","depth":2,"children":[]},{"title":"지식기반 관리","slug":"지식기반-관리","depth":2,"children":[{"title":"문서 관리","slug":"문서-관리","depth":3,"children":[]},{"title":"재색인","slug":"재색인","depth":3,"children":[]},{"title":"채팅에서 사용","slug":"채팅에서-사용","depth":3,"children":[]}]},{"title":"문서 처리 프로파일 선택","slug":"문서-처리-프로파일-선택","depth":2,"children":[{"title":"프로파일 활용 예시","slug":"프로파일-활용-예시","depth":3,"children":[]}]},{"title":"고급 설정","slug":"고급-설정","depth":2,"children":[{"title":"추출 엔진","slug":"추출-엔진","depth":3,"children":[]},{"title":"문서 처리 프로파일 옵션","slug":"문서-처리-프로파일-옵션","depth":3,"children":[]},{"title":"임베딩 모델 엔진","slug":"임베딩-모델-엔진","depth":3,"children":[]},{"title":"검색 설정","slug":"검색-설정","depth":3,"children":[]},{"title":"KB별 문서 요약 설정","slug":"kb별-문서-요약-설정","depth":3,"children":[]},{"title":"질의예시 생성 (Multi-Vector Search)","slug":"질의예시-생성-multi-vector-search","depth":3,"children":[]}]},{"title":"베스트 프랙티스","slug":"베스트-프랙티스","depth":2,"children":[{"title":"문서 준비","slug":"문서-준비","depth":3,"children":[]},{"title":"지식기반 구성","slug":"지식기반-구성","depth":3,"children":[]}]},{"title":"활용 사례","slug":"활용-사례","depth":2,"children":[]},{"title":"FAQ","slug":"faq","depth":2,"children":[]},{"title":"관련 페이지","slug":"관련-페이지","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/cloocus/45db6ee3c57396cb/toc.js","/_mintlify/custom/cloocus/9670a2c81dc38d5e/tools/playwright-video-mcp/index.js","/_mintlify/custom/cloocus/4540e1c308555295/lang-toggle.js"],"subdomain":"cloocus","siteName":"Cloosphere Guide","title":"지식기반 - Cloosphere Guide","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"ko":{"href":"/ko/workspace/knowledge","matchLevel":0},"en":{"href":"/en/workspace/knowledge","matchLevel":1}}},"lastModified":"2026-08-26T04:23:58.426Z","originalFileLocation":"ko/workspace/knowledge.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"문서 업로드, RAG 파이프라인, 동적 필터, AI 메타데이터 추출을 통한 지식기반 구축 및 관리\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"지식기반 - Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:description\" content=\"문서 업로드, RAG 파이프라인, 동적 필터, AI 메타데이터 추출을 통한 지식기반 구축 및 관리\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cloosphere.ai/ko/workspace/knowledge\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=%EC%A7%80%EC%8B%9D+%26+%EB%8D%B0%EC%9D%B4%ED%84%B0\u0026amp;title=%EC%A7%80%EC%8B%9D%EA%B8%B0%EB%B0%98\u0026amp;description=%EB%AC%B8%EC%84%9C+%EC%97%85%EB%A1%9C%EB%93%9C%2C+RAG+%ED%8C%8C%EC%9D%B4%ED%94%84%EB%9D%BC%EC%9D%B8%2C+%EB%8F%99%EC%A0%81+%ED%95%84%ED%84%B0%2C+AI+%EB%A9%94%ED%83%80%EB%8D%B0%EC%9D%B4%ED%84%B0+%EC%B6%94%EC%B6%9C%EC%9D%84+%ED%86%B5%ED%95%9C+%EC%A7%80%EC%8B%9D%EA%B8%B0%EB%B0%98+%EA%B5%AC%EC%B6%95+%EB%B0%8F+%EA%B4%80%EB%A6%AC\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=aa37e86578aa8b3a263028fbf9565ec22126764cafa2a4bf0de28cc15fe289eb\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"지식기반 - Cloosphere Guide\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"문서 업로드, RAG 파이프라인, 동적 필터, AI 메타데이터 추출을 통한 지식기반 구축 및 관리\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=%EC%A7%80%EC%8B%9D+%26+%EB%8D%B0%EC%9D%B4%ED%84%B0\u0026amp;title=%EC%A7%80%EC%8B%9D%EA%B8%B0%EB%B0%98\u0026amp;description=%EB%AC%B8%EC%84%9C+%EC%97%85%EB%A1%9C%EB%93%9C%2C+RAG+%ED%8C%8C%EC%9D%B4%ED%94%84%EB%9D%BC%EC%9D%B8%2C+%EB%8F%99%EC%A0%81+%ED%95%84%ED%84%B0%2C+AI+%EB%A9%94%ED%83%80%EB%8D%B0%EC%9D%B4%ED%84%B0+%EC%B6%94%EC%B6%9C%EC%9D%84+%ED%86%B5%ED%95%9C+%EC%A7%80%EC%8B%9D%EA%B8%B0%EB%B0%98+%EA%B5%AC%EC%B6%95+%EB%B0%8F+%EA%B4%80%EB%A6%AC\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=aa37e86578aa8b3a263028fbf9565ec22126764cafa2a4bf0de28cc15fe289eb\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5f22d0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cloosphere.ai/ko/workspace/knowledge\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ko/workspace/knowledge.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.cloosphere.ai/ko/workspace/knowledge\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.cloosphere.ai/en/workspace/knowledge\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.cloosphere.ai/ko/workspace/knowledge\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cloosphere.ai/#organization\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cloosphere.ai#website\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cloosphere.ai/ko/workspace/knowledge#webpage\",\"url\":\"https://docs.cloosphere.ai/ko/workspace/knowledge\",\"name\":\"지식기반\",\"description\":\"문서 업로드, RAG 파이프라인, 동적 필터, AI 메타데이터 추출을 통한 지식기반 구축 및 관리\",\"dateModified\":\"2026-08-26T04:23:58.426Z\",\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cloosphere.ai/ko/workspace/knowledge#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cloosphere.ai/ko/workspace/knowledge#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cloosphere Guide\",\"item\":\"https://docs.cloosphere.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"지식기반\",\"item\":\"https://docs.cloosphere.ai/ko/workspace/knowledge\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cloosphere.ai/ko/workspace/knowledge#article\",\"headline\":\"지식기반\",\"name\":\"지식기반\",\"description\":\"문서 업로드, RAG 파이프라인, 동적 필터, AI 메타데이터 추출을 통한 지식기반 구축 및 관리\",\"url\":\"https://docs.cloosphere.ai/ko/workspace/knowledge\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cloosphere.ai/ko/workspace/knowledge#webpage\"},\"dateModified\":\"2026-08-26T04:23:58.426Z\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cloosphere Guide\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cloosphere Guide\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/ko/workspace/knowledge.md","siteName":"Cloosphere Guide","nav":{"global":null,"languages":[{"language":"ko","default":true,"tabs":[{"tab":"시작하기","icon":"rocket","pages":[{"title":"시작하기","href":"/ko"}]},{"tab":"채팅","icon":"comments","pages":[{"title":"채팅","href":"/ko/chat/overview"}]},{"tab":"워크스페이스","icon":"briefcase","groups":[{"group":"워크스페이스","pages":[{"title":"워크스페이스 개요","href":"/ko/workspace/overview"}]},{"group":"AI 에이전트","pages":[{"title":"에이전트","href":"/ko/workspace/agents"},{"title":"에이전트 플로우","href":"/ko/workspace/flows"},{"title":"플로우 노드 레퍼런스","description":"에이전트 플로우 캔버스에서 사용 가능한 13종 노드의 설정·동작·State 키 참조 가이드","href":"/ko/workspace/flows-nodes"}]},{"group":"지식 \u0026 데이터","pages":[{"title":"지식기반","href":"/ko/workspace/knowledge"},{"title":"동적 필터 상세 가이드","description":"지식기반 동적 필터의 내부 동작 원리, 수동 vs AI 비교, 에이전트 자동 필터링 흐름까지 상세 안내","href":"/ko/workspace/knowledge-filters"},{"title":"지식 그래프","href":"/ko/workspace/knowledge-graph"},{"title":"데이터베이스","href":"/ko/workspace/database"},{"title":"용어집","href":"/ko/workspace/glossary"}]},{"group":"안전","pages":[{"title":"가드레일","href":"/ko/workspace/guardrails"}]},{"group":"커스터마이징","pages":[{"title":"프롬프트","href":"/ko/workspace/prompts"},{"title":"스킬","href":"/ko/workspace/skills"},{"title":"도구","href":"/ko/workspace/tools"},{"title":"마켓플레이스","href":"/ko/workspace/marketplace"},{"title":"태그","href":"/ko/workspace/tags"}]}]},{"tab":"협업","icon":"users","pages":[{"title":"협업","href":"/ko/collaboration/overview"}]},{"tab":"자동화","icon":"clock","pages":[{"title":"자동화","href":"/ko/automation/overview"}]},{"tab":"관리자","icon":"gear","pages":[{"title":"관리자","href":"/ko/admin/overview"}]},{"tab":"모니터링","icon":"chart-line","pages":[{"title":"모니터링","href":"/ko/monitoring/overview"}]},{"tab":"운영 · 지원","icon":"screwdriver-wrench","pages":[{"title":"운영 · 지원","href":"/ko/admin/deployment-checklist"}]}]},{"language":"en","pages":[{"title":"en","href":"/en/workspace/knowledge"}]}]},"basePath":"","title":"지식기반 - Cloosphere Guide","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["07c022d89b","a74be98ba7","a9bb46feb3"],"chunks":["Frame-D0FT0qQs.js","DynamicMarkdown-CQM9Bhbv.js","zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}