---
title: "규칙 설정하기"
description: "한 곳에서 조직 단위 정책을 여러 자동화에 적용합니다."
sidebarTitle: "규칙"
icon: "shield-check"
mode: "wide"
---

<Info>
  **ACP (베타) 문서 내비게이션**

  - [개요](/ko/enterprise/features/agent-control-plane/overview)
  - [모니터링](/ko/enterprise/features/agent-control-plane/monitoring)
  - **규칙** *(현재 페이지)*
</Info>

## 개요

규칙(Rules)은 각 deployment를 개별 설정하는 대신, 정책 — 현재: **PII Redaction** — 을 한 번에 여러 자동화에 적용할 수 있게 해줍니다. 관리하려면 [Agent Control Plane](/ko/enterprise/features/agent-control-plane/overview)에서 **Rules** 탭을 엽니다.

<Frame>
  ![규칙 목록](/images/enterprise/acp-rules-list.png)
</Frame>

각 규칙 카드에는 이름, 설명, 규칙이 적용되는 **범위(scope)**(선택된 도구와 태그), 그리고 현재 범위와 일치하는 deployment의 수인 **engaged automations**가 표시됩니다. 오른쪽 토글로 규칙을 삭제하지 않고 활성/비활성할 수 있습니다.

## 요구사항

<Warning>
  PII Redaction 규칙을 생성하거나 편집하려면 **Enterprise 또는 Ultra 플랜**이 필요합니다. 하위 플랜의 조직도 Rules 탭을 열고 기존 규칙을 볼 수는 있지만, 편집기는 "Enterprise" 잠금 핀과 *"PII Redaction rules require an Enterprise plan."* 경고와 함께 읽기 전용으로 렌더링됩니다. 업그레이드하려면 계정 오너 또는 영업팀에 문의하세요.
</Warning>

- **Agent Control Plane** 기능이 조직에 대해 활성화되어 있어야 합니다. [개요 — 요구사항](/ko/enterprise/features/agent-control-plane/overview#요구사항)을 참고하세요.
- 규칙을 생성·편집·토글·삭제하려면 Agent Control Plane에 대한 [RBAC](/ko/enterprise/features/rbac)의 `manage` 권한이 필요합니다. 보려면 `read` 권한만으로 충분합니다.
- 모든 규칙 변경은 감사를 위해 버전 관리됩니다.

## 사용 가능한 규칙 유형

| 유형 | 동작 |
|------|---------------|
| **PII Redaction** | 일치하는 모든 자동화의 실행에 PII redaction을 적용합니다. [Traces용 PII Redaction](/ko/enterprise/features/pii-trace-redactions)에 문서화된 동일한 엔티티 카탈로그와 커스텀 recognizer를 사용합니다. |

향후 더 많은 규칙 유형이 추가될 예정입니다.

## 규칙 만들기

<Frame>
  <img src="/images/enterprise/acp-rules-edit-side-panel.png" alt="조건 및 PII 마스크 유형이 있는 규칙 편집 사이드 패널" width="450" />
</Frame>

<Steps>
  <Step title="편집기 열기">
    Rules 탭 오른쪽 상단의 **+ Create new**를 클릭하거나, 기존 규칙 카드의 **View Details**를 클릭합니다.
  </Step>

  <Step title="규칙 이름과 설명 작성">
    규칙에 명확한 이름(예: *Mask PII (CC)*)과 적용 시점을 설명하는 description을 부여합니다. 둘 다 규칙 카드와 Engaged Automations 모달에 표시됩니다.
  </Step>

  <Step title="유형 선택">
    현재 **PII Redaction**만 사용할 수 있습니다.
  </Step>

  <Step title="조건 설정">
    조건은 규칙이 어떤 자동화에 engage 할지 결정합니다. 둘 다 선택 사항이며 **집합 동일성(set-equality)** 의미론을 사용합니다:

    - **Tools** — 도구 집합이 선택된 도구와 **정확히 일치**하는 자동화만 engage 됩니다. Studio 앱, MCP, OSS 도구, Tool Repository registry 도구 중에서 선택합니다.
    - **Automations** — 태그 집합이 선택된 태그와 **정확히 일치**하는 자동화만 engage 됩니다.

    피커를 비워두면 "이 차원에서 필터링하지 않음"을 의미합니다. 두 피커를 모두 비워두면 규칙이 조직의 **모든** 자동화에 적용됩니다.
  </Step>

  <Step title="PII Mask Type 테이블 구성">
    적용할 각 엔티티 유형을 체크하고 **Mask**(엔티티 레이블로 치환, 예: `<CREDIT_CARD>`) 또는 **Redact**(일치하는 텍스트를 완전히 제거) 중에서 선택합니다. 전체 엔티티 카탈로그와 조직 단위 커스텀 recognizer 추가 방법은 [Traces용 PII Redaction](/ko/enterprise/features/pii-trace-redactions)을 참고하세요.
  </Step>

  <Step title="저장">
    저장하는 즉시 engage 된 모든 자동화의 **향후** 실행에 규칙이 적용됩니다. 재배포는 필요 없습니다.
  </Step>
</Steps>

## Engaged automations

규칙 카드의 **Engaged N automations**를 클릭하면 현재 규칙이 일치시키고 있는 deployment와 각 deployment의 마지막 실행을 정확히 확인할 수 있습니다.

<Frame>
  ![Engaged automations 모달](/images/enterprise/acp-rules-engaged-modal.png)
</Frame>

규칙을 활성화하기 전에 범위를 빠르게 점검하는 가장 좋은 방법입니다. 예를 들어, `production` 태그로 범위를 지정한 규칙이 의도치 않게 staging deployment를 일치시키지 않는지 확인할 수 있습니다.

## 조직 단위 규칙 vs deployment 단위 설정

PII Redaction은 두 곳에서 설정할 수 있습니다:

- **deployment 단위** — 각 deployment의 **Settings → PII Protection** ([가이드](/ko/enterprise/features/pii-trace-redactions))
- **조직 단위** — 이 페이지의 규칙

활성화된 조직 단위 규칙의 범위가 어떤 deployment와 일치하면, 규칙의 엔티티 구성이 그 deployment의 실행에 대해 **deployment가 소유한 PII 설정을 덮어씁니다**. 규칙이 연결된 동안에는 규칙이 단일 진실 공급원이 됩니다. 규칙을 비활성화하거나 분리하면(또는 범위를 변경하여 더 이상 일치하지 않게 만들면) deployment는 자체 PII Protection 설정으로 되돌아갑니다.

여러 deployment에 걸쳐 일관된 정책을 강제하고 싶을 때는 조직 단위 규칙을 선호하고, 일회성 예외에 대해서는 deployment 단위 설정을 사용하세요.

## 관련 문서

<CardGroup cols={2}>
  <Card title="Agent Control Plane — 개요" icon="book-open" href="/ko/enterprise/features/agent-control-plane/overview">
    ACP란 무엇이며, 요구사항, 플랜 등급, RBAC에 대해.
  </Card>
  <Card title="Agent Control Plane — 모니터링" icon="gauge" href="/ko/enterprise/features/agent-control-plane/monitoring">
    플릿 전반의 자동화와 LLM 소비를 모니터링합니다.
  </Card>
  <Card title="Traces용 PII Redaction" icon="lock" href="/ko/enterprise/features/pii-trace-redactions">
    엔티티 카탈로그, 커스텀 recognizer, deployment 단위 구성.
  </Card>
  <Card title="RBAC" icon="users" href="/ko/enterprise/features/rbac">
    누가 규칙을 만들거나 편집할 수 있는지 관리합니다.
  </Card>
</CardGroup>

<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
  조직의 규칙을 설계하는 데 도움이 필요하시면 지원 팀에 문의하세요.
</Card>
