Knowledge Base 연동 가이드#
Knowledge Base란?#
Knowledge Base는 회사의 지식을 한곳에 지식 자산으로 저장하고, AI가 지속적으로 활용할 수 있도록 관리하는 솔루션입니다.회사에서 사용하는 파일 시스템을 Knowledge Base에 연결하면 문서를 설정된 주기에 따라 자동으로 가져와 학습할 수 있습니다. 대량의 문서를 동시에 처리하고, 각 문서를 AI가 이해하고 검색할 수 있는 형태로 변환하여 관리합니다.Knowledge Base는 다음과 같은 역할을 담당합니다.회사 파일 시스템과 연동하여 문서를 주기적으로 수집하고 최신 상태로 유지합니다.
문서를 AI가 이해할 수 있도록 파싱하고 인덱싱합니다.
문서의 내용과 속성을 기준으로 레이블을 구성하고 관리합니다.
문서 내 민감정보를 탐지하고 데이터 거버넌스를 관리합니다.
각 문서가 어떤 에이전트에서 어떻게 활용되고 있는지 관리합니다.
에이전트의 활동 과정에서 생성된 기록과 노하우를 다시 팀의 지식 자산으로 축적합니다.
일부 데이터 거버넌스 및 에이전트 활동 기록 관리 기능은 순차적으로 제공될 예정입니다.
이 가이드에서 다루는 내용#
이 가이드에서는 STORM 플랫폼의 에이전트가 회사의 팀 지식을 활용할 수 있도록, 회사 파일 시스템을 Knowledge Base에 연결하는 방법을 안내합니다.현재 Knowledge Base는 Microsoft SharePoint 연동을 지원합니다.Google Drive와 Amazon S3 연동은 추후 지원될 예정입니다.
이 문서에서는 SharePoint와 Knowledge Base를 연동하기 위해 다음 작업을 진행합니다.1.
Microsoft Entra ID에 연동용 애플리케이션 등록
2.
SharePoint 문서를 조회하기 위한 권한 설정
3.
클라이언트 ID, 테넌트 ID 및 클라이언트 시크릿 키 확인
4.
연동할 SharePoint 사이트 URL 확인
5.
확인한 정보를 Knowledge Base에 입력
1. 연동 전 확인 사항#
SharePoint 연동을 진행하려면 다음 권한과 정보가 필요합니다.(1) 필요한 관리자 권한#
Microsoft Entra ID에 애플리케이션을 등록하고 API 권한에 대한 관리자 동의를 진행할 수 있는 담당자가 필요합니다.조직의 보안 정책에 따라 애플리케이션 등록 담당자와 SharePoint 관리자의 협조가 필요할 수 있습니다.(2) 연동에 필요한 정보#
연동 과정에서 다음 정보를 생성하거나 확인합니다.| 항목 | 설명 |
|---|
| 클라이언트 ID | Microsoft Entra ID에 등록한 애플리케이션의 식별자 |
| 테넌트 ID | 회사의 Microsoft Entra 테넌트 식별자 |
| 클라이언트 시크릿 | 등록한 애플리케이션이 인증할 때 사용하는 비밀 값 |
| SharePoint 사이트 URL | Knowledge Base에 연결할 SharePoint 사이트의 주소 |
클라이언트 시크릿은 생성 직후 표시되는 값을 안전한 장소에 복사해 보관해야 합니다.
이후에는 동일한 값을 다시 확인할 수 없으므로, 분실한 경우 새로운 시크릿을 생성해야 합니다.
SharePoint 연동하기#
1. Microsoft Entra ID에 애플리케이션 등록하기#
2.
Microsoft Entra ID로 이동합니다.
5.
애플리케이션 이름과 지원되는 계정 유형을 입력한 후 애플리케이션을 등록합니다.
애플리케이션 이름은 관리자가 용도를 쉽게 식별할 수 있도록 STORM Knowledge Base와 같이 작성하는 것을 권장합니다.
2. SharePoint 접근 권한 설정하기#
등록한 애플리케이션이 SharePoint 문서를 조회할 수 있도록 API 권한을 설정합니다.1.
등록한 애플리케이션의 API 권한 메뉴로 이동합니다.
2. 권한 추가를 선택합니다.
3. Microsoft Graph의 애플리케이션 권한을 선택합니다.4.
SharePoint의 애플리케이션 권한을 선택합니다.
5.
조직 관리자가 추가한 권한에 대해 관리자 동의를 진행합니다.
3. 클라이언트 시크릿 생성하기#
1.
등록한 애플리케이션의 인증서 및 암호 메뉴로 이동합니다.
2. 새 클라이언트 암호를 선택합니다.
3. 암호의 설명과 만료 기간을 설정합니다.
4. 생성된 클라이언트 암호의 값을 복사하여 안전하게 보관합니다.여기에서 복사한 값은 Knowledge Base 연동 화면의 클라이언트 시크릿 항목에 입력합니다.클라이언트 시크릿의 만료일이 지나면 SharePoint 동기화가 중단될 수 있습니다. 만료 전에 새로운 시크릿을 생성하고 Knowledge Base의 연동 정보를 갱신해야 합니다.
4. 클라이언트 ID와 테넌트 ID 확인하기#
등록한 애플리케이션의 개요 화면으로 이동하여 다음 값을 확인합니다.확인한 값은 Knowledge Base 연동 화면의 클라이언트 ID와 테넌트 ID 항목에 각각 입 력합니다.5. SharePoint 사이트 URL 확인하기#
Knowledge Base에 연결할 SharePoint 사이트에 접속한 후, 브라우저 주소창의 URL을 그대로 복사합니다.6. Knowledge Base에 연동 정보 입력하기#
STORM Knowledge Base의 SharePoint 연동 화면에서 앞서 확인한 정보를 입력합니다.7. 연동 상태 확인하기#
연동이 완료되면 Knowledge Base에서 SharePoint의 폴더와 문서를 확인할 수 있습니다.최초 연동 시 문서의 수와 용량에 따라 수집과 학습에 시간이 걸릴 수 있습니다. 문서는 수집된 후 파싱과 인덱싱 과정을 거쳐 에이전트가 검색할 수 있는 상태로 전환됩니다.이후 SharePoint에서 발생한 문서의 추가·수정·이동·삭제 사항은 설정된 동기화 주기에 따라 Knowledge Base에 반영됩니다.연동에 실패한 경우 다음 항목을 확인해 주세요.테넌트 ID와 클라이언트 ID가 올바른지 확인해주세요
클라이언트 시크릿의 값과 만료 상태가 올바른지 확인해주세요
SharePoint 사이트 URL이 지정된 형식에 맞는지 확인해주세요
애플리케이션에 필요한 API 권한과 관리자 동의가 적용되었는지 확인해주세요
