Knowledge 관리

Knowledge Bundle을 통한 지식 소스 관리 및 RAG(Retrieval-Augmented Generation) 설정

주요 기능

• Knowledge Bundle 생성 및 관리
• 파일 업로드 가능
• SharePoint 파일 소스 추가
• 외부 소스 인증 관리
• 벡터 임베딩 기반 인덱싱
• RAG 서비스 연동

기본 정보

Knowledge Bundle

Knowledge Bundle은 Agent가 참조하는 지식 소스를 하나의 단위로 묶은 구성 요소입니다. 파일, 문서, 코드 저장소 등 다양한 데이터를 연결하고 이를 벡터 임베딩 기반으로 인덱싱하여 RAG 방식으로 활용할 수 있도록 지원합니다.

Knowledge Source

파일 또는 외부 데이터 소스(CSV, PDF, GitHub 등)를 의미합니다.

RAG 서비스

RAG(Retrieval-Augmented Generation) 서비스를 제공합니다.

Knowledge Bundle 관리

Bundle 목록 조회

조직 단위로 생성된 모든 Knowledge Bundle을 리스트로 확인할 수 있습니다.

표시 정보:

• Name: 번들 이름
• Description: 설명
• Sources: 연결된 Knowledge Source 개수
• Status: 전체 번들의 인덱싱 상태

검색 기능:

• 이름 기준으로 필터링 가능

Bundle 생성

1. ”+ Create Bundle” 버튼 클릭
2. 다음 정보 입력:
   • Name (필수): 번들 이름
   • Description: 번들 설명
   • Chunk Size: 문서를 검색 가능한 단위로 나눌 때 사용할 청크 크기
   • Overlap: 인접한 청크 사이에 겹쳐 포함할 범위
3. “Create” 버튼 클릭

Bundle 상세 관리

Bundle 상세 페이지에서는 다음 정보를 확인하고 관리할 수 있습니다:

Bundle 정보:

• Bundle 이름 및 설명
• Bundle 상태 (INDEXED, Failed 등)

Knowledge Sources 목록:

• 연결된 소스들의 상세 정보
• 각 소스의 인덱싱 상태

주요 액션:

• ”+ Add Source”: 새로운 소스 추가
• “More Actions”: 추가 관리 기능
• 개별 소스 관리 (편집, 삭제 등)

Knowledge Source 추가

지원하는 소스 유형

현재 File 업로드와 SharePoint 소스를 지원합니다.

파일 업로드

현재 지원하는 파일 업로드 기능:

지원 포맷:

• .pdf
• .txt, .md, .markdown
• .html
• .doc, .docx
• .csv, .xls, .xlsx

제한사항:

• 파일당 최대 용량: 50MB
• 파일 업로드 후 “Start” 버튼을 클릭하여 인덱싱 시작
• 소스 이름 입력 가능 (기본값: 파일명)
• 필요에 따라 Chunk Size와 Overlap을 조정하여 인덱싱 방식을 설정할 수 있습니다.

SharePoint 소스 추가

SharePoint에 저장된 파일을 Knowledge Source로 가져와 Knowledge Bundle에 추가할 수 있습니다.

추가 절차

1. Knowledge Bundle 상세 화면에서 + Add Source를 클릭합니다.
2. SharePoint 소스를 선택합니다.
3. 사용할 SharePoint 계정을 선택하거나 새 계정을 연결합니다.
4. SharePoint 사이트, 드라이브, 폴더를 탐색하여 가져올 파일을 선택합니다.
5. 가져오기를 클릭해 선택한 파일을 Knowledge Source로 추가합니다.
6. 가져온 소스의 인덱싱을 시작합니다.

지원 포맷

• .pdf
• .doc, .docx
• .txt, .md
• .html
• .csv, .xlsx
• .json

제한사항

• 파일당 최대 용량: 50MB
• OneNote 노트북은 Knowledge Source로 가져올 수 없습니다.
• 지원하지 않는 파일 형식은 선택할 수 없습니다.
• 이미 같은 번들에 추가된 파일은 중복으로 가져올 수 없습니다.

SharePoint 소스 업데이트

SharePoint 원본 파일의 변경 여부는 자동으로 확인됩니다. 기본적으로 약 1시간마다 원본 파일을 확인하며, 변경이 감지되면 Knowledge Source 목록에 소스 변경됨 상태와 업데이트 버튼이 표시됩니다.

1. 소스 변경됨 상태가 표시된 SharePoint 소스의 업데이트 버튼을 클릭합니다.
2. SharePoint의 최신 파일을 다시 가져와 기존 소스 파일을 교체합니다.
3. 업데이트가 완료되면 최신 콘텐츠를 검색에 반영하기 위해 해당 소스를 다시 인덱싱합니다.

저장된 SharePoint 인증이 만료되었거나 토큰 갱신에 실패하면 SharePoint 계정 재연결 안내가 표시됩니다. 이 경우 기존에 연결한 계정으로 다시 인증한 뒤 업데이트를 재시도하세요. 다른 SharePoint 계정으로 재인증하면 기존 파일과 계정이 일치하지 않아 작업이 실패할 수 있습니다.

외부 소스 인증 관리

Knowledge 관리 화면의 인증 관리에서 Knowledge Source에 사용할 외부 서비스 계정을 관리할 수 있습니다.

인증 관리에서 할 수 있는 작업

• 연결된 SharePoint 계정 목록 확인
• 계정 상태 확인: 연결됨, 재인증 필요, 만료됨, 해제됨
• 만료되었거나 재인증이 필요한 계정 재인증
• 더 이상 사용하지 않는 계정 연결 해제

연결된 Knowledge Source가 있는 계정은 소스를 삭제한 후 연결을 해제할 수 있습니다.

Chunk Size와 Overlap 설정

Knowledge Bundle 생성 또는 Source 추가 시 Chunk Size와 Overlap을 설정할 수 있습니다.

• Chunk Size: 문서를 검색 가능한 단위로 나누는 크기입니다. 값을 작게 설정하면 더 세밀하게 검색할 수 있고, 값을 크게 설정하면 더 긴 문맥을 한 번에 검색할 수 있습니다.
• Overlap: 인접한 청크 사이에 겹쳐 포함할 범위입니다. 값을 늘리면 문단 경계에서 문맥이 끊기는 문제를 줄일 수 있습니다.

긴 문맥을 유지해야 하는 문서에는 Overlap을 늘리는 것이 유용하고, 짧고 구조화된 문서에는 Chunk Size를 작게 설정하면 원하는 정보를 더 좁게 찾는 데 도움이 됩니다.

상태값 정의

Knowledge Bundle 상태

Knowledge Source 상태

삭제 및 재처리 정책

삭제 제한사항

• 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?”

재인덱싱

• 소스 단위로 재인덱싱 가능
• 소스 전체 재인덱싱 가능

주의사항

• Knowledge Bundle은 Agent의 지식 기반이 되므로 신중하게 관리해야 합니다
• 삭제 시 연결된 Agent에 영향을 줄 수 있으므로 사전에 확인이 필요합니다
• 인덱싱 중인 상태에서는 삭제가 불가능하므로 완료 후 진행하세요
• 파일 업로드 시 용량 제한(50MB)과 Chunk Size, Overlap 설정을 확인하세요