가드레일
이 페이지의 내용
Guardrails는 AI 요청이 모델에 도달하기 전에 콘텐츠 보호를 적용합니다. Settings(톱니바퀴) → Guardrails에서 시설 전체에 대해 구성하며, 개별 API 키와 연결된 서비스에서 재정의할 수 있습니다.
"이 시설의 모든 요청에 콘텐츠 보호를 적용합니다. 기본적으로 활성화된 항목은 없습니다. 개별 키로 이를 재정의할 수 있습니다."


그림 1: Guardrails: 템플릿 및 PII masking


그림 2: Secret redaction 및 프롬프트 인젝션 차단
기본 제공 가드레일
| 가드레일 | 기능 |
|---|---|
| PII masking | "Detect and mask personal data (names, emails, phone numbers, etc.) before prompts reach the model." |
| Secret redaction | "Strip API keys, tokens and other secrets out of prompts before they are sent upstream." |
| Prompt-injection shield | "Block common prompt-injection / jailbreak attempts (e.g. "ignore previous instructions", "developer mode") before they reach the model." |
PII masking과 Secret redaction은 프롬프트를 다시 작성합니다(민감한 부분이 마스킹된 상태로 요청은 계속 진행됨). Prompt-injection shield는 일치하는 요청을 content policy violation 오류(HTTP 403)로 즉시 차단합니다.
템플릿
Templates 행을 사용하면 클릭 한 번으로 사전 설정된 선택 항목을 적용한 다음 Save changes를 누를 수 있습니다.
| 템플릿 | 선택 항목 |
|---|---|
| None | 가드레일 없음(기본값). |
| PII protection | PII masking. |
| Secret redaction | Secret redaction. |
| Injection shield | Prompt-injection shield. |
| Strict | 세 가지 모두. |
저장하면 *"Guardrail settings saved."*가 표시됩니다.
콘텐츠 필터
가드레일 아래의 Content filters를 사용하면 프롬프트 내용에 대해 평가되는 사용자 지정 정규식 규칙을 직접 추가할 수 있습니다. Redact는 일치 항목을 [REDACTED]로 바꾸고, Block은 요청을 거부합니다. 개별 키에서 재정의할 수 있습니다.
Add filter를 클릭한 다음 다음 항목을 설정합니다.
| 필드 | 동작 |
|---|---|
| Pattern | 정규식입니다("Regular expression, e.g. \b\d{16}\b" — 이 예는 16자리 카드 번호와 일치합니다). 안전하지 않거나 너무 긴 패턴은 삭제되어 적용되지 않습니다. 패턴은 최대 300자이며, 시설당 최대 25개의 필터를 둘 수 있습니다. 대소문자를 구분하지 않고 일치시키며, 각 메시지의 처음 20,000자만 검사합니다. |
| Action | Redact: 일치 항목을 [REDACTED]로 바꾸고 요청을 계속 진행합니다. Block: content policy violation 오류로 요청을 거부합니다. |
필터를 삭제하려면 Remove를 사용한 다음 Save changes를 누릅니다. 구성된 필터가 없으면 *"No content filters. Add one to redact or block matching prompt text."*가 표시됩니다.
키별 및 서비스별 재정의
각 API 키와 각 연결된 서비스의 구성 창에는 Override facility guardrails 토글이 있습니다.
- 끄기(기본값): 키나 서비스가 시설의 가드레일 및 콘텐츠 필터 선택을 상속합니다.
- 켜기: 키나 서비스가 대신 자체 선택을 사용합니다. "Select none to explicitly disable guardrails for this key." 이 방법으로 신뢰할 수 있는 통합 하나를 시설 전체 마스킹에서 제외하거나, 특정 키에 더 엄격한 규칙을 적용할 수 있습니다.
API 키 및 Connected Services를 참조하십시오.
호출자에게 표시되는 내용
- 삭제는 알림 없이 처리됩니다. 모델은 일치한 텍스트 대신
[REDACTED](또는 마스킹된 PII/비밀 정보)를 받을 뿐입니다. - 차단 시 HTTP 403을 반환합니다. 메시지는 *"Request blocked by content policy"*이고 코드는
content_policy_violation입니다. 애플리케이션 연결의 오류 표를 참조하십시오.
프롬프트 내용은 전송 중에만 검사되며, 가드레일은 검사한 내용을 절대 저장하지 않습니다.