> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloosphere.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 가드레일

> 전역 가드레일과 파일 업로드 보안 검사를 설정하여 모든 채팅·에이전트에 일괄 적용합니다.

<Info>관리자 › 설정 › 가드레일</Info>

**전역 가드레일**은 개별 에이전트의 가드레일 설정과 무관하게 **모든 채팅과 에이전트에 일괄 적용**되는 안전장치입니다.

* 조직 전체에 최소한의 입출력 검증 기준을 강제할 때 사용합니다.

<Frame caption="관리자 > 설정 > 가드레일 — 전역 가드레일 · 파일 업로드 검사">
  <img src="https://mintcdn.com/cloocus/3CYTE_uN2N3A4joq/images/admin/settings-guardrails.png?fit=max&auto=format&n=3CYTE_uN2N3A4joq&q=85&s=6ca60c466e1d2d86f6a5914add0fe151" alt="가드레일 설정" width="2880" height="1800" data-path="images/admin/settings-guardrails.png" />
</Frame>

<Note>
  이 탭은 [라이선스](/ko/admin/settings/license) 기능 키에 따라 노출이 달라집니다. 탭 자체는 `file_guardrail`, **전역 가드레일** 구획은 `global_guardrail` 모듈이 있어야 표시됩니다.
</Note>

***

## 전역 가드레일

| 설정 항목       | 설명                                                                    |
| ----------- | --------------------------------------------------------------------- |
| **전역 가드레일** | 전체 ON/OFF 토글. 켜면 모든 채팅·에이전트에 적용됩니다                                    |
| **채팅 가드레일** | 전역으로 적용할 가드레일을 하나 선택합니다. 선택한 가드레일의 PII 감지·금지 단어·LLM Judge가 전역으로 강제됩니다 |

<Note>
  가드레일 자체(검사 규칙)는 [워크스페이스 › 가드레일](/ko/workspace/guardrails)에서 정의합니다. 이 페이지는 그중 어떤 것을 **전역으로 강제**할지 지정하는 곳입니다.
</Note>

***

## 파일 업로드 가드레일

업로드되는 파일에 보안 검사를 적용합니다.

* 토글을 켜면 아래 **적용 범위**와 검사 항목이 펼쳐지고, 파일이 처리되기 **전에** 검사가 실행됩니다.

### 적용 범위

가드레일을 적용할 업로드 경로를 **채팅 · 지식 기반 · 프로젝트** 중에서 고릅니다. 선택 해제한 경로에서는 모든 가드레일 검사를 건너뜁니다.

### 검사 항목

| 검사 항목             | 형태      | 내용                                                           |
| ----------------- | ------- | ------------------------------------------------------------ |
| **텍스트 콘텐츠 가드레일**  | 가드레일 선택 | 추출한 문서 텍스트를 선택한 가드레일로 검사합니다. 위반(PII·민감정보 등)이 감지되면 업로드가 차단됩니다 |
| **EXIF 메타데이터 제거** | 토글      | 업로드 이미지에서 GPS·카메라 정보 등 EXIF 메타데이터를 자동 제거합니다                  |
| **매크로 감지**        | 토글 + 동작 | 문서에 포함된 실행 가능한 매크로를 탐지합니다                                    |
| **NSFW 이미지 감지**   | 토글 + 모델 | LLM으로 부적절한 이미지를 판정합니다                                        |
| **문서 분류**         | 토글 + 모델 | LLM으로 문서 민감도를 분류하고 카테고리별로 처리합니다                              |

<Note>
  **텍스트 콘텐츠 가드레일**·**NSFW 이미지 감지**·**문서 분류**는 모델 또는 가드레일을 지정해야 동작합니다. **EXIF 메타데이터 제거**와 **매크로 감지**는 모델 없이 정적으로 검사합니다.
</Note>

### 매크로 감지

토글을 켜면 **동작**을 고를 수 있습니다.

| 동작      | 결과                 |
| ------- | ------------------ |
| **차단**  | 업로드를 막습니다          |
| **플래그** | 업로드는 허용하되 표시만 남깁니다 |

### NSFW 이미지 감지

| 설정 항목     | 설명                |
| --------- | ----------------- |
| **모델**    | 판정에 사용할 LLM       |
| **프롬프트**  | 판정 기준 프롬프트        |
| **허용 예시** | 통과시킬 이미지 설명 예시 목록 |
| **차단 예시** | 차단할 이미지 설명 예시 목록  |

### 문서 분류

| 설정 항목             | 설명                                                |
| ----------------- | ------------------------------------------------- |
| **모델**            | 분류에 사용할 LLM                                       |
| **최대 문자 수**       | 분류에 넘길 본문 길이 상한                                   |
| **프롬프트**          | 분류 기준 프롬프트                                        |
| **카테고리**          | `ID` · `설명` · **동작**(허용 / 플래그 / 차단)을 카테고리마다 지정합니다 |
| **허용 예시 · 차단 예시** | `샘플 텍스트` + `카테고리` 쌍으로 판정 기준을 보강합니다                |

***

## 가드레일 적용 우선순위

가드레일은 여러 계층에서 설정할 수 있으며, 우선순위로 하나만 적용되는 것이 아니라 **모든 계층의 가드레일이 합산(union)되어 함께 적용**됩니다.

```mermaid theme={null}
flowchart LR
    A[에이전트 가드레일] --> R([모든 계층<br/>합산 적용])
    G[그룹 가드레일] --> R
    O[조직 단위 가드레일] --> R
    E[전역 가드레일] --> R
```

<Info>
  전역 가드레일은 [코드 게이트웨이](/ko/admin/code-gateway)에서도 관리할 수 있습니다. 조직 단위에서 `전역 가드레일 상속`을 끄면 해당 OU는 전역 가드레일의 영향을 받지 않습니다 — [조직 관리](/ko/admin/organizations#조직-단위별-가드레일)를 참고하세요.
</Info>