지식 관리¶

본 챕터는 에이전트가 참조할 수 있는 지식 자료를 컬렉션으로 만들고 운영하는 절차를 다룹니다.

컬렉션이란¶

컬렉션(Collection) 은 관련된 문서들을 묶은 지식 저장 단위입니다. 에이전트플로우의 검색 노드는 컬렉션 단위로 검색합니다.

용어	설명
컬렉션	문서 그룹
문서	컬렉션 안의 개별 자료 (PDF, 워드, 텍스트 등)
청크	임베딩 처리를 위해 문서를 잘게 자른 텍스트 조각
임베딩	청크를 검색용 벡터로 변환한 결과

자세한 용어는 용어 정의를 참고하세요.

컬렉션 목록¶

좌측 사이드바에서 지식관리 → 지식 컬렉션 메뉴를 선택합니다.

탭	표시 항목
보관함	본인이 만든 컬렉션
공유	다른 사용자가 공유한 컬렉션
전체	접근 가능한 모든 컬렉션

컬렉션 생성¶

우상단 + 새 컬렉션 생성 버튼 클릭
다음 항목 입력
- 이름: 식별 가능한 한글/영문 이름
- 설명 (선택): 무슨 자료인지 한 줄 요약
- 암호화 (선택): 비밀번호 보호 활성화 시 비밀번호 설정
- 만료일자 (선택): 자동 삭제 날짜. 영구 보관 시 비움
생성

버튼 라벨 안내

실제 솔루션 화면의 버튼 라벨은 "새 컬렉션 생성" 입니다.

문서 업로드¶

컬렉션 상세 화면 → 업로드 버튼
파일 선택 (PDF, DOCX, TXT, MD 등) — 다중 선택 가능
임베딩 옵션 설정 (기본값 사용 권장)

옵션	영문	의미	기본값
청크 크기	Chunk Size	한 청크의 최대 문자 수	1000
청크 오버랩	Chunk Overlap	청크 간 겹치는 부분	200
온톨로지	Ontology	개념·관계 자동 추출	사용
PII 스캔	PII Scan	개인정보 자동 탐지·마스킹	사용

업로드 시작 → 진행률 표시

업로드 후 처리 시간

문서가 큰 경우 임베딩 처리에 시간이 걸립니다. 진행률은 업로드 이력 탭에서 확인 가능. 처리 완료 전에도 다른 작업은 가능합니다.

업로드 이력¶

업로드한 문서의 처리 상태와 결과를 확인합니다.

상태	의미
대기	처리 큐에 들어감
처리 중	청크 분할·임베딩 진행 중
완료	검색 가능
실패	오류 발생 (로그 확인 필요)

온톨로지¶

업로드 시 온톨로지 옵션을 활성화한 컬렉션은 카드 상단 라벨 영역에 온톨로지 뱃지가 함께 표시됩니다. 카드를 클릭해 컬렉션 상세 화면으로 진입한 다음, 우상단의 온톨로지 버튼을 누르면 업로드된 문서들에서 자동 추출한 개념·관계를 그래프로 시각화해 확인할 수 있습니다.

시각화 화면 구성¶

영역	표시 항목
상단 통계	트리플 / 클래스 / 속성 / SCS 개수 — 추출된 지식 자산의 규모 요약
우상단 작업	재빌드 · 프로필 보기 · 전체화면
본문	클래스(파랑) / 인스턴스(초록) / 속성(주황) 노드를 간선으로 연결한 인터랙티브 그래프
좌하단 범례	노드 유형(클래스·인스턴스·속성) 과 간선 유형(`instanceOf`·`subClassOf`·`datatypeProperty`·`ObjectProperty`)
좌상단 검색	노드 검색 — 키워드로 그래프상의 노드를 좁혀보기

GraphRAG 쿼리¶

화면 하단의 GraphRAG 쿼리 영역에 질문을 입력하면 위 온톨로지를 기반으로 응답을 생성합니다. 우상단 컨텍스트 ON 토글이 켜져 있으면 그래프의 노드·관계 정보가 LLM 컨텍스트에 함께 포함되어 답변 품질을 높입니다.

운영 권장사항¶

재빌드 시점 — 업로드된 문서 일부가 갱신되면 그래프가 옛 상태일 수 있습니다. 큰 폭의 문서 추가·교체 후에는 재빌드 를 실행해 그래프를 최신 상태로 유지하세요.
복잡한 그래프 다루기 — 노드가 많아 한눈에 의미를 파악하기 어려우면 프로필 보기 와 좌상단 노드 검색 으로 좁혀 확인하는 것이 효과적입니다.
컨텍스트 ON 비용 — GraphRAG 컨텍스트는 답변 정확도를 높이지만 LLM 호출 비용이 증가할 수 있으니, 운영 환경에서는 응답 품질과 비용을 함께 관찰해 정책을 정하세요.

컬렉션 공유¶

다른 사용자에게 접근권 부여:

컬렉션 상세 → 공유 버튼
사용자 검색·선택
권한 선택 (읽기 / 읽기·쓰기)
저장

파일 저장소¶

컬렉션 자료 외에 파일 저장소(시스템 파일 자원) 에서 자료를 가져올 수 있습니다. 좌측 사이드바 지식관리 → 파일 저장소 화면 우상단의 + 새 저장소 생성 버튼을 누르면 저장소 생성 모달이 열리고, 저장소 이름·설명·암호화 여부를 입력해 새 저장소를 만듭니다.

항목	설명
저장소 이름	다른 사용자가 식별할 수 있는 한 줄 이름
설명	어떤 자료를 모아두는 저장소인지 한 문단 정도
암호화	저장소를 비밀번호로 보호할지 여부 토글

DB 연동¶

DB 연동(외부 데이터베이스의 테이블·뷰) 에서도 자료를 가져올 수 있습니다. 좌측 사이드바 지식관리 → DB 연동 화면 우상단의 + 새 연결 버튼을 누르면 데이터베이스 연결 등록 모달이 열립니다.

항목	설명
연결 이름	다른 사용자가 식별할 수 있는 한 줄 이름
설명	어떤 데이터베이스이고 어떤 용도인지 한 문단 정도
커스텀 비밀번호	이 연결에 대해 별도의 접근 비밀번호를 설정 (선택)
데이터베이스 유형	PostgreSQL, MySQL 등 — 드롭다운에서 선택

각 테이블·컬럼에 대한 문서화(설명·예시·정책) 는 별도 DB 문서화 화면에서 관리하며, 등록된 DB 연결이 있을 때만 진입 가능합니다.

운영 권장사항¶

컬렉션 분리 원칙 — 대상 사용자·분류 기준이 다르면 컬렉션을 분리. 한 컬렉션에 너무 많이 넣으면 검색 정확도가 떨어집니다.
정기 청소 — 오래된·중복된 문서는 삭제 또는 만료일 설정.
PII 정책 확인 — 개인정보 포함 문서는 PII 스캔이 활성화돼 있는지 반드시 확인.

문의¶

지식 관리 관련 문의는 Xgen 솔루션 관리자에게 문의해 주세요.