통합

제어판 → Integrations — 지식에 접근하기 위한 콘텐츠 소스와 채널을 연결하세요.

#콘텐츠 소스

#연결됨 (항상 활성)

#사용 가능한 커넥터

#GitHub 연결

#1단계 — 인증

1. LiKE에서 Integrations → GitHub → **"연결"**로 이동합니다
2. 인증 방법을 선택합니다:

#2단계 — 콘텐츠 선택

1. 연결 후, 폴더와 파일이 있는 저장소 트리가 표시됩니다
2. 가져올 특정 파일이나 폴더를 체크합니다 (Selective Sync)
3. 지원 형식: .md, .mdx, Wiki 페이지

#3단계 — 동기화 실행

1. **"Sync"**를 클릭합니다
2. 진행 상황이 실시간으로 표시됩니다
3. 완료되면 문서가 GitHub 라벨과 함께 목록에 나타납니다

#GitLab 연결

#1단계 — 인증

1. LiKE에서 Integrations → GitLab → **"연결"**로 이동합니다
2. 인증 방법을 선택합니다:

#2단계 — 콘텐츠 선택

1. Wiki 페이지 및 Markdown 파일이 있는 프로젝트 트리가 표시됩니다
2. 가져올 특정 페이지를 체크합니다 (Selective Sync)

#3단계 — 동기화 실행

GitHub와 동일 — **"Sync"**를 클릭하고 완료될 때까지 기다립니다.

#Gitea 연결

Gitea는 셀프 호스팅 git 플랫폼입니다. Personal Access Token과 인스턴스의 필수 URL을 통해 연결됩니다(기본적으로 클라우드 Gitea는 없습니다).

#1단계 — Gitea에서 토큰 생성

1. Gitea에서 Settings → Applications → Generate New Token을 엽니다
2. read:repository 및 read:user 스코프를 부여합니다
3. 토큰을 복사합니다

#2단계 — LiKE에서 연결

1. LiKE에서 Integrations → Gitea → **"연결"**로 이동합니다
2. 인스턴스의 Base URL을 지정합니다(예: https://gitea.company.com) — 이 필드는 필수이며, 없으면 연결이 진행되지 않습니다
3. 토큰을 붙여넣습니다
4. 스페이스/컬렉션과 모드(Sync — 지속적인 미러 / Import — 일회성 복사)를 선택합니다

Gitea 관리자가 미리 OAuth 애플리케이션을 설정한 경우 OAuth 2.0도 지원됩니다. 기본 경로는 토큰입니다.

#3단계 — 콘텐츠 선택 및 동기화

1. Wiki 페이지 및 Markdown 파일(.md, .mdx)이 있는 저장소 트리가 표시됩니다
2. 필요한 노드를 체크하고(Selective Sync) **"Sync"**를 클릭합니다
3. 푸시 시 자동 업데이트를 위해 webhook을 설정하세요 — 시크릿은 커넥터 카드에서 생성됩니다. Gitea의 문서는 읽기 전용입니다(GitHub/GitLab과 동일)

#파일 선택 및 동기화 필터 (GitHub, GitLab, Gitea)

git 소스(GitHub, GitLab, Gitea)의 경우, 무엇을 동기화할지 선택하는 로직은 단순한 "저장소 켜기/끄기"보다 더 세밀합니다:

#무엇이 동기화되나요

#경로 필터 (선택적 동기화)

저장소에서 정확히 무엇을 가져올지 좁힐 수 있습니다:

#변경 감지 (최근 변경)

LiKE는 매번 실행할 때마다 "모든 것을 다운로드"하지 않습니다. 변경 감지가 사용됩니다:

• GitHub — webhook(권장) 또는 If-Modified-Since 헤더를 사용한 폴링을 통해. webhook은 푸시에 즉시 반응하고, 폴링은 6/12/24/48시간마다(자동 동기화에 따라 다름) 수행됩니다.
• GitLab — 마찬가지: webhook 또는 Projects API를 통한 last_activity_at 폴링.
• Gitea — webhook(X-Gitea-Signature 서명) 또는 폴링. 푸시 트리거는 *.md/*.mdx가 변경될 때만 실행됩니다.

변경이 감지되면 영향을 받은 파일만 동기화되고, 나머지 코퍼스는 재계산되지 않습니다. 이로써 많은 GitHub/GitLab API 할당량과 실행 시간이 절약됩니다.

#브랜치 및 태그

#기록 및 충돌

• 동기화 기록 — 커넥터 카드의 "History" 탭: 날짜, 상태(✅ ok / ⚠ 경고 / ❌ 오류), 추가/업데이트/삭제된 문서 수, 실행 시간. "저장소의 문서가 왜 나타나지 않았는지" 디버깅하는 데 유용합니다.
• 편집 충돌 — 소스의 문서가 LiKE에서 편집된 경우(GitHub/GitLab의 경우 기본적으로 허용되지 않음 — 문서는 읽기 전용입니다). 모드가 Import(일회성 복사)이면 문서가 편집 가능해지고 소스와의 연결이 끊어집니다.

#다른 커넥터의 Selective Sync

Notion, Confluence, Wiki.js — 이들은 고유한 선택 로직(페이지 트리)이 있지만 원리는 동일합니다:

1. 연결 시 소스의 콘텐츠 트리가 표시됩니다
2. 체크박스 — 필요한 노드를 표시합니다
3. 나머지는 가져오지 않습니다
4. 재동기화 시 선택한 항목만 업데이트됩니다

#Wiki.js 연결

#1단계 — Wiki.js API 토큰 받기

1. Wiki.js를 엽니다 → Administration → API Access
2. API를 활성화합니다(비활성화된 경우)
3. New API Key를 클릭합니다
4. 키 이름을 지정합니다(예: LiKE Integration)
5. 그룹: Administrators(모든 페이지에 대한 접근이 필요함)
6. 만료: 만료 없음 또는 1년
7. 생성된 토큰을 복사합니다

#2단계 — LiKE에서 연결

1. LiKE에서 Integrations → Wiki.js → **"연결"**로 이동합니다
2. Wiki.js의 URL을 입력합니다(예: https://wiki.company.com)
3. API 토큰을 붙여넣습니다
4. 모드를 선택합니다:

5. Save를 클릭합니다

#3단계 — 동기화 구성

#Confluence 연결

Confluence는 OAuth 2.0을 통해 연결됩니다 — 비밀번호 입력 없는 안전한 인증입니다.

#1단계 — "Connect Confluence" 클릭

1. LiKE에서 제어판 → Integrations로 이동합니다
2. Confluence 카드를 찾아 **"연결"**을 클릭합니다
3. Atlassian 인증 창이 열립니다

#2단계 — Atlassian에서 인증

1. Atlassian 계정에 로그인합니다(아직 하지 않은 경우)
2. Atlassian이 요청을 표시합니다: "LiKE is requesting access to your Confluence"
3. 권한을 검토합니다 — LiKE는 읽기 전용을 요청합니다: 페이지 콘텐츠 및 스페이스 목록
4. **"Accept"**를 클릭합니다

#3단계 — LiKE로 돌아오기

확인 후 자동으로 Integrations로 리디렉션됩니다. Confluence 카드에는 다음이 표시됩니다:

• 상태: 연결됨
• Confluence 사이트 이름
• "Sync" 버튼

#4단계 — 동기화 실행

1. 첫 가져오기를 위해 **"Sync"**를 클릭합니다
2. LiKE가 접근 가능한 Confluence 스페이스의 모든 페이지를 로드합니다
3. 문서가 지식 카탈로그에 나타납니다

#5단계 — 자동 동기화 구성

설정(Confluence 카드의 톱니바퀴 아이콘)을 엽니다:

Confluence의 문서는 읽기 전용입니다. 편집하려면 Confluence에서 원본을 변경하면 다음 동기화 시 LiKE가 업데이트합니다.

Confluence 연결을 해제할 때 LiKE에서 문서 복사본을 유지(편집 가능해짐)하거나 삭제할 수 있습니다.

#Notion 연결

#1단계 — Notion에서 통합 생성

1. Notion을 엽니다 → 아바타(왼쪽 상단 모서리)를 클릭 → Settings
2. 왼쪽 메뉴에서 My connections(또는 Integrations)를 선택합니다
3. Develop or manage integrations → New integration을 클릭합니다
4. 이름을 입력하고(예: LiKE Import) 워크스페이스를 선택합니다
5. Submit을 클릭 → Internal Integration Secret을 복사합니다(ntn_로 시작; 이전 통합의 경우 — secret_로 시작)

#2단계 — 통합에 페이지 접근 권한 부여

기본적으로 통합은 어떤 페이지에도 접근할 수 없습니다. 명시적으로 허용해야 합니다:

1. Notion에서 가져오려는 각 페이지(또는 상위 페이지/데이터베이스)를 엽니다
2. ⋯(점 세 개, 오른쪽 상단 모서리) → Connect to → LiKE Import 통합을 선택합니다
3. 접근을 확인합니다

#3단계 — LiKE에서 연결

1. LiKE에서 → 제어판 → Integrations → Notion → "연결"
2. Integration Secret을 붙여넣습니다(1단계에서 복사함)
3. 가져오기를 위한 스페이스를 선택합니다(기존 또는 새로 생성)
4. 모드를 선택합니다:

5. **"연결"**을 클릭합니다
6. LiKE가 통합이 접근할 수 있는 모든 페이지를 로드합니다

#4단계 — 자동 동기화 구성

설정(Notion 카드의 톱니바퀴 아이콘)을 엽니다:

Notion 연결을 해제할 때 LiKE에서 문서 복사본을 유지(편집 가능해짐)하거나 삭제할 수 있습니다.

#문서 사이트 연결

이 커넥터는 공개 사이트에서 문서를 가져옵니다. 사이트맵을 읽고 LiKE 안에 사본을 유지합니다. 문서가 이미 게시되어 있는 경우에 적합합니다 — 자체 도메인, Docusaurus, GitBook, Docsify 등.

#1단계 — 사이트 주소

연동 → 문서 사이트 → 사이트 연결. 주소를 붙여넣으세요. 어느 페이지 주소라도 괜찮으며, 사이트 전체를 가져옵니다. 사이트맵은 저희가 찾습니다. 먼저 robots.txt, 그다음 /sitemap.xml을 확인합니다.

#2단계 — 확인 결과

사이트 확인을 누르세요. 확인 단계에서는 아무것도 저장하지 않습니다. 사이트맵만 읽어, 발견된 페이지 수와 필터 적용 후 추가될 페이지 수를 보여 줍니다. 사이트맵이 없으면 연결은 시작되지 않으며, 조용히 0건을 가져오는 대신 그 사실을 분명히 알려 드립니다.

#3단계 — 저장 위치

공간과 컬렉션을 선택하세요. 컬렉션은 마법사에서 바로 만들 수 있습니다. 연결을 누르면 수집이 즉시 시작되고, 진행 상황은 커넥터 카드(“사이트 수집 92개 중 22개”)와 백그라운드 작업 표시에서 확인할 수 있습니다.

#가져오는 것과 가져오지 않는 것

• 사이트의 메뉴·머리글·바닥글을 제외한 본문 내용을 가져옵니다.
• 사이트 섹션으로 경로를 제한할 수 있습니다(/docs/, /guides/). 비워 두면 사이트 전체를 가져옵니다.
• 검색, 태그 같은 보조 섹션은 기본적으로 건너뜁니다.
• 1회 최대 페이지 수는 한 번의 수집을 제한합니다. 매우 큰 사이트에 대한 보호 장치입니다.
• robots.txt에서 차단된 페이지는 가져오지 않으며, 그 수는 실행 요약에 표시됩니다.

#이후 업데이트

자동 동기화를 켜두면 일정에 따라 사이트를 다시 읽습니다. 변경된 페이지만 다시 색인됩니다. 실행 요약에도 “추가됨”, “업데이트됨”, “변경 없음”으로 표시됩니다. 변경되지 않은 페이지는 색인 한도를 소모하지 않습니다.

사라진 페이지 정리는 기본적으로 꺼져 있습니다. 사이트에서 페이지가 사라져도 문서는 그대로 남습니다. 사본이 사이트를 엄격히 따라야 한다면 켜세요.

#연결 가능한 사이트와 그렇지 않은 사이트

사이트맵이 있는 공개 사이트라면 연결됩니다. 대부분의 문서 생성기가 그렇게 동작합니다. 그 밖의 경우는 연결한 뒤가 아니라 확인 단계에서 미리 알려 드립니다.

사이트가 연결된 뒤에도 일부 페이지는 제외될 수 있습니다. robots.txt에서 차단된 페이지, 오류를 반환하는 페이지, 10 MB를 넘는 페이지, HTML이 아닌 응답이 그렇습니다. 모두 실행 요약에 사유와 함께 “건너뜀”, “robots.txt에 의해 차단됨”으로 표시됩니다.

파일(PDF, ZIP, 이미지)은 사이트에서 가져오지 않습니다. 이를 위한 별도의 경로가 있습니다 — 자체 처리 방식을 갖춘 파일 가져오기입니다.

#제한

• 조직당 사이트 1개;
• 사이트는 공개여야 합니다. 비밀번호로 보호된 페이지는 읽지 않습니다.
• 사이트맵이 필요합니다. 없으면 연결되지 않습니다.
• robots.txt를 준수하며, 거기에 지정된 요청 간 대기 시간도 지킵니다.

연결 해제. 동기화가 중단되며, 이미 가져온 문서는 삭제하거나 일반 문서로 남길 수 있습니다. 연결 해제 시 LiKE가 이를 묻습니다.

#파일 가져오기

#파일 업로드

1. 제어판 → Import
2. 파일을 끌어다 놓거나 업로드 영역을 클릭합니다
3. 지원 형식: PDF, DOCX, TXT, MD, RTF, ZIP
4. AI가 각 파일에 대한 제목과 슬러그를 자동으로 생성합니다
5. 게시하기 전에 제목을 편집하거나 편집기에서 열 수 있습니다

#ZIP 아카이브

여러 문서가 포함된 ZIP 아카이브를 업로드하세요 — LiKE가 각 파일을 자동으로 압축 해제하고 처리합니다. 전체 지식 베이스를 마이그레이션하는 데 편리합니다.

ZIP 내부에서 지원되는 파일: PDF, DOCX, TXT, MD, RTF. 다른 파일(이미지, 실행 파일)은 건너뜁니다.

#링크로 가져오기

문서 링크를 붙여넣으세요 — LiKE가 다운로드하여 가져옵니다:

1. 제어판 → Import → "링크로 가져오기" 섹션
2. URL을 붙여넣기 → "추가" 클릭
3. 한 번에 최대 10개의 링크를 추가할 수 있습니다
4. **"가져오기"**를 클릭합니다

지원 소스:

• Google Docs — DOCX로 자동 내보내기
• Google Sheets — CSV로 내보내기
• Dropbox — 직접 파일 링크
• PDF, DOCX, TXT, MD 또는 RTF 파일에 대한 모든 직접 URL

#기본 공개 범위

각 소스에 대해 기본 공개 범위를 구성할 수 있습니다:

• 초안 — 문서가 숨김 상태로 생성됩니다
• 팀 — 인증된 사용자에게 표시됩니다
• 공개 — 익명 사용자를 포함한 모든 사람에게 표시됩니다

Integrations → 소스 카드 → 공개 범위에서 구성합니다.

#접근 채널

채널을 통해 직원들이 익숙한 도구로 정보를 검색할 수 있습니다.

#Slack 봇

기능:

• /like how do I set up SSO? → Slack에서 바로 AI 답변
• 아무 채널에서 @LiKE 멘션 → 스레드에 답변
• 소스 문서 링크(클릭 가능)

#Telegram 봇

기능:

• 봇에게 직접 메시지 → AI 답변
• 그룹 채팅에서: /ask question → 답변
• 25개 이상 언어 지원

#JS 위젯 (귀사의 웹사이트용)

모든 웹사이트에 삽입할 수 있는 플로팅 AI 검색 버튼입니다. 가장 인기 있는 통합입니다 — 사용자가 페이지 모서리의 버튼을 보고 클릭하면 AI와의 채팅 및 지식 베이스 전체 검색이 열립니다.

#간단한 설치

#기본 매개변수

#Dual-auth: 두 가지 인증 모드 (ADR 0032)

LiKE에서 위젯은 두 가지 모드 중 하나로 작동할 수 있습니다 — 생성 시 선택합니다:

각 모드 구성 및 백엔드 통합에 대한 자세한 내용은 API 및 위젯을 참조하세요.

#Scope: 위젯이 찾을 수 있는 것

위젯을 생성할 때 scope를 설정합니다 — 정확히 무엇을 검색할지:

하나의 위젯 내에서 여러 scope 항목을 결합할 수 있습니다(예: 동일한 스페이스의 두 컬렉션).

#테넌트당 다중 위젯 (ADR 0029 Stage 4)

조직 내에서 서로 다른 scope와 모드를 가진 여러 독립 위젯을 생성할 수 있습니다:

각각 고유한 api-key와 사용 분석을 가지며, 키는 독립적으로 취소할 수 있습니다. 관리는 **Integrations → Widgets → "+ 생성"**에 있습니다.

#세션 관리 (Session JWT 모드)

Session JWT 모드에서는 각 사용자 세션마다 고유한 sessionId가 있습니다. 관리자는 특정 위젯의 활성 세션을 보고 토큰을 강제로 취소할 수 있습니다(예: 침해가 의심되는 경우). 목록은 Integrations → Widgets → [위젯] → Sessions에 있습니다.

#iframe / 직접 링크

전체 LiKE 검색 인터페이스를 모든 페이지에 삽입:

1. Integrations → iframe → 코드 복사
2. <iframe src="...">를 페이지에 붙여넣습니다
3. 또는 직접 링크를 사용하여 이동합니다(임베드가 아닌 전체 페이지)

iframe과 Direct Link도 dual-auth를 지원합니다 — 생성 시 선택합니다.

#REST API

프로그래밍 방식 통합을 위한 전체 API(예: 자체 UI 또는 다른 시스템과의 통합):

1. Integrations → API Keys → "키 생성"
2. 이름(키의 용도)과 scope(위젯과 동일 — public_umbrella / space / collection)를 지정합니다
3. 키를 복사합니다 — 한 번만 표시되며, 다시 열면 마스킹됩니다

X-API-Key 헤더 또는 Bearer 토큰으로 키를 사용하세요.

주요 엔드포인트:

제한: 속도 제한은 요금제에 따라 다르며 api-key에 연결됩니다. 초과 시 Retry-After 헤더와 함께 HTTP 429가 반환됩니다. 귀사 요금제의 정확한 값은 요금제 페이지와 관리 패널에 있습니다.

전체 API 문서: API 및 위젯.

#언어

LiKE는 AI 검색 및 교차 언어 검색을 위해 25개 이상 언어를 지원합니다(인터페이스 자체는 11개 UI 로케일로 제공됩니다):

Русский, English, Deutsch, Français, Español, Português, Italiano, Nederlands, Polski, Čeština, Svenska, Dansk, Suomi, Română, Magyar, Hrvatski, Türkçe, Afrikaans, Kiswahili, Bahasa Indonesia, Tiếng Việt, Українська, Српски, Български, Ελληνικά, 한국어, 日本語, 中文, हिन्दी, ไทย, עברית, العربية.

교차 언어 검색: 한 언어로 된 질문 → 다른 언어로 된 문서에서의 답변.