Knowledge 관리
Knowledge Bundle을 통한 지식 소스 관리 및 RAG(Retrieval-Augmented Generation) 설정
Knowledge Bundle 및 Source의 관리는 조직의 Owner, Admin 권한의 사용자만 가능합니다. 일반 사용자는 해당 Knowledge가 연동된 Agent를 사용할 수만 있고, Knowledge 자체에는 접근이 불가능합니다.
주요 기능
- Knowledge Bundle 생성 및 관리
- 다양한 데이터 소스 연결 (파일, Google Drive, GitHub 등)
- 벡터 임베딩 기반 인덱싱
- RAG 서비스 연동 (QueryPie RAG)
기본 정보
Knowledge Bundle
Knowledge Bundle은 Agent가 참조하는 지식 소스를 하나의 단위로 묶은 구성 요소입니다. 파일, 문서, 코드 저장소 등 다양한 데이터를 연결하고 이를 벡터 임베딩 기반으로 인덱싱하여 RAG 방식으로 활용할 수 있도록 지원합니다.
Knowledge Source
파일 또는 외부 데이터 소스(CSV, PDF, GitHub 등)를 의미합니다.
RAG 서비스
QueryPie는 자체 RAG(Retrieval-Augmented Generation) 서비스를 제공합니다. 모든 Knowledge Bundle은 기본적으로 QueryPie RAG를 사용하여 벡터 임베딩 및 검색 기능을 제공합니다.
Knowledge Bundle 관리
Bundle 목록 조회
조직 단위로 생성된 모든 Knowledge Bundle을 리스트로 확인할 수 있습니다.
표시 정보:
- Name: 번들 이름
- Description: 설명
- RAG Service: 연동된 벡터 임베딩 엔진 (QueryPie RAG)
- Sources: 연결된 Knowledge Source 개수
- Status: 전체 번들의 인덱싱 상태
검색 기능:
- 이름 기준으로 필터링 가능
Bundle 생성
- ”+ Create Bundle” 버튼 클릭
- 다음 정보 입력:
- Name (필수): 번들 이름
- Description: 번들 설명
- RAG Service Type (필수): QueryPie RAG (기본값)
- “Create” 버튼 클릭
Bundle 상세 관리
Bundle 상세 페이지에서는 다음 정보를 확인하고 관리할 수 있습니다:
Bundle 정보:
- Bundle 이름 및 설명
- Bundle 상태 (INDEXED, Failed 등)
- RAG Service Type
Knowledge Sources 목록:
- 연결된 소스들의 상세 정보
- 각 소스의 인덱싱 상태
- 청크 수 및 문자 수
주요 액션:
- ”+ Add Source”: 새로운 소스 추가
- “More Actions”: 추가 관리 기능
- 개별 소스 관리 (편집, 삭제 등)
Knowledge Source 추가
지원하는 소스 유형
현재는 File 업로드만 지원하며, Google Drive, AWS S3, Airtable, Google Sheets, Confluence, Notion, GitHub 등의 연동은 출시 예정입니다.
파일 업로드
현재 지원하는 파일 업로드 기능:
지원 포맷:
- .txt, .md, .markdown, .rst
- .csv, .json, .xml, .html
제한사항:
- 최대 용량: 10MB
- 파일 업로드 후 “Start” 버튼을 클릭하여 인덱싱 시작
- 소스 이름 입력 가능 (기본값: 파일명)
상태값 정의
Knowledge Bundle 상태
| 상태값 | 설명 |
|---|---|
| None | Bundle 내에 Source가 하나도 없는 경우 |
| Uploaded | Bundle 내에 Index 되지 않은 Source가 하나라도 있는 경우 |
| Indexing | Bundle 내에 Index 진행 중인 Source가 하나라도 있는 경우 |
| Indexed | Bundle 내에 Source가 모두 Index 완료된 경우 |
| Failed | Bundle 내에 Index 실패한 Source가 하나라도 있는 경우 |
| Canceled | Bundle 내에 Index가 취소된 Source가 하나라도 있는 경우 |
Knowledge Source 상태
| 상태값 | 설명 |
|---|---|
| Start | Index 되기 전 |
| Indexing | Index 진행 중 |
| Indexed | Index 완료 |
| Failed | Index 실패한 경우 |
| Canceled | Index가 취소된 경우 |
삭제 및 재처리 정책
삭제 제한사항
- Knowledge Bundle 및 Source의 상태가 Indexing으로 진행 중일 때는 삭제할 수 없습니다
- 이 경우 Delete 버튼이 비활성화됩니다
Knowledge Source 삭제
- 연결된 Bundle/Agent가 있더라도 삭제 가능
- 번들은 유지되며 검색 범위가 줄어듦
- Agent 실행 시 RAG 결과에서 해당 Source 관련 내용이 빠짐
- 해당 Source의 인덱스(RAG 벡터)도 함께 제거
삭제 확인 메시지:
“Deleting it will reduce the bundle’s coverage and may affect linked agents. Do you want to continue?”
Knowledge Bundle 삭제
- 연결된 Agent가 존재하는 경우 Bundle 삭제 불가능
- Bundle 내의 소스를 모두 제거한 뒤에 번들을 삭제할 수 있습니다
삭제 확인 메시지:
“Deleting this bundle may affect linked agents. Do you want to proceed?”
재인덱싱
- 소스 단위로 재인덱싱 가능
- 소스 전체 재인덱싱 가능
취소 정책
취소 제한사항
- 소스의 상태가 Indexing이 아닐 경우(예: 시작 전, Indexed, Failed) 인덱싱을 취소할 수 없습니다.
인덱싱 취소 처리
- Indexing 상태의 소스는 사용자가 직접 취소할 수 있습니다.
- 취소 요청이 성공하면 소스의 상태는 Canceled로 변경됩니다.
- 진행 중이던 인덱싱 프로세스는 중단됩니다.
주의사항
- Knowledge Bundle은 Agent의 지식 기반이 되므로 신중하게 관리해야 합니다
- 삭제 시 연결된 Agent에 영향을 줄 수 있으므로 사전에 확인이 필요합니다
- 인덱싱 중인 상태에서는 삭제가 불가능하므로 완료 후 진행하세요
- 파일 업로드 시 용량 제한(10MB)을 확인하세요