용어집·데이터베이스·문서를 하나의 그래프로 연결하여 AI 에이전트의 이해력을 높이는 통합 지식 구조
개요
지식 그래프(Knowledge Graph)는 용어집·데이터베이스·지식기반을 하나의 그래프로 연결한 통합 지식 구조입니다.AI 에이전트가 비즈니스 용어가 어떤 테이블 컬럼에 대응되는지, 어떤 문서 맥락과 관련 있는지를 자동으로 이해할 수 있게 해줍니다.
지식 그래프가 해결하는 문제
용어집·데이터베이스·지식기반을 각각 따로 쓰면 에이전트가 의미를 연결하지 못합니다.
구성만 사용했을 때
한계
용어집만
”VIP 고객”이 뭔지는 알지만 어느 테이블에 있는지 모름
데이터베이스만
테이블 구조는 알지만 “VIP”가 tier='VIP' 필터임을 모름
지식기반만
문서 내용은 찾지만 실제 데이터로 연결 못 함
지식 그래프 사용
용어 → 컬럼/필터 → 관련 문서까지 한 번에 연결
활용 예시
사용자: 강남지점 VIP 고객이 가장 많이 산 제품 TOP 3는?에이전트 동작: 1. resolve_term("VIP 고객") → users.tier = 'VIP' 매핑 발견 2. resolve_term("강남지점") → stores.region = '강남' 매핑 발견 3. find_related_tables("users") → orders, products 테이블 연결 발견 4. SQL 자동 생성 후 실행응답: 강남지점 VIP 고객 매출 TOP 3입니다: 1. 무선 이어폰 Pro — 1,523건 2. 스마트워치 X — 1,287건 3. 노이즈캔슬링 헤드폰 — 892건
세 가지 정보원
정보원
담는 내용
지식 그래프에서의 역할
용어집
비즈니스 용어 정의 (VIP, MRR, 강남지점 등)
Term / Concept 노드 + 동의어·카테고리 엣지
데이터베이스
테이블/컬럼 스키마 + FK 관계
Table / Column 노드 + 구조 엣지
지식기반
규정, 전략, 매뉴얼 등 문서
Doc Entity 노드 + LLM 추출 관계 엣지
지식 그래프 생성
1
새 지식 그래프 만들기
워크스페이스 → 지식 그래프 목록에서 ”+ 새 지식 그래프” 클릭
지식 그래프 목록
2
이름과 설명 입력
필드
설명
예시
이름
지식 그래프 식별 이름 (최대 200자)
“전사 지식 그래프”
설명
용도와 목표 설명
”매출/고객/상품 통합 분석용”
권한 영역에서 그룹별로 읽기·쓰기 권한을 설정할 수 있습니다. 조직 단위는 이 화면에서 지정할 수 없습니다 — 관리자가 그룹에 조직 단위를 연결하는 방식입니다.
3
상세 페이지 진입
생성 완료 후 자동으로 지식 그래프 상세 페이지로 이동합니다. 이제 정보원을 연결할 차례입니다.
지식 그래프 상세 페이지
지식 그래프 상세 페이지
지식 그래프 상세 페이지는 왼쪽 노드 목록과 오른쪽 설정/탐색 영역으로 구성됩니다.
통계 카드
상단에 3개의 통계 카드가 표시됩니다.
항목
의미
노드
그래프 내 총 노드 수
엣지
그래프 내 총 엣지 수
마지막 동기화
마지막 동기화 시점
LLM 모델 설정
카드 영역 우측 하단의 “LLM 모델” 드롭다운 메뉴를 통해 지식 그래프 생성에 사용할 LLM 모델을 선택합니다. 카테고리 정의 생성, 지식기반 문서 매칭, AI 도구 설명 자동 생성 등에 사용됩니다.
지식 연결 (Knowledge Link)
지식 연결은 지식 그래프의 핵심 구조입니다. 용어집 1개 + 지식기반 N개를 하나의 링크로 묶어, 용어와 문서 간 의미를 자동으로 연결합니다.
연결 구조
용어집에 카테고리의 추출 출처(extraction sources)가 설정되어 있으면, 해당 DB 스키마가 지식 연결에 자동으로 포함됩니다. 별도로 DB를 추가할 필요가 없습니다.
연결 추가
1
지식 연결 추가 클릭
지식 그래프 상세 페이지의 지식 연결 섹션에서 ”+ 지식 연결 추가” 버튼을 클릭
2
용어집 선택
연결할 용어집을 선택합니다. 이미 연결된 용어집은 목록에서 제외됩니다.
3
데이터베이스 / 지식기반 선택
체크박스로 이 지식 연결에 실제로 동기화할 소스를 선택합니다. 자동 감지된 후보 중 일부만 선택하거나 추가로 연결할 수 있습니다.
소스
효과
데이터베이스
선택한 DB의 테이블·컬럼·외래키가 그래프 노드로 추출됩니다
지식기반
선택한 지식기반의 문서 청크에서 LLM이 엔티티·관계를 추출합니다
체크하지 않은 소스는 자동 감지되어도 이번 지식 연결에 포함되지 않습니다. 이전 버전과 달리 자동 강제 연결되지 않으므로, 필요한 소스만 명시적으로 선택해 동기화 비용·시간을 제어할 수 있습니다.
4
추출할 지식기반 필터 슬롯 선택 (선택)
지식기반을 선택했다면, 그 지식기반의 동적 필터(부서/연도/문서 유형 등)를 지식 그래프 노드로 승격할지 선택할 수 있습니다. 자세한 동작은 아래 지식기반 필터를 지식 그래프 노드로 승격 섹션을 참조하세요.
5
생성 후 동기화
생성 후 “엔티티 동기화” 버튼으로 해당 링크를 동기화합니다. 선택한 데이터베이스·지식기반만 처리되며, 동기화 대상 목록도 자동으로 갱신됩니다.
연결이 만드는 노드와 엣지
용어집 → 노드
데이터베이스 → 노드
지식기반 → 노드
원본
생성되는 노드
연결 엣지
각 용어 (entry)
Term 노드
—
동의어
—
synonym_of 엣지
카테고리
Concept 노드
broader_than 엣지
카테고리 → DB 컬럼 매핑
—
maps_to 엣지
LLM 호출 없이 구조 변환만 수행하므로 빠르게 완료됩니다.
원본
생성되는 노드
연결 엣지
테이블
Table 노드
—
컬럼
Column 노드
belongs_to (컬럼 → 테이블)
외래 키
—
foreign_key 엣지
DB 스키마 노드를 생성하려면 DbSphere에서 스키마 추출을 먼저 실행해야 합니다. 미실행 시 노드가 0개로 표시됩니다.
원본
생성되는 노드
연결 엣지
문서 청크 내 엔티티
Doc Entity 노드
LLM이 추출한 관계 엣지
지식기반 필터 값 (선택한 슬롯만)
Doc Attribute 노드
필터 이름 엣지 (문서 → 속성 노드)
Doc Entity는 LLM이 각 문서 청크를 분석해 엔티티/관계를 추출한 결과입니다. Doc Attribute는 지식기반 필터 값을 그대로 그래프에 올리는 LLM 미사용 경로로, 후술하는 지식기반 필터를 지식 그래프 노드로 승격 섹션을 참조하세요.
Doc Entity 추출은 LLM 호출 비용이 발생합니다. 필요한 지식기반만 선택적으로 연결하세요. Doc Attribute는 LLM을 호출하지 않으므로 비용이 들지 않습니다.
지식기반 필터를 지식 그래프 노드로 승격
지식기반에 정의된 필터 값(국가, 카테고리, 부서 등)을 그대로 그래프 노드로 올려 검색·탐색·에이전트 라우팅에 활용할 수 있습니다. LLM을 호출하지 않으므로 비용 없이 구조화된 메타데이터를 그래프에 통합합니다.
예시: 지식기반에 “부서” 필터가 있고 이를 지식 그래프 노드로 승격하면, 에이전트가 “재무팀 문서 중에서 찾아줘” 같은 자연어 질의를 자동으로 부서 필터로 변환합니다.
1
지식 그래프 링크 카드의 노드 설정 열기
화면 우측의 지식 연결에서 연결된 지식기반 카드의 “노드 설정” 버튼을 클릭하여 모달을 엽니다.
2
승격할 필터 선택
연결된 지식기반의 필터 값이 표시됩니다. 노드로 승격할 필터를 체크박스로 선택합니다.
필터 종류
노드 승격 가능
비고
텍스트·범주형 (부서, 국가, 문서유형 등)
✓
값 종류가 적당해 노드로 적합
숫자·날짜형
✓
값 종류가 매우 많아 노드 수가 급증할 수 있어 신중히 선택
용어집 연동형
—
용어집 용어로 자동 연결되어 별도 승격 불필요 (기존 Term 노드 재사용)
3
저장 → 다음 동기화 시 반영
저장하면 선택한 슬롯이 지식 그래프 링크에 저장됩니다. 다음 동기화 실행 시 선택된 슬롯의 값들이 Doc Attribute 노드로 만들어지고, 각 문서가 보유한 값과 엣지로 연결됩니다.
동작 원리
단계
처리
1. 슬롯 등록
선택한 필터를 지식 그래프 링크에 기록합니다. 원본 지식기반 필터 설정은 변경하지 않으므로, 지식 그래프를 안 쓰는 환경에서도 지식기반은 그대로 동작합니다
2. 값 수집
선택한 필터가 문서에서 실제 갖는 값들을 중복 없이 모읍니다
3. 용어집 매치
모은 값이 연결된 용어집 용어와 일치하면 기존 Term 노드를 재사용해 그래프 중복·파편화를 방지합니다
4. 노드 생성
용어집에 없는 값만 새 Doc Attribute 노드로 생성합니다
5. 엣지 연결
각 문서를 자신이 가진 값 노드와 연결합니다 (예: “재무팀” 값을 가진 문서 → 재무팀 노드)
연결 엣지 이름에는 필터 이름이 그대로 쓰입니다(예: 부서, 국가). 라우팅 단계에서 더 자연스러운 이름이 제안되면 그 이름이 우선 적용됩니다.
Doc Attribute는 지식기반 필터를 LLM 호출 없이 그래프로 가져오는 가벼운 경로입니다. 청크 단위 엔티티 추출(Doc Entity)이 비용 부담스러우면 우선 Doc Attribute만으로 시작하고, 필요한 지식기반에만 LLM 추출을 켜는 단계적 도입을 권장합니다.
연결 상세 보기
각 지식 연결 카드를 펼치면 DB 테이블별 컬럼 매핑 현황을 확인할 수 있습니다.
테이블 그룹: 연결된 DB의 테이블별로 그룹핑
컬럼 매핑: 컬럼명, 데이터 타입, PK/FK 표시, 매핑된 카테고리, 용어 개수
매칭된 문서 수: 지식기반과 매칭된 문서 개수 표시
동기화
리소스를 연결한 후 동기화를 실행해야 노드와 엣지가 만들어집니다.
동기화 방식
방식
버튼
범위
전체 동기화
상단 “전체 동기화”
모든 소스 일괄 재구축
링크 단위 동기화
각 링크의 “엔티티 동기화”
해당 링크의 용어집 + DB + 지식기반만
전체 동기화 흐름
진행 상황 확인
동기화가 시작되면 버튼이 “동기화중” 으로 변경됩니다
완료/실패 시 실시간 알림(toast)이 표시됩니다
이미 실행 중인 동기화가 있으면 중복 실행이 차단됩니다
재동기화할 때는 새로 추가되거나 바뀐 문서만 다시 처리합니다. 이미 처리한 문서는 건너뛰어, 두 번째 동기화부터는 훨씬 빨라집니다.
동기화 소요 시간
소스
소요 시간
비용
용어집
수 초
없음
DB 스키마
수 초 ~ 수 분
없음
지식기반 엔티티 추출
수 분 ~ 수 시간 (문서량에 비례)
LLM 호출 비용 발생
그래프 탐색
그래프 시각화
지식 그래프 상세 페이지 왼쪽 패널 맨 위의 “그래프 표시” 버튼을 누르면 인터랙티브 그래프 뷰가
새 탭에서 전체 화면으로 열립니다. 상세 페이지 안에서 펼쳐지는 토글이 아니므로, 그래프를 보면서
설정을 만지려면 두 탭을 나란히 두고 작업하세요.
그래프 시각화
조작 방법
동작
방법
확대/축소
마우스 휠 또는 트랙패드
이동
배경 드래그
노드 선택
노드 클릭 → 이웃 하이라이트 + 상세 패널 표시
엣지 선택
엣지 클릭 → 연결 정보 패널 표시
전체 보기
툴바의 맞춤 버튼
타입별 포커스
상단 타입 버튼(Term, Concept, Table 등) 클릭 → 해당 타입과 직접 연결된 항목만 표시
노드 타입과 색상
타입
색상
의미
Glossary
남보라 #735CD9
연결된 용어집(소스)
Term
파랑 #4A71D8
용어집의 비즈니스 용어
Concept
보라 #8761CE
용어 상위 카테고리
Database
하늘색 #3589B0
연결된 데이터베이스(소스)
Table
초록 #228F5E
DB 테이블
Column
주황 #C26754
DB 컬럼
Knowledge Base
회청록 #5F8C8B
연결된 지식기반(소스)
Document
갈색 #B4754E
지식기반 문서
Doc Entity
분홍 #C64886
문서에서 LLM이 추출한 엔티티
Doc Attribute
청회색 #4E8CA6
지식기반 필터 값에서 승격된 속성 노드
노드가 500개를 초과하면 “Truncated” 경고가 표시됩니다. 타입별 포커스를 사용해 관심 있는 영역만 확인하세요.
노드 상세 패널
노드를 클릭하면 오른쪽에 상세 패널이 나타납니다.
속성 테이블: 노드의 상세 속성 (라벨, 타입, 설명 등)
연결 목록: 이 노드와 연결된 이웃 노드 목록 (방향 화살표 + 엣지 타입 + 이웃 정보)
이웃 노드를 클릭하면 해당 노드로 이동합니다
노드 목록
왼쪽 패널에서 모든 노드를 리스트로 탐색할 수 있습니다.
검색: 노드 라벨로 검색 (서버 사이드, 대규모 그래프에서도 빠름)
타입 필터: 전체 유형 / Column / Concept / Database / Doc Attribute / Document / Glossary / Knowledge Base / Table / Term
페이징: 20개 단위로 페이지 이동
시맨틱 검색
지식 그래프 상세 페이지의 시맨틱 검색 섹션에서 자연어로 노드를 검색할 수 있습니다.
벡터 유사도 기반으로 가장 관련 높은 노드를 점수와 함께 반환합니다
각 결과에 노드 타입 뱃지와 유사도 점수가 표시됩니다
시맨틱 검색을 사용하려면 시스템 관리자가 검색 엔진(Search Engine)을 설정해야 합니다. 미설정 시 경고 배너가 표시됩니다.
에이전트 연동
지식 그래프의 진짜 힘은 에이전트에 연결했을 때 나옵니다.
지식 그래프를 에이전트에 연결
에이전트 편집 페이지의 지식 그래프 섹션에서 사용할 지식 그래프를 선택합니다.
에이전트에 지식 그래프 연결
지식 그래프를 연결하면 해당 지식 그래프에 포함된 용어집·데이터베이스·지식기반이 에이전트에 자동 상속됩니다. 동일 리소스를 에이전트에 중복 추가할 필요가 없습니다.
지식 그래프 도구 7종
지식 그래프를 연결한 에이전트는 아래 7개 도구를 자동으로 사용할 수 있습니다.
도구
용도
사용 예시
resolve_term
비즈니스 용어 → DB 컬럼/필터 매핑
”VIP 고객” → tier='VIP'
explore_context
시드 엔티티 주변 서브그래프 탐색
복잡한 다단계 질문의 맥락 파악
search_concepts
의미 기반 노드 검색 + 이웃 확장
”매출 관련 용어 찾기”
find_related_tables
FK로 연결된 테이블 + JOIN 힌트
”users 테이블과 조인 가능한 테이블”
neighbors
특정 노드의 N-hop 이웃 탐색
특정 테이블과 연결된 모든 용어
fetch_data
SQL 실행 + 실제 데이터 반환 (최대 100행)
SELECT * FROM orders LIMIT 10
fetch_document
지식 그래프 연결 지식기반에서 문서 청크 검색
”VIP 정책 관련 문서 찾기”
fetch_data는 0행이 반환되면 자동으로 관련 문서 검색(fallback)을 수행합니다. 데이터와 문서를 하나의 도구로 통합 조회할 수 있습니다.
도구 테스터
에이전트에 연결하기 전에 “KG 도구 테스트” 섹션에서 각 도구를 직접 실행해볼 수 있습니다.
1
도구 테스터 열기
오른쪽 패널 아래의 “KG 도구 테스트” 섹션에서 “보기” 클릭 (다시 누르면 “숨기기”)
2
도구 선택 및 실행
드롭다운에서 도구를 선택하고, 입력값을 넣은 후 “실행” 클릭
3
결과 확인
JSON 형태의 결과가 하단에 표시됩니다. 동기화 결과가 올바른지, 용어 매핑이 정확한지 확인하세요.
노드 관리
노드 타입 요약
타입
출처
설명
Glossary
용어집
연결된 용어집(소스) 노드
Term
용어집
비즈니스 용어 (예: VIP, MRR)
Concept
용어집
용어 상위 카테고리 (예: 고객등급, 매출유형)
Database
데이터베이스
연결된 데이터베이스(소스) 노드
Table
데이터베이스
데이터베이스 테이블
Column
데이터베이스
테이블의 컬럼
Knowledge Base
지식기반
연결된 지식기반(소스) 노드
Document
지식기반
지식기반 문서
Doc Entity
지식기반
문서에서 LLM이 추출한 엔티티
Doc Attribute
지식기반
지식기반 필터 값에서 승격된 속성 노드
자주 묻는 질문
지식 그래프와 용어집의 차이는?
용어집은 용어 정의만 관리합니다. 지식 그래프는 용어집을 데이터베이스 컬럼·문서 엔티티와 연결해 에이전트가 실제 데이터로 답할 수 있게 합니다.
지식 그래프와 DbSphere(데이터베이스)의 차이는?
DbSphere는 스키마 기반 SQL 생성에 특화됩니다. 지식 그래프는 여기에 비즈니스 용어와 문서 맥락을 더해 “VIP 고객”처럼 스키마에 없는 표현도 이해합니다.
동기화에 시간이 너무 오래 걸려요
용어집/DB 동기화: 수 초 ~ 수 분 (빠름)
지식기반 엔티티 추출: 문서 수에 비례하여 수 분 ~ 수 시간
지식기반은 새로 추가되거나 바뀐 문서만 다시 처리하고, 이미 처리한 문서는 건너뜁니다. 그래서 큰 지식기반도 처음 한 번만 오래 걸리고, 이후 동기화는 빠릅니다.
동기화가 실패했어요
DB 관련 오류: DbSphere에서 먼저 스키마 추출이 성공했는지 확인하세요
지식기반 추출 오류: LLM 모델 설정과 API 키가 올바른지 확인하세요
이미 실행 중인 동기화가 있으면 중복 실행이 차단됩니다 — 잠시 후 재시도하세요
LLM 비용이 걱정돼요
지식기반 엔티티 추출만 LLM을 호출합니다. 비용을 제어하려면:
필요한 지식기반만 선택적으로 연결
용어집과 DB만으로도 resolve_term과 find_related_tables는 정상 동작합니다
여러 지식 그래프를 에이전트에 연결할 수 있나요?
네. 여러 지식 그래프를 연결하면 모든 지식 그래프의 노드와 엣지를 통합하여 도구가 동작합니다. 도메인별로 지식 그래프를 분리 운영하면서 에이전트에서는 통합 조회할 수 있습니다.
관련 가이드
용어집
비즈니스 용어 정의 · 동의어 · 카테고리 관리
데이터베이스
DB 연결 · 스키마 추출 · SQL 실행
에이전트
AI 에이전트 설정 · 도구 연결 · 워크플로우
이 페이지가 도움이 되었나요?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cloosphere Guide","colors":{"primary":"#5f22d0","light":"#7c3aed","dark":"#4c1d95"},"logo":{"light":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","dark":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","href":"/ko/index"},"favicon":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/favicon.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=0e41ff0755aa623d52e26f279f285f71","appearance":{"default":"system","strict":false},"interaction":{"drilldown":true},"styling":{"latex":false},"navigation":{"languages":[{"language":"ko","default":true,"href":"ko"},{"language":"en","href":"en"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cloocus","hasAudioNarration":false,"actualSubdomain":"cloocus","customDomains":["docs.cloosphere.ai"],"gitSource":{"type":"github","owner":"ais-cloocus","repo":"cloosphere-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6a954066df6b735599399868","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"en","tag":"Admin","count":30},{"language":"ko","tag":"관리자","count":30},{"language":"en","tag":"Settings","count":24},{"language":"ko","tag":"설정","count":24},{"language":"en","tag":"Monitoring","count":21},{"language":"ko","tag":"모니터링","count":21},{"language":"en","tag":"Workspace","count":16},{"language":"ko","tag":"워크스페이스","count":16},{"language":"en","tag":"Chat","count":11},{"language":"ko","tag":"채팅","count":11},{"language":"en","tag":"Getting Started","count":10},{"language":"ko","tag":"시작하기","count":10},{"language":"en","tag":"Collaboration","count":8},{"language":"ko","tag":"협업","count":8},{"language":"en","tag":"Data \u0026 Operations","count":6},{"language":"ko","tag":"운영 · 지원","count":6},{"language":"ko","tag":"데이터 및 운영 보안","count":6},{"language":"en","tag":"AI Features \u0026 Safety","count":5},{"language":"en","tag":"UI \u0026 Channels","count":5},{"language":"ko","tag":"AI 기능 및 안전","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--brand-primary: #5f22d0;--brand-light: #7c3aed;--brand-dark: #4c1d95;--brand-subtle: #ede9fe;--brand-glow: rgba(95, 34, 208, 0.15);--page-text: #0f172a;--page-muted: #6b7280}body{font-family:\"DM Sans\", sans-serif;color:var(--page-text);font-size:17px}.prose h1,.prose h2,.prose h3,.prose h4{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;letter-spacing:-0.015em}.prose h1{font-size:44px}.prose h2{font-size:28px;margin-top:36px;margin-bottom:10px}.prose h3{font-size:22px;margin-top:28px;margin-bottom:8px}.prose p,.prose li{color:var(--page-text);line-height:1.75;font-size:1rem}.prose hr{border:0;height:1px;background:linear-gradient(90deg, rgba(148, 163, 184, 0.4), rgba(148, 163, 184, 0.05));margin:28px 0}.dark body{color:#e2e8f0}.dark .prose p,.dark .prose li{color:#e2e8f0}.dark .prose hr{background:linear-gradient(90deg, rgba(148, 163, 184, 0.3), rgba(148, 163, 184, 0.05))}[class*=\"Card\"] svg,.card svg,a[href] svg{color:var(--brand-primary)!important}.card [data-component-part=\"card-icon\"]{margin-bottom:8px}.card [data-component-part=\"card-title\"]{margin-top:12px!important}[class*=\"Card\"],.card{border-radius:16px!important;border-color:rgba(148, 163, 184, 0.25)!important;transition:border-color 0.2s ease, box-shadow 0.2s ease, transform 0.2s ease}[class*=\"Card\"]:hover,.card:hover{transform:translateY(-2px);border-color:var(--brand-light)!important;box-shadow:0 4px 20px var(--brand-glow)!important}a:not([class*=\"Card\"]):hover{color:var(--brand-primary)!important}.stable-scrollbar-gutter.overflow-auto{width:220px!important;min-width:220px!important}.stable-scrollbar-gutter.overflow-auto+div,.stable-scrollbar-gutter.overflow-auto~main{flex:1!important}.flex.flex-row-reverse.gap-12{gap:32px!important}.xl\\:flex.self-start.sticky{max-width:15rem!important}.xl\\:flex.box-border.max-h-full.pl-10{width:14rem!important;padding-left:24px!important}.text-sm.leading-6.w-\\[16\\.5rem\\]{width:100%!important;font-size:13px!important;line-height:1.6!important}#table-of-contents-content a{padding:5px 0!important;display:block}#table-of-contents-content,#table-of-contents-content ul{list-style:none!important;padding-left:0!important;margin-left:0!important}#table-of-contents-content li::marker{content:\"\"!important}#table-of-contents-content>li{border-left:2px solid rgba(148, 163, 184, 0.1);padding-left:12px;transition:border-color 0.15s ease}.dark #table-of-contents-content>li{border-left-color:rgba(148, 163, 184, 0.08)}#table-of-contents-content a{color:var(--page-muted)!important;font-weight:400!important;transition:color 0.15s ease}.dark #table-of-contents-content a{color:#94a3b8!important}#table-of-contents-content>li>a{color:var(--page-text)!important;font-weight:500!important}.dark #table-of-contents-content>li>a{color:#e2e8f0!important}#table-of-contents-content>li>ul{padding-left:12px!important}#table-of-contents-content a:hover{color:var(--brand-dark)!important}.dark #table-of-contents-content a:hover{color:#e2e8f0!important}#table-of-contents-content a.text-primary,#table-of-contents-content a.font-semibold,#table-of-contents-content>li.is-active-item>a{color:var(--brand-primary)!important;font-weight:600!important}.dark #table-of-contents-content a.text-primary,.dark #table-of-contents-content a.font-semibold,.dark #table-of-contents-content a[class*=\"dark:text-primary\"],.dark #table-of-contents-content>li.is-active-item>a{color:var(--brand-light)!important;font-weight:600!important}#table-of-contents-content>li.is-active-item{border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li.is-active-item{border-left-color:var(--brand-light)!important}#table-of-contents-content>li:has(>a.border-primary),#table-of-contents-content>li:has(>a.text-primary){border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li:has(>a.border-primary),.dark #table-of-contents-content>li:has(>a.text-primary),.dark #table-of-contents-content>li:has(>a[class*=\"dark:text-primary\"]),.dark #table-of-contents-content>li:has(>a[class*=\"dark:border-primary\"]){border-left-color:var(--brand-light)!important}.landing-hero{text-align:center;padding:72px 32px 24px;max-width:860px;margin:0 auto}.landing-hero h1{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:52px;font-weight:700;letter-spacing:-0.03em;margin:0 0 20px;background:linear-gradient(135deg, var(--brand-dark), var(--brand-primary), var(--brand-light));-webkit-background-clip:text;-webkit-text-fill-color:transparent;background-clip:text}.dark .landing-hero h1{background:linear-gradient(135deg, var(--brand-light), #a78bfa, #c4b5fd);-webkit-background-clip:text;background-clip:text}.landing-hero p{font-size:19px;line-height:1.7;color:var(--page-muted);margin:0}.dark .landing-hero p{color:#94a3b8}.landing-section{max-width:1280px;margin:0 auto;padding:0 40px 56px}.landing-section h2{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:26px;font-weight:600;letter-spacing:-0.015em;margin:0 0 6px;color:var(--page-text)}.dark .landing-section h2{color:#e2e8f0}.landing-section>p{color:var(--page-muted);font-size:16px;margin:0 0 24px}.dark .landing-section>p{color:#94a3b8}.landing-cta{max-width:1280px;margin:0 auto;padding:0 40px 48px}.landing-divider{max-width:1280px;margin:0 auto 48px;padding:0 40px}.landing-divider hr{border:0;height:1px;background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.3), transparent);margin:0}.dark .landing-divider hr{background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.15), transparent)}.landing-section [role=\"tablist\"]{margin-bottom:12px}.landing-section [role=\"tabpanel\"]>p:first-child{color:var(--page-muted);font-size:15px;margin-bottom:20px}.dark .landing-section [role=\"tabpanel\"]>p:first-child{color:#94a3b8}.group:has(>.mermaid){background:linear-gradient(135deg, #faf8ff 0%, #f3f0ff 100%);border:1px solid rgba(95, 34, 208, 0.08);border-radius:12px;padding:28px 24px;margin:24px 0}.dark .group:has(>.mermaid){background:linear-gradient(135deg, rgba(95, 34, 208, 0.06) 0%, rgba(95, 34, 208, 0.03) 100%);border-color:rgba(124, 58, 237, 0.12)}.mermaid svg .node rect,.mermaid svg .node circle,.mermaid svg .node ellipse,.mermaid svg .node polygon,.mermaid svg .node path{fill:#ede9fe!important;stroke:#7c3aed!important;stroke-width:1.5px!important;rx:8px}.dark .mermaid svg .node rect,.dark .mermaid svg .node circle,.dark .mermaid svg .node ellipse,.dark .mermaid svg .node polygon,.dark .mermaid svg .node path{fill:rgba(124, 58, 237, 0.15)!important;stroke:#a78bfa!important}.mermaid svg .node.rhombus rect,.mermaid svg .node polygon[points]{fill:#ddd6fe!important;stroke:#6d28d9!important}.dark .mermaid svg .node.rhombus rect,.dark .mermaid svg .node polygon[points]{fill:rgba(109, 40, 217, 0.2)!important;stroke:#a78bfa!important}.mermaid svg .cluster rect{fill:rgba(237, 233, 254, 0.4)!important;stroke:rgba(124, 58, 237, 0.25)!important;stroke-width:1.5px!important;rx:10px!important}.dark .mermaid svg .cluster rect{fill:rgba(124, 58, 237, 0.08)!important;stroke:rgba(167, 139, 250, 0.2)!important}.mermaid svg .cluster-label .nodeLabel,.mermaid svg .cluster span{fill:var(--brand-dark)!important;color:var(--brand-dark)!important;font-weight:600!important}.dark .mermaid svg .cluster-label .nodeLabel,.dark .mermaid svg .cluster span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg .edgePath path.path{stroke:#8b5cf6!important;stroke-width:1.5px!important}.dark .mermaid svg .edgePath path.path{stroke:#a78bfa!important}.mermaid svg .marker{fill:#8b5cf6!important;stroke:#8b5cf6!important}.dark .mermaid svg .marker{fill:#a78bfa!important;stroke:#a78bfa!important}.mermaid svg .label,.mermaid svg .nodeLabel,.mermaid svg .label text,.mermaid svg span{fill:#1e1b4b!important;color:#1e1b4b!important;font-family:\"DM Sans\", sans-serif!important}.dark .mermaid svg .label,.dark .mermaid svg .nodeLabel,.dark .mermaid svg .label text,.dark .mermaid svg span{fill:#e2e8f0!important;color:#e2e8f0!important}.mermaid svg .edgeLabel{background-color:#faf8ff!important}.dark .mermaid svg .edgeLabel{background-color:transparent!important}.mermaid svg .edgeLabel span{fill:#6d28d9!important;color:#6d28d9!important;font-size:13px!important}.dark .mermaid svg .edgeLabel span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg{background:transparent!important}#localization-select-trigger>div:first-child{display:none!important}[data-relocated-lang]{gap:0!important}::selection{background:var(--brand-subtle);color:var(--brand-dark)}.dark ::selection{background:var(--brand-dark);color:#ffffff}*:focus-visible{outline-color:var(--brand-primary)!important}::-webkit-scrollbar-thumb{background:var(--brand-light);border-radius:4px}::-webkit-scrollbar-thumb:hover{background:var(--brand-primary)}.cloo-badge{display:inline-block;font-family:\"DM Sans\", sans-serif;font-size:12px;font-weight:600;line-height:1.5;padding:0 8px;border-radius:6px;letter-spacing:-0.01em;vertical-align:middle;white-space:nowrap;margin-right:2px}.cloo-badge--required{background:#fef2f2;color:#b91c1c}.cloo-badge--multiworker{background:#fff7ed;color:#c2410c}.cloo-badge--recommended{background:#eff6ff;color:#1d4ed8}.cloo-badge--optional{background:#f1f5f9;color:#475569}.dark .cloo-badge--required{background:rgba(185, 28, 28, 0.2);color:#fca5a5}.dark .cloo-badge--multiworker{background:rgba(194, 65, 12, 0.2);color:#fdba74}.dark .cloo-badge--recommended{background:rgba(29, 78, 216, 0.22);color:#93c5fd}.dark .cloo-badge--optional{background:rgba(71, 85, 105, 0.28);color:#cbd5e1}"}]}
{"page":{"pagePath":"ko/workspace/knowledge-graph","slug":"/ko/workspace/knowledge-graph","pageMetadata":{"title":"지식 그래프","description":"용어집·데이터베이스·문서를 하나의 그래프로 연결하여 AI 에이전트의 이해력을 높이는 통합 지식 구조","href":"/ko/workspace/knowledge-graph"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"용어집·데이터베이스·문서를 하나의 그래프로 연결하여 AI 에이전트의 이해력을 높이는 통합 지식 구조\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,CodeBlock,Columns,Frame,Heading,Info,Mermaid,Note,OptimizedImage,Step,Steps,Tab,Table,Tabs,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`개요`,children:`개요`}),`\n`,_jsxs(_components.p,{children:[`지식 그래프(Knowledge Graph)는 `,_jsx(_components.strong,{children:`용어집·데이터베이스·지식기반`}),`을 하나의 그래프로 연결한 통합 지식 구조입니다.`]}),`\n`,_jsx(_components.p,{children:`AI 에이전트가 비즈니스 용어가 어떤 테이블 컬럼에 대응되는지, 어떤 문서 맥락과 관련 있는지를 자동으로 이해할 수 있게 해줍니다.`}),`\n`,_jsx(Heading,{level:`3`,id:`지식-그래프가-해결하는-문제`,children:`지식 그래프가 해결하는 문제`}),`\n`,_jsxs(_components.p,{children:[`용어집·데이터베이스·지식기반을 각각 따로 쓰면 에이전트가 `,_jsx(_components.strong,{children:`의미를 연결하지 못합니다.`})]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`구성만 사용했을 때`}),_jsx(_components.th,{style:{textAlign:`left`},children:`한계`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`용어집만`}),_jsx(_components.td,{style:{textAlign:`left`},children:`”VIP 고객”이 뭔지는 알지만 어느 테이블에 있는지 모름`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`데이터베이스만`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`테이블 구조는 알지만 “VIP”가 `,_jsx(_components.code,{children:`tier='VIP'`}),` 필터임을 모름`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`지식기반만`}),_jsx(_components.td,{style:{textAlign:`left`},children:`문서 내용은 찾지만 실제 데이터로 연결 못 함`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`지식 그래프 사용`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`용어 → 컬럼/필터 → 관련 문서까지 한 번에 연결`})})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`활용-예시`,children:`활용 예시`}),`\n`,_jsx(CodeBlock,{numberOfLines:`16`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`16`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`사용자: 강남지점 VIP 고객이 가장 많이 산 제품 TOP 3는?`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`에이전트 동작:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` 1. resolve_term(\"VIP 고객\")`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` → users.tier = 'VIP' 매핑 발견`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` 2. resolve_term(\"강남지점\")`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` → stores.region = '강남' 매핑 발견`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` 3. find_related_tables(\"users\")`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` → orders, products 테이블 연결 발견`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` 4. SQL 자동 생성 후 실행`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`응답: 강남지점 VIP 고객 매출 TOP 3입니다:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` 1. 무선 이어폰 Pro — 1,523건`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` 2. 스마트워치 X — 1,287건`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` 3. 노이즈캔슬링 헤드폰 — 892건`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`3`,id:`세-가지-정보원`,children:`세 가지 정보원`}),`\n`,_jsx(Mermaid,{chart:`flowchart LR\n G[\"용어집\\\\nGlossary\"] --> KG[\"지식 그래프\\\\nKnowledge Graph\"]\n D[\"데이터베이스\\\\nDbSphere\"] --> KG\n K[\"지식기반\\\\nKnowledge Base\"] --> KG\n KG --> A[\"에이전트\"]`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`정보원`}),_jsx(_components.th,{style:{textAlign:`left`},children:`담는 내용`}),_jsx(_components.th,{style:{textAlign:`left`},children:`지식 그래프에서의 역할`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`용어집`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`비즈니스 용어 정의 (VIP, MRR, 강남지점 등)`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Term / Concept 노드 + 동의어·카테고리 엣지`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`데이터베이스`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`테이블/컬럼 스키마 + FK 관계`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Table / Column 노드 + 구조 엣지`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`지식기반`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`규정, 전략, 매뉴얼 등 문서`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Doc Entity 노드 + LLM 추출 관계 엣지`})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`지식-그래프-생성`,children:`지식 그래프 생성`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`새 지식 그래프 만들기`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`워크스페이스 → 지식 그래프`}),` 목록에서 `,_jsx(_components.strong,{children:`”+ 새 지식 그래프”`}),` 클릭`]}),_jsx(Frame,{caption:`지식 그래프 목록`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/0V1DlvDvbmRsNNFJ/images/workspace/knowledge-graph-list.png?fit=max\u0026auto=format\u0026n=0V1DlvDvbmRsNNFJ\u0026q=85\u0026s=7ec8fb71c43a0c9fccc08c2b85dfdae7`,alt:`지식 그래프 목록`,\"data-og-width\":`2000`,width:`2000`,\"data-og-height\":`949`,height:`949`,\"data-path\":`images/workspace/knowledge-graph-list.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/0V1DlvDvbmRsNNFJ/images/workspace/knowledge-graph-list.png?w=280\u0026fit=max\u0026auto=format\u0026n=0V1DlvDvbmRsNNFJ\u0026q=85\u0026s=b0f4e3321e94072dd13671e52bd99345 280w, https://mintcdn.com/cloocus/0V1DlvDvbmRsNNFJ/images/workspace/knowledge-graph-list.png?w=560\u0026fit=max\u0026auto=format\u0026n=0V1DlvDvbmRsNNFJ\u0026q=85\u0026s=99a562c56b2b1a8e5965f45c7f074954 560w, https://mintcdn.com/cloocus/0V1DlvDvbmRsNNFJ/images/workspace/knowledge-graph-list.png?w=840\u0026fit=max\u0026auto=format\u0026n=0V1DlvDvbmRsNNFJ\u0026q=85\u0026s=d53ebf030585a1f3a2e927f307ad3c39 840w, https://mintcdn.com/cloocus/0V1DlvDvbmRsNNFJ/images/workspace/knowledge-graph-list.png?w=1100\u0026fit=max\u0026auto=format\u0026n=0V1DlvDvbmRsNNFJ\u0026q=85\u0026s=7f7f25605ba55b1ef49dab394b939e67 1100w, https://mintcdn.com/cloocus/0V1DlvDvbmRsNNFJ/images/workspace/knowledge-graph-list.png?w=1650\u0026fit=max\u0026auto=format\u0026n=0V1DlvDvbmRsNNFJ\u0026q=85\u0026s=b6c1ddbc0bbdf08373e853e7f3cecab0 1650w, https://mintcdn.com/cloocus/0V1DlvDvbmRsNNFJ/images/workspace/knowledge-graph-list.png?w=2500\u0026fit=max\u0026auto=format\u0026n=0V1DlvDvbmRsNNFJ\u0026q=85\u0026s=36a3856e88673cf006e5de50dd562ca3 2500w`})})]}),_jsxs(Step,{title:`이름과 설명 입력`,children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`필드`}),_jsx(_components.th,{style:{textAlign:`left`},children:`설명`}),_jsx(_components.th,{style:{textAlign:`left`},children:`예시`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`이름`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`지식 그래프 식별 이름 (최대 200자)`}),_jsx(_components.td,{style:{textAlign:`left`},children:`“전사 지식 그래프”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`설명`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`용도와 목표 설명`}),_jsx(_components.td,{style:{textAlign:`left`},children:`”매출/고객/상품 통합 분석용”`})]})]})]}),_jsxs(_components.p,{children:[`권한 영역에서 `,_jsx(_components.strong,{children:`그룹별로 읽기·쓰기`}),` 권한을 설정할 수 있습니다. 조직 단위는 이 화면에서 지정할 수 없습니다 — 관리자가 그룹에 조직 단위를 연결하는 방식입니다.`]})]}),_jsx(Step,{title:`상세 페이지 진입`,children:_jsx(_components.p,{children:`생성 완료 후 자동으로 지식 그래프 상세 페이지로 이동합니다. 이제 정보원을 연결할 차례입니다.`})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`지식-그래프-상세-페이지`,children:`지식 그래프 상세 페이지`}),`\n`,_jsx(Frame,{caption:`지식 그래프 상세 페이지`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-graph-detail.png?fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=6c1f7b3ead4e38a626358deb8526b906`,alt:`지식 그래프 상세 페이지`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/workspace/knowledge-graph-detail.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-graph-detail.png?w=280\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=3418addbfab1ea31f9f30a5b6888ff83 280w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-graph-detail.png?w=560\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=ef5a2167624a35b4da7375f7896f389c 560w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-graph-detail.png?w=840\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=9ada2943c88416a6b929e01b01e46666 840w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-graph-detail.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=ff5dff6c2ab19b0971ba2d66f6cb310e 1100w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-graph-detail.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=e4244910635bde9e1644d6bced50a43e 1650w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-graph-detail.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=45bfd4bfdbe8bc5bf87cd5e0184da7ba 2500w`})}),`\n`,_jsxs(_components.p,{children:[`지식 그래프 상세 페이지는 `,_jsx(_components.strong,{children:`왼쪽 노드 목록`}),`과 `,_jsx(_components.strong,{children:`오른쪽 설정/탐색 영역`}),`으로 구성됩니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`통계-카드`,children:`통계 카드`}),`\n`,_jsx(_components.p,{children:`상단에 3개의 통계 카드가 표시됩니다.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`항목`}),_jsx(_components.th,{style:{textAlign:`left`},children:`의미`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`노드`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`그래프 내 총 노드 수`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`엣지`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`그래프 내 총 엣지 수`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`마지막 동기화`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`마지막 동기화 시점`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`llm-모델-설정`,children:`LLM 모델 설정`}),`\n`,_jsxs(_components.p,{children:[`카드 영역 우측 하단의 `,_jsx(_components.strong,{children:`“LLM 모델”`}),` 드롭다운 메뉴를 통해 지식 그래프 생성에 사용할 LLM 모델을 선택합니다. 카테고리 정의 생성, 지식기반 문서 매칭, AI 도구 설명 자동 생성 등에 사용됩니다.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`지식-연결-knowledge-link`,children:`지식 연결 (Knowledge Link)`}),`\n`,_jsxs(_components.p,{children:[`지식 연결은 지식 그래프의 핵심 구조입니다. `,_jsx(_components.strong,{children:`용어집 1개 + 지식기반 N개`}),`를 하나의 링크로 묶어, 용어와 문서 간 의미를 자동으로 연결합니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`연결-구조`,children:`연결 구조`}),`\n`,_jsx(Mermaid,{chart:`flowchart TB\n subgraph Link[\"지식 연결\"]\n GL[\"용어집\\\\n(Source)\"]\n KB1[\"지식기반 1\"]\n KB2[\"지식기반 2\"]\n end\n GL --> |\"용어 노드 생성\"| KG[\"지식 그래프\\\\nKnowledge Graph\"]\n GL -.-> |\"추출 출처 참조\"| DB[\"DB 스키마\\\\n자동 포함\"]\n DB --> |\"테이블/컬럼 노드\"| KG\n KB1 --> |\"LLM 엔티티 추출\"| KG\n KB2 --> |\"LLM 엔티티 추출\"| KG`}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`용어집에 카테고리의 `,_jsx(_components.strong,{children:`추출 출처`}),`(extraction sources)가 설정되어 있으면, 해당 DB 스키마가 지식 연결에 자동으로 포함됩니다. 별도로 DB를 추가할 필요가 없습니다.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`연결-추가`,children:`연결 추가`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`지식 연결 추가 클릭`,children:_jsxs(_components.p,{children:[`지식 그래프 상세 페이지의 `,_jsx(_components.strong,{children:`지식 연결`}),` 섹션에서 `,_jsx(_components.strong,{children:`”+ 지식 연결 추가”`}),` 버튼을 클릭`]})}),_jsx(Step,{title:`용어집 선택`,children:_jsx(_components.p,{children:`연결할 용어집을 선택합니다. 이미 연결된 용어집은 목록에서 제외됩니다.`})}),_jsxs(Step,{title:`데이터베이스 / 지식기반 선택`,children:[_jsxs(_components.p,{children:[`체크박스로 `,_jsx(_components.strong,{children:`이 지식 연결에 실제로 동기화할 소스`}),`를 선택합니다. 자동 감지된 후보 중 일부만 선택하거나 추가로 연결할 수 있습니다.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`소스`}),_jsx(_components.th,{children:`효과`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`데이터베이스`})}),_jsx(_components.td,{children:`선택한 DB의 테이블·컬럼·외래키가 그래프 노드로 추출됩니다`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`지식기반`})}),_jsx(_components.td,{children:`선택한 지식기반의 문서 청크에서 LLM이 엔티티·관계를 추출합니다`})]})]})]}),_jsx(Info,{children:_jsxs(_components.p,{children:[`체크하지 않은 소스는 자동 감지되어도 `,_jsx(_components.strong,{children:`이번 지식 연결에 포함되지 않습니다`}),`. 이전 버전과 달리 자동 강제 연결되지 않으므로, 필요한 소스만 명시적으로 선택해 동기화 비용·시간을 제어할 수 있습니다.`]})})]}),_jsx(Step,{title:`추출할 지식기반 필터 슬롯 선택 (선택)`,children:_jsxs(_components.p,{children:[`지식기반을 선택했다면, 그 지식기반의 동적 필터(부서/연도/문서 유형 등)를 지식 그래프 노드로 승격할지 선택할 수 있습니다. 자세한 동작은 아래 `,_jsx(_components.a,{href:`#%EC%A7%80%EC%8B%9D%EA%B8%B0%EB%B0%98-%ED%95%84%ED%84%B0%EB%A5%BC-%EC%A7%80%EC%8B%9D-%EA%B7%B8%EB%9E%98%ED%94%84-%EB%85%B8%EB%93%9C%EB%A1%9C-%EC%8A%B9%EA%B2%A9`,children:`지식기반 필터를 지식 그래프 노드로 승격`}),` 섹션을 참조하세요.`]})}),_jsx(Step,{title:`생성 후 동기화`,children:_jsxs(_components.p,{children:[`생성 후 `,_jsx(_components.strong,{children:`“엔티티 동기화”`}),` 버튼으로 해당 링크를 동기화합니다. 선택한 데이터베이스·지식기반만 처리되며, 동기화 대상 목록도 자동으로 갱신됩니다.`]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`연결이-만드는-노드와-엣지`,children:`연결이 만드는 노드와 엣지`}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`용어집 → 노드`,id:`%EC%9A%A9%EC%96%B4%EC%A7%91-%E2%86%92-%EB%85%B8%EB%93%9C`,children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`원본`}),_jsx(_components.th,{style:{textAlign:`left`},children:`생성되는 노드`}),_jsx(_components.th,{style:{textAlign:`left`},children:`연결 엣지`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`각 용어 (entry)`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`Term`}),` 노드`]}),_jsx(_components.td,{style:{textAlign:`left`},children:`—`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`동의어`}),_jsx(_components.td,{style:{textAlign:`left`},children:`—`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`synonym_of`}),` 엣지`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`카테고리`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`Concept`}),` 노드`]}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`broader_than`}),` 엣지`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`카테고리 → DB 컬럼 매핑`}),_jsx(_components.td,{style:{textAlign:`left`},children:`—`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`maps_to`}),` 엣지`]})]})]})]}),_jsx(_components.p,{children:`LLM 호출 없이 구조 변환만 수행하므로 빠르게 완료됩니다.`})]}),_jsxs(Tab,{title:`데이터베이스 → 노드`,id:`%EB%8D%B0%EC%9D%B4%ED%84%B0%EB%B2%A0%EC%9D%B4%EC%8A%A4-%E2%86%92-%EB%85%B8%EB%93%9C`,children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`원본`}),_jsx(_components.th,{style:{textAlign:`left`},children:`생성되는 노드`}),_jsx(_components.th,{style:{textAlign:`left`},children:`연결 엣지`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`테이블`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`Table`}),` 노드`]}),_jsx(_components.td,{style:{textAlign:`left`},children:`—`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`컬럼`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`Column`}),` 노드`]}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`belongs_to`}),` (컬럼 → 테이블)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`외래 키`}),_jsx(_components.td,{style:{textAlign:`left`},children:`—`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`foreign_key`}),` 엣지`]})]})]})]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`DB 스키마 노드를 생성하려면 `,_jsx(_components.strong,{children:`DbSphere에서 스키마 추출을 먼저 실행`}),`해야 합니다. 미실행 시 노드가 0개로 표시됩니다.`]})})]}),_jsxs(Tab,{title:`지식기반 → 노드`,id:`%EC%A7%80%EC%8B%9D%EA%B8%B0%EB%B0%98-%E2%86%92-%EB%85%B8%EB%93%9C`,children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`원본`}),_jsx(_components.th,{style:{textAlign:`left`},children:`생성되는 노드`}),_jsx(_components.th,{style:{textAlign:`left`},children:`연결 엣지`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`문서 청크 내 엔티티`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`Doc Entity`}),` 노드`]}),_jsx(_components.td,{style:{textAlign:`left`},children:`LLM이 추출한 관계 엣지`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`지식기반 필터 값 (선택한 슬롯만)`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`Doc Attribute`}),` 노드`]}),_jsx(_components.td,{style:{textAlign:`left`},children:`필터 이름 엣지 (문서 → 속성 노드)`})]})]})]}),_jsxs(_components.p,{children:[_jsx(_components.code,{children:`Doc Entity`}),`는 LLM이 각 문서 청크를 분석해 엔티티/관계를 추출한 결과입니다. `,_jsx(_components.code,{children:`Doc Attribute`}),`는 지식기반 필터 값을 그대로 그래프에 올리는 LLM 미사용 경로로, 후술하는 `,_jsx(_components.a,{href:`#%EC%A7%80%EC%8B%9D%EA%B8%B0%EB%B0%98-%ED%95%84%ED%84%B0%EB%A5%BC-%EC%A7%80%EC%8B%9D-%EA%B7%B8%EB%9E%98%ED%94%84-%EB%85%B8%EB%93%9C%EB%A1%9C-%EC%8A%B9%EA%B2%A9`,children:`지식기반 필터를 지식 그래프 노드로 승격`}),` 섹션을 참조하세요.`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`Doc Entity`}),` 추출은 `,_jsx(_components.strong,{children:`LLM 호출 비용이 발생`}),`합니다. 필요한 지식기반만 선택적으로 연결하세요. `,_jsx(_components.code,{children:`Doc Attribute`}),`는 LLM을 호출하지 않으므로 비용이 들지 않습니다.`]})})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`지식기반-필터를-지식-그래프-노드로-승격`,children:`지식기반 필터를 지식 그래프 노드로 승격`}),`\n`,_jsxs(_components.p,{children:[`지식기반에 정의된 필터 값(국가, 카테고리, 부서 등)을 그대로 그래프 노드로 올려 검색·탐색·에이전트 라우팅에 활용할 수 있습니다. `,_jsx(_components.strong,{children:`LLM을 호출하지 않으므로`}),` 비용 없이 구조화된 메타데이터를 그래프에 통합합니다.`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`예시: 지식기반에 “부서” 필터가 있고 이를 지식 그래프 노드로 승격하면, 에이전트가 “재무팀 문서 중에서 찾아줘” 같은 자연어 질의를 자동으로 부서 필터로 변환합니다.`})}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`지식 그래프 링크 카드의 노드 설정 열기`,children:_jsxs(_components.p,{children:[`화면 우측의 지식 연결에서 연결된 지식기반 카드의 `,_jsx(_components.strong,{children:`“노드 설정”`}),` 버튼을 클릭하여 모달을 엽니다.`]})}),_jsxs(Step,{title:`승격할 필터 선택`,children:[_jsx(_components.p,{children:`연결된 지식기반의 필터 값이 표시됩니다. 노드로 승격할 필터를 체크박스로 선택합니다.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`필터 종류`}),_jsx(_components.th,{style:{textAlign:`center`},children:`노드 승격 가능`}),_jsx(_components.th,{style:{textAlign:`left`},children:`비고`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`텍스트·범주형 (부서, 국가, 문서유형 등)`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✓`}),_jsx(_components.td,{style:{textAlign:`left`},children:`값 종류가 적당해 노드로 적합`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`숫자·날짜형`}),_jsx(_components.td,{style:{textAlign:`center`},children:`✓`}),_jsx(_components.td,{style:{textAlign:`left`},children:`값 종류가 매우 많아 노드 수가 급증할 수 있어 신중히 선택`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`용어집 연동형`}),_jsx(_components.td,{style:{textAlign:`center`},children:`—`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`용어집 용어로 자동 연결되어 별도 승격 불필요 (기존 `,_jsx(_components.code,{children:`Term`}),` 노드 재사용)`]})]})]})]})]}),_jsx(Step,{title:`저장 → 다음 동기화 시 반영`,children:_jsxs(_components.p,{children:[`저장하면 선택한 슬롯이 지식 그래프 링크에 저장됩니다. 다음 동기화 실행 시 선택된 슬롯의 값들이 `,_jsx(_components.code,{children:`Doc Attribute`}),` 노드로 만들어지고, 각 문서가 보유한 값과 엣지로 연결됩니다.`]})})]}),`\n`,_jsx(Heading,{level:`4`,id:`동작-원리`,children:`동작 원리`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`단계`}),_jsx(_components.th,{children:`처리`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`1. 슬롯 등록`}),_jsxs(_components.td,{children:[`선택한 필터를 지식 그래프 링크에 기록합니다. `,_jsx(_components.strong,{children:`원본 지식기반 필터 설정은 변경하지 않으므로`}),`, 지식 그래프를 안 쓰는 환경에서도 지식기반은 그대로 동작합니다`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`2. 값 수집`}),_jsx(_components.td,{children:`선택한 필터가 문서에서 실제 갖는 값들을 중복 없이 모읍니다`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`3. 용어집 매치`}),_jsxs(_components.td,{children:[`모은 값이 연결된 용어집 용어와 일치하면 `,_jsx(_components.strong,{children:`기존 Term 노드를 재사용`}),`해 그래프 중복·파편화를 방지합니다`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`4. 노드 생성`}),_jsxs(_components.td,{children:[`용어집에 없는 값만 새 `,_jsx(_components.code,{children:`Doc Attribute`}),` 노드로 생성합니다`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`5. 엣지 연결`}),_jsx(_components.td,{children:`각 문서를 자신이 가진 값 노드와 연결합니다 (예: “재무팀” 값을 가진 문서 → 재무팀 노드)`})]})]})]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`연결 엣지 이름에는 필터 이름이 그대로 쓰입니다(예: 부서, 국가). 라우팅 단계에서 더 자연스러운 이름이 제안되면 그 이름이 우선 적용됩니다.`})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`Doc Attribute`}),`는 지식기반 필터를 LLM 호출 없이 그래프로 가져오는 가벼운 경로입니다. 청크 단위 엔티티 추출(`,_jsx(_components.code,{children:`Doc Entity`}),`)이 비용 부담스러우면 우선 `,_jsx(_components.code,{children:`Doc Attribute`}),`만으로 시작하고, 필요한 지식기반에만 LLM 추출을 켜는 단계적 도입을 권장합니다.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`연결-상세-보기`,children:`연결 상세 보기`}),`\n`,_jsx(_components.p,{children:`각 지식 연결 카드를 펼치면 DB 테이블별 컬럼 매핑 현황을 확인할 수 있습니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`테이블 그룹`}),`: 연결된 DB의 테이블별로 그룹핑`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`컬럼 매핑`}),`: 컬럼명, 데이터 타입, PK/FK 표시, 매핑된 카테고리, 용어 개수`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`매칭된 문서 수`}),`: 지식기반과 매칭된 문서 개수 표시`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`동기화`,children:`동기화`}),`\n`,_jsxs(_components.p,{children:[`리소스를 연결한 후 `,_jsx(_components.strong,{children:`동기화`}),`를 실행해야 노드와 엣지가 만들어집니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`동기화-방식`,children:`동기화 방식`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`방식`}),_jsx(_components.th,{style:{textAlign:`left`},children:`버튼`}),_jsx(_components.th,{style:{textAlign:`left`},children:`범위`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`전체 동기화`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`상단 `,_jsx(_components.strong,{children:`“전체 동기화”`})]}),_jsx(_components.td,{style:{textAlign:`left`},children:`모든 소스 일괄 재구축`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`링크 단위 동기화`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`각 링크의 `,_jsx(_components.strong,{children:`“엔티티 동기화”`})]}),_jsx(_components.td,{style:{textAlign:`left`},children:`해당 링크의 용어집 + DB + 지식기반만`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`전체-동기화-흐름`,children:`전체 동기화 흐름`}),`\n`,_jsx(Mermaid,{chart:`flowchart TB\n A[\"전체 동기화 클릭\"] --> B[\"삭제된 소스 정리\"]\n B --> C[\"용어집 동기화\\\\n(빠름, LLM 불필요)\"]\n C --> D[\"DB 스키마 동기화\\\\n(빠름)\"]\n D --> E{\"지식기반 자동 추출\\\\n활성화?\"}\n E -->|\"Yes\"| F[\"지식기반 엔티티 추출\\\\n(LLM 호출, 시간 소요)\"]\n E -->|\"No\"| G[\"검색 인덱스 갱신\"]\n F --> G\n G --> H[\"통계 갱신 완료\"]`}),`\n`,_jsx(Heading,{level:`3`,id:`진행-상황-확인`,children:`진행 상황 확인`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`동기화가 시작되면 버튼이 `,_jsx(_components.strong,{children:`“동기화중”`}),` 으로 변경됩니다`]}),`\n`,_jsx(_components.li,{children:`완료/실패 시 실시간 알림(toast)이 표시됩니다`}),`\n`,_jsx(_components.li,{children:`이미 실행 중인 동기화가 있으면 중복 실행이 차단됩니다`}),`\n`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`재동기화할 때는 `,_jsx(_components.strong,{children:`새로 추가되거나 바뀐 문서만`}),` 다시 처리합니다. 이미 처리한 문서는 건너뛰어, 두 번째 동기화부터는 훨씬 빨라집니다.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`동기화-소요-시간`,children:`동기화 소요 시간`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`소스`}),_jsx(_components.th,{style:{textAlign:`left`},children:`소요 시간`}),_jsx(_components.th,{style:{textAlign:`left`},children:`비용`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`용어집`}),_jsx(_components.td,{style:{textAlign:`left`},children:`수 초`}),_jsx(_components.td,{style:{textAlign:`left`},children:`없음`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`DB 스키마`}),_jsx(_components.td,{style:{textAlign:`left`},children:`수 초 ~ 수 분`}),_jsx(_components.td,{style:{textAlign:`left`},children:`없음`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`지식기반 엔티티 추출`}),_jsx(_components.td,{style:{textAlign:`left`},children:`수 분 ~ 수 시간 (문서량에 비례)`}),_jsx(_components.td,{style:{textAlign:`left`},children:`LLM 호출 비용 발생`})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`그래프-탐색`,children:`그래프 탐색`}),`\n`,_jsx(Heading,{level:`3`,id:`그래프-시각화`,children:`그래프 시각화`}),`\n`,_jsxs(_components.p,{children:[`지식 그래프 상세 페이지 왼쪽 패널 맨 위의 `,_jsx(_components.strong,{children:`“그래프 표시”`}),` 버튼을 누르면 인터랙티브 그래프 뷰가\n`,_jsx(_components.strong,{children:`새 탭에서 전체 화면으로`}),` 열립니다. 상세 페이지 안에서 펼쳐지는 토글이 아니므로, 그래프를 보면서\n설정을 만지려면 두 탭을 나란히 두고 작업하세요.`]}),`\n`,_jsx(Frame,{caption:`그래프 시각화`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/0V1DlvDvbmRsNNFJ/images/workspace/knowledge-graph-view.png?fit=max\u0026auto=format\u0026n=0V1DlvDvbmRsNNFJ\u0026q=85\u0026s=e98206ec6cc8b5aed76f5d8be66d1c8d`,alt:`지식 그래프 시각화`,\"data-og-width\":`1913`,width:`1913`,\"data-og-height\":`906`,height:`906`,\"data-path\":`images/workspace/knowledge-graph-view.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/0V1DlvDvbmRsNNFJ/images/workspace/knowledge-graph-view.png?w=280\u0026fit=max\u0026auto=format\u0026n=0V1DlvDvbmRsNNFJ\u0026q=85\u0026s=9b3ec1388c3e8a67860083d8b30b703f 280w, https://mintcdn.com/cloocus/0V1DlvDvbmRsNNFJ/images/workspace/knowledge-graph-view.png?w=560\u0026fit=max\u0026auto=format\u0026n=0V1DlvDvbmRsNNFJ\u0026q=85\u0026s=d5d0a720b5b78d7a89c190b8f45a26a2 560w, https://mintcdn.com/cloocus/0V1DlvDvbmRsNNFJ/images/workspace/knowledge-graph-view.png?w=840\u0026fit=max\u0026auto=format\u0026n=0V1DlvDvbmRsNNFJ\u0026q=85\u0026s=e5b151b2e741e168e63ce99e2fb95313 840w, https://mintcdn.com/cloocus/0V1DlvDvbmRsNNFJ/images/workspace/knowledge-graph-view.png?w=1100\u0026fit=max\u0026auto=format\u0026n=0V1DlvDvbmRsNNFJ\u0026q=85\u0026s=8e3016e46e0efbc15428248254b95a4b 1100w, https://mintcdn.com/cloocus/0V1DlvDvbmRsNNFJ/images/workspace/knowledge-graph-view.png?w=1650\u0026fit=max\u0026auto=format\u0026n=0V1DlvDvbmRsNNFJ\u0026q=85\u0026s=da9b2ecd1debde78f95c5dafc69fce10 1650w, https://mintcdn.com/cloocus/0V1DlvDvbmRsNNFJ/images/workspace/knowledge-graph-view.png?w=2500\u0026fit=max\u0026auto=format\u0026n=0V1DlvDvbmRsNNFJ\u0026q=85\u0026s=e39b51309803c46a72ff89d97438a576 2500w`})}),`\n`,_jsx(Heading,{level:`4`,id:`조작-방법`,children:`조작 방법`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`동작`}),_jsx(_components.th,{style:{textAlign:`left`},children:`방법`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`확대/축소`}),_jsx(_components.td,{style:{textAlign:`left`},children:`마우스 휠 또는 트랙패드`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`이동`}),_jsx(_components.td,{style:{textAlign:`left`},children:`배경 드래그`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`노드 선택`}),_jsx(_components.td,{style:{textAlign:`left`},children:`노드 클릭 → 이웃 하이라이트 + 상세 패널 표시`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`엣지 선택`}),_jsx(_components.td,{style:{textAlign:`left`},children:`엣지 클릭 → 연결 정보 패널 표시`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`전체 보기`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`툴바의 `,_jsx(_components.strong,{children:`맞춤`}),` 버튼`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`타입별 포커스`}),_jsx(_components.td,{style:{textAlign:`left`},children:`상단 타입 버튼(Term, Concept, Table 등) 클릭 → 해당 타입과 직접 연결된 항목만 표시`})]})]})]}),`\n`,_jsx(Heading,{level:`4`,id:`노드-타입과-색상`,children:`노드 타입과 색상`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`타입`}),_jsx(_components.th,{style:{textAlign:`left`},children:`색상`}),_jsx(_components.th,{style:{textAlign:`left`},children:`의미`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Glossary`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`남보라 `,_jsx(_components.code,{children:`#735CD9`})]}),_jsx(_components.td,{style:{textAlign:`left`},children:`연결된 용어집(소스)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Term`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`파랑 `,_jsx(_components.code,{children:`#4A71D8`})]}),_jsx(_components.td,{style:{textAlign:`left`},children:`용어집의 비즈니스 용어`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Concept`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`보라 `,_jsx(_components.code,{children:`#8761CE`})]}),_jsx(_components.td,{style:{textAlign:`left`},children:`용어 상위 카테고리`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Database`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`하늘색 `,_jsx(_components.code,{children:`#3589B0`})]}),_jsx(_components.td,{style:{textAlign:`left`},children:`연결된 데이터베이스(소스)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Table`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`초록 `,_jsx(_components.code,{children:`#228F5E`})]}),_jsx(_components.td,{style:{textAlign:`left`},children:`DB 테이블`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Column`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`주황 `,_jsx(_components.code,{children:`#C26754`})]}),_jsx(_components.td,{style:{textAlign:`left`},children:`DB 컬럼`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Knowledge Base`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`회청록 `,_jsx(_components.code,{children:`#5F8C8B`})]}),_jsx(_components.td,{style:{textAlign:`left`},children:`연결된 지식기반(소스)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Document`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`갈색 `,_jsx(_components.code,{children:`#B4754E`})]}),_jsx(_components.td,{style:{textAlign:`left`},children:`지식기반 문서`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Doc Entity`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`분홍 `,_jsx(_components.code,{children:`#C64886`})]}),_jsx(_components.td,{style:{textAlign:`left`},children:`문서에서 LLM이 추출한 엔티티`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Doc Attribute`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`청회색 `,_jsx(_components.code,{children:`#4E8CA6`})]}),_jsx(_components.td,{style:{textAlign:`left`},children:`지식기반 필터 값에서 승격된 속성 노드`})]})]})]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`노드가 500개를 초과하면 `,_jsx(_components.strong,{children:`“Truncated”`}),` 경고가 표시됩니다. 타입별 포커스를 사용해 관심 있는 영역만 확인하세요.`]})}),`\n`,_jsx(Heading,{level:`4`,id:`노드-상세-패널`,children:`노드 상세 패널`}),`\n`,_jsx(_components.p,{children:`노드를 클릭하면 오른쪽에 상세 패널이 나타납니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`속성 테이블`}),`: 노드의 상세 속성 (라벨, 타입, 설명 등)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`연결 목록`}),`: 이 노드와 연결된 이웃 노드 목록 (방향 화살표 + 엣지 타입 + 이웃 정보)`]}),`\n`,_jsx(_components.li,{children:`이웃 노드를 클릭하면 해당 노드로 이동합니다`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`노드-목록`,children:`노드 목록`}),`\n`,_jsx(_components.p,{children:`왼쪽 패널에서 모든 노드를 리스트로 탐색할 수 있습니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`검색`}),`: 노드 라벨로 검색 (서버 사이드, 대규모 그래프에서도 빠름)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`타입 필터`}),`: 전체 유형 / Column / Concept / Database / Doc Attribute / Document / Glossary / Knowledge Base / Table / Term`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`페이징`}),`: 20개 단위로 페이지 이동`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`시맨틱-검색`,children:`시맨틱 검색`}),`\n`,_jsxs(_components.p,{children:[`지식 그래프 상세 페이지의 `,_jsx(_components.strong,{children:`시맨틱 검색`}),` 섹션에서 자연어로 노드를 검색할 수 있습니다.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`벡터 유사도 기반으로 가장 관련 높은 노드를 점수와 함께 반환합니다`}),`\n`,_jsx(_components.li,{children:`각 결과에 노드 타입 뱃지와 유사도 점수가 표시됩니다`}),`\n`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`시맨틱 검색을 사용하려면 시스템 관리자가 `,_jsx(_components.strong,{children:`검색 엔진`}),`(Search Engine)을 설정해야 합니다. 미설정 시 경고 배너가 표시됩니다.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`에이전트-연동`,children:`에이전트 연동`}),`\n`,_jsxs(_components.p,{children:[`지식 그래프의 진짜 힘은 `,_jsx(_components.strong,{children:`에이전트에 연결했을 때`}),` 나옵니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`지식-그래프를-에이전트에-연결`,children:`지식 그래프를 에이전트에 연결`}),`\n`,_jsxs(_components.p,{children:[`에이전트 편집 페이지의 `,_jsx(_components.strong,{children:`지식 그래프`}),` 섹션에서 사용할 지식 그래프를 선택합니다.`]}),`\n`,_jsx(Frame,{caption:`에이전트에 지식 그래프 연결`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-graph-agent.png?fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=969f2446bdf66a6637d665428c653bbc`,alt:`에이전트 편집기의 지식 그래프 선택 모달`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/workspace/knowledge-graph-agent.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-graph-agent.png?w=280\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=fcfb46ebd87c989312b8036a6883eb3d 280w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-graph-agent.png?w=560\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=50ecf82c69b302d3cfd5e979eb92da9c 560w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-graph-agent.png?w=840\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=379e145cdbec6ed751c1d2a4fd98e365 840w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-graph-agent.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=589d08d8b7b7401a80326c8f4583a75d 1100w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-graph-agent.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=2020231ad1f6b5c6b8e7c41acaf7ad83 1650w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/workspace/knowledge-graph-agent.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=f664888f8e7c650e7952d337dc80971a 2500w`})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`지식 그래프를 연결하면 해당 지식 그래프에 포함된 `,_jsx(_components.strong,{children:`용어집·데이터베이스·지식기반`}),`이 에이전트에 자동 상속됩니다. 동일 리소스를 에이전트에 중복 추가할 필요가 없습니다.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`지식-그래프-도구-7종`,children:`지식 그래프 도구 7종`}),`\n`,_jsx(_components.p,{children:`지식 그래프를 연결한 에이전트는 아래 7개 도구를 자동으로 사용할 수 있습니다.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`도구`}),_jsx(_components.th,{style:{textAlign:`left`},children:`용도`}),_jsx(_components.th,{style:{textAlign:`left`},children:`사용 예시`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`resolve_term`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`비즈니스 용어 → DB 컬럼/필터 매핑`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`”VIP 고객” → `,_jsx(_components.code,{children:`tier='VIP'`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`explore_context`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`시드 엔티티 주변 서브그래프 탐색`}),_jsx(_components.td,{style:{textAlign:`left`},children:`복잡한 다단계 질문의 맥락 파악`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`search_concepts`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`의미 기반 노드 검색 + 이웃 확장`}),_jsx(_components.td,{style:{textAlign:`left`},children:`”매출 관련 용어 찾기”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`find_related_tables`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`FK로 연결된 테이블 + JOIN 힌트`}),_jsx(_components.td,{style:{textAlign:`left`},children:`”users 테이블과 조인 가능한 테이블”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`neighbors`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`특정 노드의 N-hop 이웃 탐색`}),_jsx(_components.td,{style:{textAlign:`left`},children:`특정 테이블과 연결된 모든 용어`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`fetch_data`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`SQL 실행 + 실제 데이터 반환 (최대 100행)`}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`SELECT * FROM orders LIMIT 10`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`fetch_document`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`지식 그래프 연결 지식기반에서 문서 청크 검색`}),_jsx(_components.td,{style:{textAlign:`left`},children:`”VIP 정책 관련 문서 찾기”`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`fetch_data`}),`는 0행이 반환되면 자동으로 관련 문서 검색(fallback)을 수행합니다. 데이터와 문서를 하나의 도구로 통합 조회할 수 있습니다.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`도구-테스터`,children:`도구 테스터`}),`\n`,_jsxs(_components.p,{children:[`에이전트에 연결하기 전에 `,_jsx(_components.strong,{children:`“KG 도구 테스트”`}),` 섹션에서 각 도구를 직접 실행해볼 수 있습니다.`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`도구 테스터 열기`,children:_jsxs(_components.p,{children:[`오른쪽 패널 아래의 `,_jsx(_components.strong,{children:`“KG 도구 테스트”`}),` 섹션에서 `,_jsx(_components.strong,{children:`“보기”`}),` 클릭 (다시 누르면 `,_jsx(_components.strong,{children:`“숨기기”`}),`)`]})}),_jsx(Step,{title:`도구 선택 및 실행`,children:_jsxs(_components.p,{children:[`드롭다운에서 도구를 선택하고, 입력값을 넣은 후 `,_jsx(_components.strong,{children:`“실행”`}),` 클릭`]})}),_jsx(Step,{title:`결과 확인`,children:_jsx(_components.p,{children:`JSON 형태의 결과가 하단에 표시됩니다. 동기화 결과가 올바른지, 용어 매핑이 정확한지 확인하세요.`})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`노드-관리`,children:`노드 관리`}),`\n`,_jsx(Heading,{level:`3`,id:`노드-타입-요약`,children:`노드 타입 요약`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`타입`}),_jsx(_components.th,{style:{textAlign:`left`},children:`출처`}),_jsx(_components.th,{style:{textAlign:`left`},children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Glossary`}),_jsx(_components.td,{style:{textAlign:`left`},children:`용어집`}),_jsx(_components.td,{style:{textAlign:`left`},children:`연결된 용어집(소스) 노드`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Term`}),_jsx(_components.td,{style:{textAlign:`left`},children:`용어집`}),_jsx(_components.td,{style:{textAlign:`left`},children:`비즈니스 용어 (예: VIP, MRR)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Concept`}),_jsx(_components.td,{style:{textAlign:`left`},children:`용어집`}),_jsx(_components.td,{style:{textAlign:`left`},children:`용어 상위 카테고리 (예: 고객등급, 매출유형)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Database`}),_jsx(_components.td,{style:{textAlign:`left`},children:`데이터베이스`}),_jsx(_components.td,{style:{textAlign:`left`},children:`연결된 데이터베이스(소스) 노드`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Table`}),_jsx(_components.td,{style:{textAlign:`left`},children:`데이터베이스`}),_jsx(_components.td,{style:{textAlign:`left`},children:`데이터베이스 테이블`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Column`}),_jsx(_components.td,{style:{textAlign:`left`},children:`데이터베이스`}),_jsx(_components.td,{style:{textAlign:`left`},children:`테이블의 컬럼`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Knowledge Base`}),_jsx(_components.td,{style:{textAlign:`left`},children:`지식기반`}),_jsx(_components.td,{style:{textAlign:`left`},children:`연결된 지식기반(소스) 노드`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Document`}),_jsx(_components.td,{style:{textAlign:`left`},children:`지식기반`}),_jsx(_components.td,{style:{textAlign:`left`},children:`지식기반 문서`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Doc Entity`}),_jsx(_components.td,{style:{textAlign:`left`},children:`지식기반`}),_jsx(_components.td,{style:{textAlign:`left`},children:`문서에서 LLM이 추출한 엔티티`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Doc Attribute`}),_jsx(_components.td,{style:{textAlign:`left`},children:`지식기반`}),_jsx(_components.td,{style:{textAlign:`left`},children:`지식기반 필터 값에서 승격된 속성 노드`})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`자주-묻는-질문`,children:`자주 묻는 질문`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`지식 그래프와 용어집의 차이는?`,icon:`circle-question`,id:`%EC%9A%A9%EC%96%B4%EC%A7%91%EC%9D%80-%EC%9A%A9%EC%96%B4-%EC%A0%95%EC%9D%98%EB%A7%8C-%EA%B4%80%EB%A6%AC%ED%95%A9%EB%8B%88%EB%8B%A4.-%EC%A7%80%EC%8B%9D-%EA%B7%B8%EB%9E%98%ED%94%84%EB%8A%94-%EC%9A%A9%EC%96%B4%EC%A7%91%EC%9D%84-%EB%8D%B0%EC%9D%B4%ED%84%B0%EB%B2%A0%EC%9D%B4%EC%8A%A4-%EC%BB%AC%EB%9F%BC%C2%B7%EB%AC%B8%EC%84%9C-%EC%97%94%ED%8B%B0%ED%8B%B0%EC%99%80-%EC%97%B0%EA%B2%B0%ED%95%B4-%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8%EA%B0%80-%EC%8B%A4%EC%A0%9C-%EB%8D%B0%EC%9D%B4%ED%84%B0%EB%A1%9C-%EB%8B%B5%ED%95%A0-%EC%88%98-%EC%9E%88%EA%B2%8C-%ED%95%A9%EB%8B%88%EB%8B%A4.`,children:_jsxs(_components.p,{children:[`용어집은 `,_jsx(_components.strong,{children:`용어 정의`}),`만 관리합니다. 지식 그래프는 용어집을 `,_jsx(_components.strong,{children:`데이터베이스 컬럼·문서 엔티티`}),`와 연결해 에이전트가 실제 데이터로 답할 수 있게 합니다.`]})}),_jsx(Accordion,{title:`지식 그래프와 DbSphere(데이터베이스)의 차이는?`,icon:`circle-question`,id:`dbsphere`,children:_jsxs(_components.p,{children:[`DbSphere는 `,_jsx(_components.strong,{children:`스키마 기반 SQL 생성`}),`에 특화됩니다. 지식 그래프는 여기에 `,_jsx(_components.strong,{children:`비즈니스 용어와 문서 맥락`}),`을 더해 “VIP 고객”처럼 스키마에 없는 표현도 이해합니다.`]})}),_jsxs(Accordion,{title:`동기화에 시간이 너무 오래 걸려요`,icon:`clock`,id:`-1`,children:[_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`용어집/DB 동기화`}),`: 수 초 ~ 수 분 (빠름)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`지식기반 엔티티 추출`}),`: 문서 수에 비례하여 수 분 ~ 수 시간`]}),`\n`]}),_jsx(_components.p,{children:`지식기반은 새로 추가되거나 바뀐 문서만 다시 처리하고, 이미 처리한 문서는 건너뜁니다. 그래서 큰 지식기반도 처음 한 번만 오래 걸리고, 이후 동기화는 빠릅니다.`})]}),_jsx(Accordion,{title:`동기화가 실패했어요`,icon:`triangle-exclamation`,id:`-2`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`DB 관련 오류`}),`: DbSphere에서 먼저 스키마 추출이 성공했는지 확인하세요`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`지식기반 추출 오류`}),`: LLM 모델 설정과 API 키가 올바른지 확인하세요`]}),`\n`,_jsx(_components.li,{children:`이미 실행 중인 동기화가 있으면 중복 실행이 차단됩니다 — 잠시 후 재시도하세요`}),`\n`]})}),_jsxs(Accordion,{title:`LLM 비용이 걱정돼요`,icon:`coins`,id:`llm`,children:[_jsxs(_components.p,{children:[`지식기반 `,_jsx(_components.strong,{children:`엔티티 추출`}),`만 LLM을 호출합니다. 비용을 제어하려면:`]}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`필요한 지식기반만 선택적으로 연결`}),`\n`,_jsxs(_components.li,{children:[`용어집과 DB만으로도 `,_jsx(_components.code,{children:`resolve_term`}),`과 `,_jsx(_components.code,{children:`find_related_tables`}),`는 정상 동작합니다`]}),`\n`]})]}),_jsx(Accordion,{title:`여러 지식 그래프를 에이전트에 연결할 수 있나요?`,icon:`layer-group`,id:`-3`,children:_jsxs(_components.p,{children:[`네. 여러 지식 그래프를 연결하면 모든 지식 그래프의 노드와 엣지를 `,_jsx(_components.strong,{children:`통합하여`}),` 도구가 동작합니다. 도메인별로 지식 그래프를 분리 운영하면서 에이전트에서는 통합 조회할 수 있습니다.`]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`관련-가이드`,children:`관련 가이드`}),`\n`,_jsxs(Columns,{cols:3,children:[_jsx(Card,{title:`용어집`,icon:`book`,href:`/ko/workspace/glossary`,children:_jsx(_components.p,{children:`비즈니스 용어 정의 · 동의어 · 카테고리 관리`})}),_jsx(Card,{title:`데이터베이스`,icon:`database`,href:`/ko/workspace/database`,children:_jsx(_components.p,{children:`DB 연결 · 스키마 추출 · SQL 실행`})}),_jsx(Card,{title:`에이전트`,icon:`robot`,href:`/ko/workspace/agents`,children:_jsx(_components.p,{children:`AI 에이전트 설정 · 도구 연결 · 워크플로우`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"지식 그래프","description":"용어집·데이터베이스·문서를 하나의 그래프로 연결하여 AI 에이전트의 이해력을 높이는 통합 지식 구조","href":"/ko/workspace/knowledge-graph"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"개요","slug":"개요","depth":2,"children":[{"title":"지식 그래프가 해결하는 문제","slug":"지식-그래프가-해결하는-문제","depth":3,"children":[]},{"title":"활용 예시","slug":"활용-예시","depth":3,"children":[]},{"title":"세 가지 정보원","slug":"세-가지-정보원","depth":3,"children":[]}]},{"title":"지식 그래프 생성","slug":"지식-그래프-생성","depth":2,"children":[]},{"title":"지식 그래프 상세 페이지","slug":"지식-그래프-상세-페이지","depth":2,"children":[{"title":"통계 카드","slug":"통계-카드","depth":3,"children":[]},{"title":"LLM 모델 설정","slug":"llm-모델-설정","depth":3,"children":[]}]},{"title":"지식 연결 (Knowledge Link)","slug":"지식-연결-knowledge-link","depth":2,"children":[{"title":"연결 구조","slug":"연결-구조","depth":3,"children":[]},{"title":"연결 추가","slug":"연결-추가","depth":3,"children":[]},{"title":"연결이 만드는 노드와 엣지","slug":"연결이-만드는-노드와-엣지","depth":3,"children":[]},{"title":"지식기반 필터를 지식 그래프 노드로 승격","slug":"지식기반-필터를-지식-그래프-노드로-승격","depth":3,"children":[]},{"title":"동작 원리","slug":"동작-원리","depth":4,"children":[]},{"title":"연결 상세 보기","slug":"연결-상세-보기","depth":3,"children":[]}]},{"title":"동기화","slug":"동기화","depth":2,"children":[{"title":"동기화 방식","slug":"동기화-방식","depth":3,"children":[]},{"title":"전체 동기화 흐름","slug":"전체-동기화-흐름","depth":3,"children":[]},{"title":"진행 상황 확인","slug":"진행-상황-확인","depth":3,"children":[]},{"title":"동기화 소요 시간","slug":"동기화-소요-시간","depth":3,"children":[]}]},{"title":"그래프 탐색","slug":"그래프-탐색","depth":2,"children":[{"title":"그래프 시각화","slug":"그래프-시각화","depth":3,"children":[]},{"title":"조작 방법","slug":"조작-방법","depth":4,"children":[]},{"title":"노드 타입과 색상","slug":"노드-타입과-색상","depth":4,"children":[]},{"title":"노드 상세 패널","slug":"노드-상세-패널","depth":4,"children":[]},{"title":"노드 목록","slug":"노드-목록","depth":3,"children":[]},{"title":"시맨틱 검색","slug":"시맨틱-검색","depth":3,"children":[]}]},{"title":"에이전트 연동","slug":"에이전트-연동","depth":2,"children":[{"title":"지식 그래프를 에이전트에 연결","slug":"지식-그래프를-에이전트에-연결","depth":3,"children":[]},{"title":"지식 그래프 도구 7종","slug":"지식-그래프-도구-7종","depth":3,"children":[]},{"title":"도구 테스터","slug":"도구-테스터","depth":3,"children":[]}]},{"title":"노드 관리","slug":"노드-관리","depth":2,"children":[{"title":"노드 타입 요약","slug":"노드-타입-요약","depth":3,"children":[]}]},{"title":"자주 묻는 질문","slug":"자주-묻는-질문","depth":2,"children":[]},{"title":"관련 가이드","slug":"관련-가이드","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/cloocus/45db6ee3c57396cb/toc.js","/_mintlify/custom/cloocus/9670a2c81dc38d5e/tools/playwright-video-mcp/index.js","/_mintlify/custom/cloocus/4540e1c308555295/lang-toggle.js"],"subdomain":"cloocus","siteName":"Cloosphere Guide","title":"지식 그래프 - Cloosphere Guide","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"ko":{"href":"/ko/workspace/knowledge-graph","matchLevel":0},"en":{"href":"/en/workspace/knowledge-graph","matchLevel":1}}},"lastModified":"2026-08-26T04:23:58.427Z","originalFileLocation":"ko/workspace/knowledge-graph.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"용어집·데이터베이스·문서를 하나의 그래프로 연결하여 AI 에이전트의 이해력을 높이는 통합 지식 구조\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"지식 그래프 - Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:description\" content=\"용어집·데이터베이스·문서를 하나의 그래프로 연결하여 AI 에이전트의 이해력을 높이는 통합 지식 구조\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cloosphere.ai/ko/workspace/knowledge-graph\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=%EC%A7%80%EC%8B%9D+%26+%EB%8D%B0%EC%9D%B4%ED%84%B0\u0026amp;title=%EC%A7%80%EC%8B%9D+%EA%B7%B8%EB%9E%98%ED%94%84\u0026amp;description=%EC%9A%A9%EC%96%B4%EC%A7%91%C2%B7%EB%8D%B0%EC%9D%B4%ED%84%B0%EB%B2%A0%EC%9D%B4%EC%8A%A4%C2%B7%EB%AC%B8%EC%84%9C%EB%A5%BC+%ED%95%98%EB%82%98%EC%9D%98+%EA%B7%B8%EB%9E%98%ED%94%84%EB%A1%9C+%EC%97%B0%EA%B2%B0%ED%95%98%EC%97%AC+AI+%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8%EC%9D%98+%EC%9D%B4%ED%95%B4%EB%A0%A5%EC%9D%84+%EB%86%92%EC%9D%B4%EB%8A%94+%ED%86%B5%ED%95%A9+%EC%A7%80%EC%8B%9D+%EA%B5%AC%EC%A1%B0\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=cec540378e2678fd36e8606cf2e3d2bd3c3b6a61637879f6050f4e6fcd3dad30\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"지식 그래프 - Cloosphere Guide\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"용어집·데이터베이스·문서를 하나의 그래프로 연결하여 AI 에이전트의 이해력을 높이는 통합 지식 구조\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=%EC%A7%80%EC%8B%9D+%26+%EB%8D%B0%EC%9D%B4%ED%84%B0\u0026amp;title=%EC%A7%80%EC%8B%9D+%EA%B7%B8%EB%9E%98%ED%94%84\u0026amp;description=%EC%9A%A9%EC%96%B4%EC%A7%91%C2%B7%EB%8D%B0%EC%9D%B4%ED%84%B0%EB%B2%A0%EC%9D%B4%EC%8A%A4%C2%B7%EB%AC%B8%EC%84%9C%EB%A5%BC+%ED%95%98%EB%82%98%EC%9D%98+%EA%B7%B8%EB%9E%98%ED%94%84%EB%A1%9C+%EC%97%B0%EA%B2%B0%ED%95%98%EC%97%AC+AI+%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8%EC%9D%98+%EC%9D%B4%ED%95%B4%EB%A0%A5%EC%9D%84+%EB%86%92%EC%9D%B4%EB%8A%94+%ED%86%B5%ED%95%A9+%EC%A7%80%EC%8B%9D+%EA%B5%AC%EC%A1%B0\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=cec540378e2678fd36e8606cf2e3d2bd3c3b6a61637879f6050f4e6fcd3dad30\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5f22d0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cloosphere.ai/ko/workspace/knowledge-graph\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ko/workspace/knowledge-graph.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.cloosphere.ai/ko/workspace/knowledge-graph\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.cloosphere.ai/en/workspace/knowledge-graph\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.cloosphere.ai/ko/workspace/knowledge-graph\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cloosphere.ai/#organization\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cloosphere.ai#website\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cloosphere.ai/ko/workspace/knowledge-graph#webpage\",\"url\":\"https://docs.cloosphere.ai/ko/workspace/knowledge-graph\",\"name\":\"지식 그래프\",\"description\":\"용어집·데이터베이스·문서를 하나의 그래프로 연결하여 AI 에이전트의 이해력을 높이는 통합 지식 구조\",\"dateModified\":\"2026-08-26T04:23:58.427Z\",\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cloosphere.ai/ko/workspace/knowledge-graph#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cloosphere.ai/ko/workspace/knowledge-graph#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"지식 \u0026 데이터\",\"item\":\"https://docs.cloosphere.ai/ko/workspace/knowledge\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"지식 그래프\",\"item\":\"https://docs.cloosphere.ai/ko/workspace/knowledge-graph\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cloosphere.ai/ko/workspace/knowledge-graph#article\",\"headline\":\"지식 그래프\",\"name\":\"지식 그래프\",\"description\":\"용어집·데이터베이스·문서를 하나의 그래프로 연결하여 AI 에이전트의 이해력을 높이는 통합 지식 구조\",\"url\":\"https://docs.cloosphere.ai/ko/workspace/knowledge-graph\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cloosphere.ai/ko/workspace/knowledge-graph#webpage\"},\"dateModified\":\"2026-08-26T04:23:58.427Z\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cloosphere Guide\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cloosphere Guide\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/ko/workspace/knowledge-graph.md","siteName":"Cloosphere Guide","nav":{"global":null,"languages":[{"language":"ko","default":true,"tabs":[{"tab":"시작하기","icon":"rocket","pages":[{"title":"시작하기","href":"/ko"}]},{"tab":"채팅","icon":"comments","pages":[{"title":"채팅","href":"/ko/chat/overview"}]},{"tab":"워크스페이스","icon":"briefcase","groups":[{"group":"워크스페이스","pages":[{"title":"워크스페이스 개요","href":"/ko/workspace/overview"}]},{"group":"AI 에이전트","pages":[{"title":"에이전트","href":"/ko/workspace/agents"},{"title":"에이전트 플로우","href":"/ko/workspace/flows"},{"title":"플로우 노드 레퍼런스","href":"/ko/workspace/flows-nodes"}]},{"group":"지식 \u0026 데이터","pages":[{"title":"지식기반","href":"/ko/workspace/knowledge"},{"title":"동적 필터 상세 가이드","description":"지식기반 동적 필터의 내부 동작 원리, 수동 vs AI 비교, 에이전트 자동 필터링 흐름까지 상세 안내","href":"/ko/workspace/knowledge-filters"},{"title":"지식 그래프","href":"/ko/workspace/knowledge-graph"},{"title":"데이터베이스","description":"NL-to-SQL 기반 자연어 데이터베이스 조회 — DbSphere 연결 설정 및 활용 가이드","href":"/ko/workspace/database"},{"title":"용어집","href":"/ko/workspace/glossary"}]},{"group":"안전","pages":[{"title":"가드레일","href":"/ko/workspace/guardrails"}]},{"group":"커스터마이징","pages":[{"title":"프롬프트","href":"/ko/workspace/prompts"},{"title":"스킬","href":"/ko/workspace/skills"},{"title":"도구","href":"/ko/workspace/tools"},{"title":"마켓플레이스","href":"/ko/workspace/marketplace"},{"title":"태그","href":"/ko/workspace/tags"}]}]},{"tab":"협업","icon":"users","pages":[{"title":"협업","href":"/ko/collaboration/overview"}]},{"tab":"자동화","icon":"clock","pages":[{"title":"자동화","href":"/ko/automation/overview"}]},{"tab":"관리자","icon":"gear","pages":[{"title":"관리자","href":"/ko/admin/overview"}]},{"tab":"모니터링","icon":"chart-line","pages":[{"title":"모니터링","href":"/ko/monitoring/overview"}]},{"tab":"운영 · 지원","icon":"screwdriver-wrench","pages":[{"title":"운영 · 지원","href":"/ko/admin/deployment-checklist"}]}]},{"language":"en","pages":[{"title":"en","href":"/en/workspace/knowledge-graph"}]}]},"basePath":"","title":"지식 그래프 - Cloosphere Guide","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-D0FT0qQs.js","DynamicMarkdown-CQM9Bhbv.js","zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js"]}