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

# 그래프가 Agent에 연결되는 방식

> Agent가 이미 쓰는 데이터 소스에서 그래프가 자동으로 참조됩니다. 따로 붙이는 단계가 없습니다

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

즉 설정은 Agent가 아니라 그래프 쪽에서 합니다.

## 한 번만 하는 설정

**폴더에서(From a folder)** 부트스트랩한 그래프는 처음부터 그 폴더에 연결돼 있습니다. 더 할 게 없습니다. 그 밖의 그래프는 CLI로 연결을 지정합니다([`nora causal`](/ko/cli/causal) 참고).

그때부터 데이터 소스가 그래프의 연결 소스와 겹치는 Agent는 모두 그 그래프를 씁니다. Agent마다 켤 필요가 없습니다.

## 그래프가 쓰이는 곳

소비자가 둘입니다.

* **검증기(Verifier)** 늘 켜집니다. 그래프의 승인된(LIVE) 엣지가 모든 답의 그라운딩 점검에 접혀 들어갑니다.
* **리트리벌** 그래프의 [dedup 정책](#dedup-정책)이 정합니다. 검증처럼 자동은 아닙니다.

## Dedup 정책

그래프가 연결된 문서*에서* 딸려 나오므로, 원시 청크*와* 그래프의 사실을 둘 다 리트리벌하면 정보가 겹칩니다. 그래프의 dedup 정책이 둘을 어떻게 섞을지 정합니다.

| 정책                        | 동작                                                                    |
| ------------------------- | --------------------------------------------------------------------- |
| `reasoning_only`          | 그래프가 리트리벌한 청크에 절대 안 들어갑니다. 검증기 전용입니다. 문서가 증거로 남습니다.                   |
| **`dedup_by_source`**(기본) | 소스 문서가 이미 청크로 리트리벌됐으면 그래프 사실을 뺍니다. 문서가 안 덮는 사실(예: 메모리에서 나온 엣지)은 남깁니다. |
| `graph_supersedes`        | 그래프 엣지가 연결된 문서 청크를 **대체**합니다. 문서 원문이 컨텍스트에서 빠지므로 대부분의 경우 권장하지 않습니다.   |
| `naive_union`             | 둘 다 넣습니다. 베이스라인입니다. 중복 오버헤드를 재는 데만 씁니다.                               |

그래프마다 CLI로 정합니다([`nora causal`](/ko/cli/causal) 참고).

기본값 `dedup_by_source`가 "문서가 주된 증거, 그래프가 그 위에 인과 로직을 더함"이라는 룰과 맞습니다. 그래프가 리트리벌에서 마땅히 이렇게 굴어야 합니다.

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

* **검증기**의 주된 소비자입니다. 승인된 엣지를 늘 접어 사실 주장을 점검합니다.
* 리트리벌의 **보조 로직**입니다. 리트리벌이 이미 찾은 청크를 겹치지 않고, 문서만으로는 안 나오는 인과 엣지를 보탭니다.

"그래프를 Agent에 붙임"에 익숙하다면 이렇게 바꿔 생각하세요. **소스**를 Agent(또는 그래프. 어느 쪽이든 됩니다)에 붙이면, 그 사이 연결이 그래프를 자동으로 이어 줍니다.

## 여러 그래프

Agent가 그래프를 여럿 참조할 수 있습니다. 겹치는 연결 소스 묶음마다 하나씩요. 각 그래프의 dedup 정책이 자기 기여에 따로 적용됩니다.

## 예전 방식의 명시적 바인딩

하위 호환을 위해 명시적 `causal_graph` 데이터 소스 바인딩도 여전히 됩니다. 예전 방식으로 인과 그래프를 붙인 Agent는 이전 경로로 바로 갑니다. 새 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>
