> ## 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.

# 에이전트가 그래프를 픽업하는 방식

> Agent 가 이미 쓰는 데이터 소스에서 그래프가 자동 참조됨 — 별도 attach 스텝 없음.

인과 그래프를 Agent 에 직접 붙이지 않습니다. 참조가 Agent 의 기존 데이터 소스에서 **파생**: Agent 가 그래프가 **연결된** 문서 폴더 (또는 특정 문서, 메모리 스페이스) 에 바인딩됐다면 그 그래프가 자동으로 검증기와 리트리벌 스코프에 들어옴.

즉 셋업이 Agent 가 아닌 그래프에서 일어남.

## 일회성 셋업

1. 인과 그래프 열기.
2. **Settings → Connected sources → Add** — 이 그래프가 파생될 문서·폴더·메모리 스페이스 선택.
3. 저장.

그 순간부터 데이터 소스가 그래프의 연결 소스와 겹치는 어느 Agent 든 그래프 사용. Agent 별 토글 불필요.

## 그래프가 쓰이는 곳

두 소비자:

* **검증기 (Verifier)** — 항상 켜짐. 그래프의 승인된 (LIVE) 엣지가 모든 답변의 그라운딩 체크에 접힘.
* **리트리벌** — 그래프의 **dedup 정책** 이 지배 (아래 참고). 검증처럼 자동은 아님.

## Dedup 정책 — 그래프가 리트리벌에 어떻게 나타나나

그래프가 연결된 문서*에서* 파생되므로 원시 청크 *와* 그래프의 사실을 모두 리트리벌하면 정보 중복. 그래프의 dedup 정책이 그것들이 어떻게 섞일지 결정.

| 정책                         | 동작                                                                 |
| -------------------------- | ------------------------------------------------------------------ |
| `reasoning_only`           | 그래프가 리트리벌된 청크에 절대 안 들어감. 검증기 전용. 문서가 증거로 유지.                       |
| **`dedup_by_source`** (기본) | 소스 문서가 이미 청크로 리트리벌됐으면 그래프 사실 드롭. 문서가 커버 안 하는 사실 (예: 메모리 파생 엣지) 유지. |
| `graph_supersedes`         | 그래프 엣지가 연결된 문서 청크를 **교체**. (거의 안 맞음 — 원시 증거 잃음.)                   |
| `naive_union`              | 둘 다 포함. 베이스라인; 중복 오버헤드 측정에만 유용.                                    |

그래프별 설정: **Graph → Settings → Dedup policy**.

기본 `dedup_by_source` 가 "문서가 주요 증거, 그래프가 위에 인과 로직 추가" 룰과 매치 — 그래프가 리트리벌에서 행동해야 하는 방식.

## 그래프의 역할이 실제로 무엇인가

* **검증기** 의 주요 소비자 — 승인된 엣지를 항상 접어 사실 클레임 체크.
* 리트리벌의 **보조 로직** — 리트리벌이 이미 찾은 청크를 중복하지 않고 문서만으로 진술 안 되는 인과 엣지 공급.

"그래프를 Agent 에 붙임" 에 익숙하다면 재구성: **소스** 를 Agent (또는 그래프 — 어느 방향이든 동작) 에 붙이고, 그것들 사이 연결이 그래프를 자동 배선.

## 여러 그래프

Agent 가 여러 그래프 참조하게 될 수 있음 — 겹치는 연결 소스 세트당 하나. 각 그래프의 dedup 정책이 자체 기여에 독립 적용.

## CLI 에서 설정

```bash theme={null}
# 이 그래프가 연결된 소스 설정
nora causal settings set billing \
  --connection documents_folder:billing \
  --retrieval-preset high-precision \
  --dedup-policy dedup_by_source
```

전체 명령 표면은 [`nora causal`](/ko/cli/causal) 참고.

## 레거시 명시적 바인딩

하위 호환용으로 명시적 `causal_graph` 데이터 소스 바인딩이 여전히 동작 — 옛 스타일 인과-그래프 붙임 있는 Agent 가 이전 경로로 short-circuit. 새 Flow 는 연결된 소스 모델 사용.

## 다음 단계

<CardGroup cols={2}>
  <Card title="에이전트 답변 검증" icon="shield-check" href="/ko/build/causal-graph/verification">
    검증기가 그래프 쓰는 방법 — 항상 켜짐.
  </Card>

  <Card title="그라운딩 (리트리벌)" icon="anchor" href="/ko/build/retrieval/grounding">
    리트리벌이 그래프 쓰는 방법 — dedup 정책 통해.
  </Card>
</CardGroup>
