지식 베이스
지식 베이스는 흩어져 있는 업무 자료를 지속적으로 유지 관리할 수 있고 Agent 대화에서 사용할 수 있는 지식 자산으로 정리합니다.
대상 사용자: 데이터 분석가, 운영 담당자, 데이터 플랫폼 담당자, 지식 콘텐츠 관리자, 기술 지원 담당자. 진입점은 기능 센터 → 지식 베이스입니다.
1. 지식 베이스로 해결할 수 있는 문제
지식 베이스는 기업 내부 지식과 업무 자료를 통합 관리하고, 원본 파일이나 온라인 문서를 검색하고 읽기 쉬운 지식 목차와 Wiki 페이지로 정리하는 데 사용합니다. 제품 규칙, 업무 방법, 프로젝트 자료, 작업 규범, 지원 문서를 축적하는 데 적합합니다.
지식 베이스를 사용하면 다음 세 가지 이점이 있습니다.
- 통합 축적: 파일, Feishu 문서, 웹 자료를 하나의 지식 공간에 모읍니다.
- 구조화된 활용: 소스 자료를 지식 목차와 Wiki 페이지로 컴파일하여 찾는 수고를 줄입니다.
- 업무 대화 지원: 시스템이 Agent 대화에서 적합한 지식 베이스를 자동으로 찾아 사용하므로, 답변에 기존 업무 자료가 반영됩니다.
1.1 지식 베이스를 사용해야 하는 경우
Agent가 제품 규칙, 업무 기준, 프로젝트 배경 또는 지원 자료를 조회하도록 하려면 지식 베이스를 사용합니다. 특정 워크스페이스의 장기적인 약속과 배경을 관리하려면 공간 메모리를 사용하고, 안정적인 작업 방법을 재사용 가능한 절차로 정리하려면 Skill을 사용합니다. 세 가지를 함께 사용할 수 있습니다.
지식 베이스는 임시 첨부 파일이 아닙니다. 기본 절차는 지식 베이스 생성 → 소스 자료 추가 → 컴파일 규칙 준비 → 컴파일 및 게시 → 대화에서 사용하며 지속적으로 유지 관리입니다. 소스가 변경되면 다시 컴파일해야 업데이트된 내용이 새로 게시되는 지식에 반영됩니다.
1.2 지식 베이스 유형 선택
| 타입 | 적용 시나리오 | 작업 및 권한 |
|---|---|---|
| 시스템 지식 베이스 | 플랫폼에 사전 설정된 지식 콘텐츠 사용 | 소스나 컴파일을 직접 수정할 수 없음. 일부 콘텐츠는 Agent 대화에서만 사용할 수 있으며 상세 페이지를 열 수 없음 |
| 회사 지식 베이스 | 팀이 함께 업무 지식을 사용하고 유지 관리 | 회사 리소스 관리자가 생성하며, 멤버 역할에 따라 접근과 유지 관리를 제어함. 기본적으로 회사 전체에 공개되지 않음 |
| 개인 지식 베이스 | 개인이 자주 쓰는 자료를 축적하고, 먼저 검증한 후 필요에 따라 회사에 게시 | 개인이 관리하며, 업무 범위를 연결하고 대화에 사용할 수 있음 |
일반 지식 베이스와 읽기 전용 스냅샷: 일반 개인·회사 지식 베이스는 권한에 따라 소스와 컴파일을 유지 관리할 수 있습니다. 가져온 컴파일 완료 스냅샷은 바로 읽고 대화에 사용하기 위한 것으로, 지식 본문 편집, 소스 파일이나 규칙 유지 관리를 지원하지 않으며 다시 컴파일할 수도 없습니다. 두 방식을 혼동하지 마십시오.
2. 지식 베이스 생성 및 자료 추가
2.1 지식 베이스 생성
- 기능 센터 → 지식 베이스로 이동하여 개인 지식 베이스 또는 회사 지식 베이스를 선택합니다. 회사 지식 베이스를 생성하려면 회사 리소스 관리 권한이 필요합니다.
- 지식 베이스 이름을 입력하고, 필요에 따라 연결 범위, 태그, 설명을 추가합니다.
- 저장하면 상세 페이지로 이동하며, 소스 파일에서 자료를 추가합니다.
입력 규칙: 이름은 필수이며 30자 이하입니다. 태그는 최대 2개까지 추가할 수 있으며 각 태그는 15자 이하입니다. 설명은 200자 이하입니다. 프로젝트, 커뮤니티 공간, 데이터 개발 스페이스 등의 연결 범위는 선택 항목으로, 업무 시나리오를 식별하고 자료를 추천하는 데 도움을 주며 접근 권한을 부여하지는 않습니다.
2.2 원본 자료 추가
소스 파일에서 자료 형식에 따라 파일 업로드 또는 URL 추가를 선택합니다.
- 파일 업로드: Markdown, TXT, CSV, PDF, Word, Excel, PPT 및 일반적인 이미지 형식을 지원합니다. 파일 하나는 50MB 이하이며, 한 번에 여러 파일을 선택할 수 있습니다.
- ZIP 디렉터리 업로드: 여러 자료를 디렉터리 구조대로 ZIP으로 묶어 업로드하고 디렉터리 소스로 관리할 수 있습니다. ZIP 하나는 50MB 이하입니다. 이것도 원본 자료이므로 컴파일해야 사용할 수 있는 지식이 됩니다.
- URL 추가: Feishu 또는 Lark 클라우드 문서, 지식 베이스 링크 및 기타 접근 가능한 웹 페이지를 지원합니다. 표시 이름을 입력할 수 있으며, 기타 URL은 파싱 설명을 추가할 수도 있습니다.
URL을 추가하기 전에 연결 테스트를 실행할 수 있습니다. Feishu 소스를 사용하려면 환경에서 Lark-CLI 연동이 완료되어 있고 해당 문서에 대한 접근 권한이 있어야 합니다. 도구를 설치했다고 해서 접근 권한을 얻는 것은 아닙니다. Feishu 지식 베이스 링크는 소스 기능에 따라 하위 문서나 하위 페이지를 파싱하며, 이때도 해당 접근 권한이 필요합니다.
업로드가 끝나면 먼저 소스 목록과 상태를 확인합니다. 같은 이름으로 업로드해도 기존 소스를 바로 덮어쓸 수 없습니다. 기존 소스가 아직 컴파일되지 않았더라도 해당 소스 행에서 교체 작업을 사용하고, 영향을 확인한 후 확정해야 합니다.
2.3 컴파일 완료 스냅샷 가져오기
이미 컴파일된 지식 패키지가 있으면 지식 베이스 목록에서 스냅샷 가져오기를 선택할 수 있습니다. 회사 리소스 관리 권한이 있는 사용자는 회사 스냅샷 가져오기도 선택할 수 있습니다. 이름 등의 정보를 입력하고 50MB 이하의 ZIP을 업로드한 후 제출하고 가져오기가 완료될 때까지 기다립니다.
스냅샷 패키지에는 지식 목차 파일 index.md와 wiki/ 아래의 Markdown 페이지가 하나 이상 포함되어야 합니다. 일반 원본 자료 압축 파일을 컴파일 완료 스냅샷으로 가져오지 마십시오. 가져오기에 성공하면 읽기 전용 지식 베이스가 생성되며, 다시 컴파일하지 않고도 바로 읽고 대화에서 사용할 수 있습니다. 가져오기가 아직 완료되지 않았거나 결과가 명확하지 않으면 먼저 작업 상태를 확인하고, 중복 제출하지 마십시오.
3. 규칙 생성 또는 가져오기 및 컴파일
컴파일 규칙은 시스템이 현재 지식 베이스의 자료를 어떻게 구성할지 정합니다. 일반 지식 베이스는 먼저 유효한 규칙을 준비한 다음 소스를 지식 목차와 Wiki 페이지로 컴파일해야 합니다. 읽기 전용 스냅샷에는 아래 작업이 적용되지 않습니다.
3.1 컴파일 규칙 준비
시스템 생성: 소스 파일에서 자동 컴파일을 클릭합니다. 아직 규칙이 없으면 먼저 모델을 선택하고 생성을 시작합니다. 작업은 백그라운드로 전환할 수 있으며, 완료되면 컴파일 규칙에서 내용을 확인하고 구성 방식이 업무 요구에 맞는지 확인합니다.
기존 규칙 가져오기: 컴파일 규칙에서 규칙 가져오기를 선택하고 256KB 이하의 Markdown(.md) 파일을 업로드합니다. 업로드하면 처리 대기 원고만 저장되고 프로그램 검증이 실행되며, AI를 호출하지 않고 정식 규칙을 즉시 교체하지도 않습니다.
- 검증 결과를 확인하고 필요에 따라 본문을 편집합니다. AI 검증 또는 AI 수정을 선택할 수도 있으며, 이 두 항목은 모델을 호출하여 Token을 소모합니다.
- 프로그램 검증을 통과하고 진행 중인 작업이 없으면 미리보기 및 적용으로 이동하여 전문, 정식 규칙과의 차이, 제안 항목을 확인합니다. AI 검증은 적용의 필수 전제 조건이 아닙니다.
- 확인한 후 규칙 교체 확인을 선택합니다. 창을 닫아도 저장된 원고와 백그라운드 작업은 유지되지만, 규칙을 적용해도 자동으로 컴파일되지는 않으므로 기존 Wiki는 다시 컴파일해야 새 규칙이 적용됩니다.
3.2 컴파일 방식 선택
| 방식 | 적용 상황 | 처리 방식 |
|---|---|---|
| 증분 컴파일 | 소수의 소스를 추가, 교체 또는 삭제한 경우 | 컴파일 대기, 실패 또는 변경된 내용을 처리하고, 기존 지식 결과를 바탕으로 관련 페이지를 추가, 업데이트 또는 정리함 |
| 전체 컴파일 | 자료 구조가 크게 바뀌었거나 지식 베이스 전체를 다시 정리하려는 경우 | 사용 가능한 모든 소스를 다시 처리하고 새 Wiki 결과를 게시함 |
시작한 후 상태와 진행률을 확인할 수 있으며, 작업을 백그라운드로 전환할 수도 있습니다. 컴파일을 중복 실행하지 마십시오. 컴파일, 규칙 생성 또는 게시 확인 중에는 일부 자료 수정 작업을 일시적으로 사용할 수 없습니다.
3.3 결과 및 사용량 확인
컴파일한 후 지식 목차에서 전체 구조를 확인하고, Wiki 페이지에서 구체적인 내용을 탐색하고 검색합니다. 해당 권한이 있으면 소스 파일에서 소스 상태를, 컴파일 규칙에서 구성 규칙을, 컴파일 사용량에서 규칙 생성과 컴파일의 Token 사용량을 확인할 수 있습니다.
작업이 끝났다고 해서 모든 자료가 완료된 것은 아닙니다: 일부 게시됨으로 표시되거나 일부 소스가 완료되지 않은 경우 오류 상세, 게시된 페이지, 이전 버전을 재사용한 페이지, 이번에 완료되지 않은 내용을 확인한 후 해당 소스를 처리합니다. 업데이트에 실패해도 마지막으로 게시에 성공한 내용은 계속 사용할 수 있으며, 업데이트 대기 내용은 유지됩니다. 컴파일을 취소하면 완료되지 않은 결과는 새 지식으로 게시되지 않습니다.
4. Agent, 공간, 대화에서 사용
Agent에서 설정: 특정 Agent가 고정된 업무 자료를 우선 사용하도록 하려면 해당 Agent의 기능 설정에서 사용 권한이 있는 지식 베이스를 선택할 수 있습니다. 구체적인 설정 위치는 Agent를 참고하십시오.
워크스페이스에서 설정: 공간의 대화에서 공통 자료를 사용하도록 하려면 권한이 있는 멤버가 공간 기능 설정에서 지식 베이스를 설정할 수 있습니다. 공유 공간의 공용 지식 베이스는 시스템 및 회사 유형으로 제한됩니다. 설정이 지식 베이스 권한 부여를 대신하지는 않으므로, 멤버가 사용할 때는 각자의 권한 검증을 통과해야 합니다. 공간 기능 설정은 새 공간 생성하기를 참고하십시오.
대화에서 질문: 질문을 바로 설명하되, 업무 주제, 지식 베이스 이름 또는 자료 범위를 가능한 한 명시합니다. 시스템이 질문에 따라 사용 권한이 있는 관련 지식 베이스를 자동으로 찾으므로 매번 미리 선택할 필요가 없습니다. 대화에서 지식 베이스를 수동으로 선택할 수도 있으며, 현재 대화 하나당 최대 10개까지 수동으로 선택할 수 있습니다. 선택 및 질문 방법은 대화를 참고하십시오.
수동 선택은 우선 검색을 의미하며 배타적인 범위가 아닙니다: 선택한 자료가 질문과 관련 있으면 우선 사용되지만, 권한이 있고 현재 질문과 관련된 다른 정보가 제외되지는 않습니다. 지정한 자료만을 근거로 답변받으려면 질문에서 이를 명확히 요구하고, 누락된 정보를 밝히도록 요청해야 합니다.
신뢰할 수 있는 사용 원칙: 답변에 지식 베이스 내용을 사용할 때 핵심 결론은 실제로 읽은 페이지 본문이 직접 뒷받침해야 합니다. 목차, 제목, 태그, 펼치지 않은 페이지의 요약은 탐색에만 사용하며, 자료에 설명이 없는 부분은 정보 공백임을 명확히 밝혀야 합니다. 일부 보호된 지식은 규정에 따라 대화에서만 사용할 수 있으며, 전문을 보거나 내보낼 수 있다는 뜻은 아닙니다.
5. 협업 권한 및 회사에 게시
5.1 역할별 권한 부여
회사 지식 베이스는 공유로 멤버를 추가하고 역할을 부여합니다. 컴파일할 수 있는 일반 지식 베이스의 주요 권한은 다음과 같습니다.
| 역할 | 주요 권한 |
|---|---|
| 소유자(Owner) | 설정, 지식 콘텐츠, 소스, 규칙, 컴파일, 멤버를 관리하며, 지식 베이스를 삭제하거나 소유권을 이전할 수도 있음 |
| 관리자(Admin) | 설정, 지식 콘텐츠, 소스, 규칙, 컴파일, 멤버를 관리함. 이 역할만으로는 지식 베이스를 삭제하거나 소유권을 이전할 수 없음 |
| 협업자 | 지식 콘텐츠와 소스를 보고 유지 관리함. 멤버나 규칙을 관리하거나 컴파일을 실행할 수 없음 |
| 뷰어 | 지식 목차와 Wiki 페이지를 탐색하고 대화에서 사용함. 소스 파일이나 규칙을 보거나 내용을 수정할 수 없음 |
| Agent Only | Agent 대화에서만 지식 베이스를 사용하며, 상세 페이지를 열거나 콘텐츠를 관리할 수 없음 |
회사 리소스 관리자는 별도의 권한 계층입니다: 회사 리소스 관리 권한이 있는 관리자는 회사의 회사 지식 베이스를 관리할 수 있으며, 삭제와 이전도 포함됩니다. 이는 위 표의 지식 베이스 내 Admin 제한을 받지 않습니다. 공간의 Owner나 관리자 신분은 회사 리소스 관리 권한과 같지 않으며, 지식 베이스 관리 권한을 자동으로 얻지도 않습니다.
읽기 전용 스냅샷의 콘텐츠, 소스, 규칙, 컴파일 작업은 여전히 편집할 수 없습니다. 해당 권한이 있으면 이름 등의 설정을 유지 관리할 수 있으며, 회사 스냅샷은 멤버 관리와 소유권 이전도 가능합니다. 개인 지식 베이스에는 현재 회사 지식 베이스와 같은 공유 및 소유권 이전 진입점이 제공되지 않습니다.
회사 지식 베이스를 인계해야 하면 이전 권한이 있는 사람이 새 소유자를 선택하고 확인합니다. 평소에는 최소 권한 원칙에 따라 역할을 부여하고, 더 이상 접근할 필요가 없는 멤버는 즉시 제거합니다. 특정 탭이나 버튼이 보이지 않으면 먼저 역할, 지식 베이스 유형, 작업 상태를 확인합니다.
5.2 개인 지식 베이스를 회사에 게시
일반 개인 지식 베이스는 컴파일을 완료한 후 회사에 제출하여 팀이 권한에 따라 사용하도록 할 수 있습니다. 가져온 읽기 전용 스냅샷은 이 게시 절차를 지원하지 않습니다.
- 개인 지식 베이스 카드에서 회사에 제출을 선택합니다.
- 회사 지식 베이스 이름과 신청 사유를 입력합니다. 이름은 30자 이하, 사유는 80자 이하입니다.
- 제출한 후 승인을 기다립니다. 승인된 후에도 회사 사본 게시를 완료해야 합니다. 게시 중, 게시됨, 게시 실패 등의 상태를 확인하고, 승인을 곧바로 게시 완료로 간주하지 마십시오.
- 게시에 성공하면 회사 지식 베이스를 열어 내용과 접근 권한을 확인한 후 팀 협업에 사용합니다.
게시는 승인 시점에 복사된 최신 내용을 기준으로 하며, 독립된 회사 지식 베이스가 생성됩니다. 개인 지식 베이스가 회사 지식 베이스로 바로 바뀌는 것이 아니며, 이후 개인 지식 베이스를 수정해도 회사 사본에 자동으로 동기화되지 않습니다. 원래 개인 지식 베이스의 소유자가 회사 사본의 소유자가 자동으로 되는 것도 아니며, 회사 사본은 계속 회사 리소스 관리 및 멤버 권한 규칙에 따라 관리됩니다.
6. 자료 업데이트, 버전 복원 및 자주 묻는 질문
6.1 소스 업데이트 및 영향 확인
- 소스 파일에서 업데이트할 소스 행을 찾아 파일 교체 또는 ZIP 교체를 선택합니다. 일반 파일은 원래 소스와 같은 형식으로 교체해야 하며, ZIP으로 일반 파일을 교체할 수 없습니다.
- 새 파일을 선택하고 영향 미리 보기를 클릭하여 추가, 수정, 삭제, 변경 없음 파일과 미게시 차이를 확인합니다.
- 문제가 없으면 현재 초안에 반영한 후 증분 컴파일 또는 전체 컴파일을 실행하고 게시 결과를 확인합니다.
ZIP 교체는 현재 파일 트리 전체를 교체합니다: 새 패키지에 포함되지 않은 파일은 삭제되며, 아직 게시되지 않은 수동 추가 파일도 포함됩니다. 소스를 수정하거나 복원하면 현재 초안에만 영향을 주며, 게시된 지식이 즉시 바뀌지는 않습니다. 소스 삭제도 컴파일하여 게시해야 새 지식 결과에 반영됩니다.
URL 소스에 편집 진입점이 표시되면 링크, 표시 이름 및 해당하는 파싱 설명을 수정할 수 있습니다. 컴파일되었거나 컴파일 중인 소스에는 이 진입점이 표시되지 않습니다. 온라인 자료와 접근 권한을 정기적으로 확인하고, 자료가 바뀌면 다시 컴파일합니다. "원본 웹 페이지가 이미 업데이트되었다"를 "지식 베이스에 새 내용이 게시되었다"로 여기지 마십시오. 작업 안내의 미리 보기가 만료되면 소스를 새로고침한 후 다시 미리 봅니다. 제출 결과가 명확하지 않으면 먼저 상태를 확인하고, 무작정 재시도하지 마십시오.
6.2 버전 확인 및 복원 방식 선택
일반 개인·회사 지식 베이스는 버전 기록에서 게시에 성공한 버전을 확인하고 소스 변경을 비교할 수 있습니다. 처음으로 컴파일에 성공하면 첫 번째 버전이 생성됩니다. 시스템 지식 베이스와 읽기 전용 스냅샷에는 이 버전 작업이 제공되지 않습니다. 과거 소스의 조회와 복원은 여전히 역할 권한의 제어를 받으며, 게시되지 않은 중간 초안은 완전한 기록 백업이 아닙니다.
특정 소스만 복원: 최신 게시 버전 복원을 사용하거나, 성공한 버전에서 복원 가능한 파일·디렉터리 소스를 선택할 수 있습니다. 먼저 영향을 확인한 후 현재 초안으로 복원을 확정합니다. 복원한 후 자동으로 컴파일되지 않습니다. 현재 소스가 여전히 존재하고 유형이 호환되어야 하며, URL 소스는 이러한 소스 단위 복원을 지원하지 않습니다.
지식 베이스 전체 롤백: 소스 유지 관리 및 컴파일 권한이 있으면 버전 기록에서 이 버전으로 복원을 선택하고 영향을 확인한 후 확정합니다. 롤백은 대상 버전의 전체 Wiki, 컴파일 규칙, 소스를 사용하여 새 버전으로 게시하며, 이후의 기록을 삭제하지 않습니다.
전체 롤백은 대상 버전에 포함된 소스의 현재 내용과 미게시 수정 사항을 덮어씁니다. 대상 버전에 없지만 컴파일에 성공한 적이 있는 소스는 삭제로 표시되며, 컴파일에 성공한 적이 없는 새로 추가된 소스는 유지됩니다. 실행하기 전에 이러한 영향을 확인하고 작업이 완료될 때까지 기다립니다. 관리자 확인이 필요하다는 안내가 표시되면 롤백을 반복하지 마십시오.
6.3 자주 묻는 질문
특정 지식 베이스를 찾을 수 없거나 사용할 수 없는 이유는 무엇입니까? 먼저 계정에 접근 권한이 있는지, 지식 베이스에 사용 가능한 게시 콘텐츠가 있는지 확인한 다음 Agent나 공간 설정을 점검합니다. 업무 범위 연결, 워크스페이스 참여, 지식 베이스 링크 수신은 모두 권한 부여와 같지 않습니다.
자료를 업로드하거나 수정했는데 답변이 여전히 이전 내용인 이유는 무엇입니까? 소스 초안이나 정식 규칙만 업데이트한 것은 아닌지, 컴파일이 성공적으로 게시되었는지 확인합니다. 업데이트 실패, 일부 게시됨 또는 이전 버전 페이지 재사용이 발생한 경우 작업이 끝났는지만 보지 말고 소스 원인과 게시 결과를 확인해야 합니다.
소스 파일, 규칙 또는 컴파일 버튼이 없는 이유는 무엇입니까? 멤버 역할과 시스템 지식 베이스 또는 읽기 전용 스냅샷인지 확인합니다. 권한이 있는데도 작업을 일시적으로 사용할 수 없으면 컴파일, 규칙 생성, 승인 및 게시 또는 확인 대기 상태인지 점검합니다.
컴파일에 실패하면 어떻게 합니까? 오류 상세를 확인하고, 먼저 소스를 읽을 수 있는지, 권한 부여가 유효한지, 규칙이 검증을 통과했는지 점검한 다음 실패한 소스를 처리하고 다시 컴파일합니다. 컴파일 사용량에서 모델 사용량을 확인하고, 결과가 확인 대기 중이면 관리자에게 연락하여 확인한 후 작업합니다.