> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.

# 문서에서 추출

> 기존 지식으로 인과 그래프 부트스트랩 — 리뷰하고 수락하는 제안.

인과 그래프를 처음부터 만들면 타이핑이 많음. 도메인의 메커니즘을 설명하는 지식 문서가 이미 있다면 Nora 가 변수와 엣지를 자동 제안 가능.

## 추출 워크플로우

1. 지식 컬렉션 또는 특정 문서 선택.
2. 추출 실행.
3. 스테이지 뷰에서 제안 리뷰.
4. 각각 수락·거부·편집.
5. 수락된 항목이 Draft 그래프에 착지.

여러분이 수락하고 배포하기 전까지 라이브 그래프는 아무것도 안 바뀜.

## 추출 실행

1. 그래프 열고 **Extract from documents** 클릭.
2. 소스 선택:
   * 전체 컬렉션.
   * 태그 필터 슬라이스.
   * 특정 문서 (다중 선택).
3. 추출 스코프 선택:
   * **Variables only** — 측정 가능한 수량 찾기.
   * **Edges only** — 변수 존재 가정, 그들 사이 관계 찾기.
   * **Both** — 엔드투엔드.
4. 실행.

추출은 비동기 — 스테이지 제안이 리뷰 준비되면 알림. 전형적 시간: 소스 크기에 따라 1-10분.

## 제안 리뷰

스테이지 뷰가 제안을 그룹화:

* **새 변수** — 제안된 이름·타입·단위·증거 인용.
* **새 엣지** — 제안된 방향·부호·메커니즘·증거 인용.
* **병합** — 비슷한 변수의 제안된 통합 (예: "customer\_lifetime\_value" 와 "clv" 를 같은 변수로).

각 제안이 소스 문서, 인용된 구절, 신뢰 점수 표시. 제안 클릭으로 전체 컨텍스트 확인.

## 수락

제안당 세 액션:

* **Accept** — Draft 에 있는 그대로 병합.
* **Edit & accept** — 수정 (이름 변경, 타입 변경, 부호 조정) 후 수락.
* **Reject** — 기각. 이유 추가로 미래 추출 개선 도움.

전체 배치 벌크 수락/거부 또는 신뢰도별 하위집합.

## 신뢰도

모든 제안이 신뢰 점수 (0-1) 가짐. 높은 신뢰 제안은 종종 벌크 수락 가능; 낮은 신뢰는 개별 리뷰 필요.

스테이지 뷰 필터: 자동 승인 가치는 **> 0.8 confidence**, 잡음 가능성은 **\< 0.4**.

## 증거 트레일

모든 수락된 제안은 소스 문서 + 인용 링크 유지. 그래프에서 변수·엣지 우클릭 → **View evidence** 로 무엇이 뒷받침했는지 확인. 감사성과 소스 변경 시 개정에 유용.

## 추출 재실행

같은 소스에 같은 설정으로 재실행은 멱등 — Nora 가 이미 만들었거나 이전에 거부된 제안 스킵.

문서가 업데이트됐으면 추출이 새 콘텐츠를 픽업해 기존 변수/엣지에 변경 제안.

## 추출과 수동 저작 결합

대부분 그래프는 섞임으로 수렴: 추출이 구조의 \~60% 시드, 그 다음 전문가가 중요한 엣지를 손으로 튜닝. 그것이 의도된 워크플로우 — 오버라이드 주저 마세요.

## 추출 품질 팁

* **깨끗한 소스 → 깨끗한 추출.** 잘 구조화된 문서가 PDF 스캔보다 훨씬 더 잘 추출.
* **도메인 특화 용어집이 도움.** 용어집 문서 붙임 — 추출이 변수 이름 정규화에 사용.
* **반복.** 추출, 리뷰, 일부 수락, 배포. 그 다음 더 풍부한 그래프를 컨텍스트로 다시 추출 — 나중 실행이 기존 변수를 알아서 개선.