mirror of
https://github.com/crewAIInc/crewAI.git
synced 2026-07-01 21:28:10 +00:00
2148c7ed77
- Adds an <Info> "ACP (Beta) Docs Navigation" block at the top of every Agent Control Plane page so readers can jump between Overview, Monitoring, and Rules without scrolling to the bottom-of-page Related cards.
123 lines
6.9 KiB
Plaintext
123 lines
6.9 KiB
Plaintext
---
|
|
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>
|
|
|
|
</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>
|
|
|
|
</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>
|