> ## 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 에게 정확히 필요한 지식만 접근권 부여 — 더도 덜도 아님.

지식은 **붙이기** 전까지 Agent 에 도달하지 않습니다. 붙이기는 Agent 별이므로, 같은 Flow 안의 다른 Agent 들이 완전히 다른 지식 접근을 가질 수 있습니다.

## 데이터 소스 붙이기

1. Flow 에서 Agent 블록 열기.
2. 인스펙터 → **Data sources → Add**.
3. 선택:
   * 전체 **문서 컬렉션**.
   * 컬렉션 안 특정 **폴더**.
   * **태그 필터 슬라이스** (예: "billing 컬렉션에서 audience:customer").
4. 저장.

Agent 는 다음 실행부터 그 슬라이스에 리트리벌 접근권을 즉시 가짐.

## 메모리 스페이스 붙이기

같은 모양, 다른 타입. [메모리 스페이스](/ko/build/memory/spaces) 참고.

## 여러 붙임

Agent 는 여러 붙임을 가질 수 있음. 리트리벌은 모두에 대해 실행되고 랭크된 결과를 병합. 각 붙임의 **weight** 로 소스별 부스트/강등.

예:

* `official-docs` (weight 1.0) — 정본 답변.
* `community-answers` (weight 0.6) — 공식이 침묵할 때 백업.
* `internal-runbooks` (weight 1.2) — 관련 있으면 내부 선호.

## Attach vs. include

미묘하게 다른 두 모드:

* **Attach** — 리트리벌 전용. 청크가 추론 시점에 끌어와 Agent 컨텍스트에 섞임. 기본.
* **Include in prompt** — 소스가 리트리벌 없이 매 턴 프롬프트에 *항상* 포함. 매우 작고 항상 관련 있는 소스에만 (한 페이지 정책, 용어집). 매 호출에 토큰 소비.

대부분 소스는 include 아닌 attach 여야 함.

## 접근 통제

Agent 는 워크스페이스 멤버가 접근권을 가진 지식만 붙일 수 있음. 나중에 팀원이 편집하는 Agent 에 제한된 컬렉션을 붙였다면, 그들은 붙임은 보지만 콘텐츠를 검사할 수 없다는 경고를 봄. 리트리벌은 여전히 동작 (Agent 가 읽을 수 있음) — 편집기에서 소스를 볼 수 없을 뿐.

## 붙임별 필터

모든 붙임은 소스 자체 필터 위에 실행되는 추가 필터를 가질 수 있음. 컬렉션을 붙이되 이 Agent 에는 하위집합만 원할 때 유용:

```json theme={null}
{ "tag": "customer-facing", "language": "{vars.USER_LANG}" }
```

필터는 Flow 변수를 참조 가능 — 그래서 Agent 가 테넌트·사용자·세션 컨텍스트로 동적 스코프 가능.

## 붙임 제거

인스펙터 → Data source → **Detach**. 컬렉션 자체는 건드리지 않고 Agent 의 링크만. 언제든 재붙임.

## Agent 가 볼 수 있는 것 테스트

Agent 인스펙터는 **Ask a test question** 패널을 가짐. 질문 입력, Nora 가 드라이 리트리벌 실행 — 어느 소스에서 어떤 청크가 모델에 건네질지 정확히 표시. 배포 전 접근 검증에 좋음.