> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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 초과**, 잡음일 수 있는 건 **0.4 미만** 입니다.

## 증거 트레일

받아들인 제안마다 소스 문서와 인용 링크가 남습니다. 그래프에서 변수나 엣지를 우클릭 → **View evidence**로 무엇이 뒷받침했는지 봅니다. 감사와, 소스가 바뀌었을 때 고치는 데 좋습니다.

## 추출 다시 돌리기

같은 소스에 같은 설정으로 다시 돌리면 멱등입니다. Nora가 이미 만들었거나 전에 거부한 제안을 건너뜁니다.

문서가 업데이트됐으면 추출이 새 내용을 집어와 기존 변수/엣지에 변경을 제안합니다.

## 추출과 손 작성 섞기

대부분 그래프는 섞어서 완성됩니다. 추출이 구조의 60%쯤 씨를 뿌리고, 그다음 전문가가 중요한 엣지를 손으로 손봅니다. 그게 의도한 흐름이니 덮어쓰기를 주저하지 마세요.

## 추출 품질 팁

* **깨끗한 소스가 깨끗한 추출을 만듭니다.** 잘 짜인 문서가 PDF 스캔보다 훨씬 잘 뽑힙니다.
* **도메인 용어집이 도움이 됩니다.** 용어집 문서를 붙이면 추출이 변수 이름을 정규화하는 데 씁니다.
* **되풀이하세요.** 추출하고, 보고, 일부 받아들이고, 배포합니다. 그다음 더 풍부해진 그래프를 맥락으로 다시 추출하면, 나중 실행이 기존 변수를 알아서 다듬습니다.