> ## 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 단위라, 같은 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와 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가 드라이 리트리벌을 돌려, 어느 소스에서 어떤 청크가 모델에 건네질지 그대로 보여줍니다. 배포 전 접근을 확인하기 좋습니다.