액션: PASS / MASK / BLOCK

Guardian이 콘텐츠를 평가할 때마다 액션을 반환합니다. PII 정책은 PASS / MASK / BLOCK을 사용하고, Topic 판정은 2가지 상태입니다 — PASS 또는 BLOCK.

PASS

매칭된 규칙이 없습니다(또는 PASSING 규칙만 매칭됨). 콘텐츠가 계속 진행됩니다 — 전달되는 것은 Guardian이 확인·재구성한 처리본입니다.

MASK

(PII 전용) 민감한 부분이 마스크 토큰으로 대체됩니다. Guardian은 마스킹된 콘텐츠를 반환합니다.

BLOCK

차단 규칙 또는 unsafe 주제가 매칭되었습니다. 요청이 중단되며 아무것도 전달되지 않습니다.

전체 액션은 가장 높은 심각도입니다

응답에는 루트 action과 항목별 세부 내역이 있습니다. 루트 액션은 PII와 Topic 결과를 결합하여 탐지된 모든 항목 중 가장 심각한 액션입니다: BLOCK > MASK > PASS. 따라서 다른 부분이 마스킹만 되더라도, 단 하나의 차단 매칭이 있으면 전체 요청이 BLOCK이 됩니다.

외부로 나가는 것은 처리본입니다

v1.4부터 외부 AI 서비스로 실제 나가는 콘텐츠는 caller가 제출한 원본이 아니라, Guardian이 파싱·정규화(필요 시 OCR·디코드)로 내용을 실제 확인한 뒤 재구성한 처리본(processed_content)으로 통일됩니다. 원본에는 Guardian이 확인하지 못한 부분이 남아 있을 수 있으므로, 처리본만 내보내 “우리가 보지 못한 것”이 그대로 흘러나가는 경로를 닫습니다.

판정	egress 콘텐츠
PASS	처리본 — 마스킹 대상이 없어 내용이 원문과 같더라도, 전달되는 것은 Guardian이 재구성한 처리본입니다. 원본이 직접 나가지 않습니다
MASK	마스킹된 처리본(기존과 동일)
BLOCK	전달 없음 — egress 자체가 발생하지 않습니다

이 원칙은 세 caller(API · Desktop Agent · Proxy Server)에 동일하게 적용됩니다. API 응답은 판정과 무관하게 각 입력의 processed_content에 처리본을 담으며, PASS여도 비우지 않습니다. 미지원 파일이나 파싱·디코드에 실패한 입력처럼 처리본을 만들 수 없는 입력은 내보낼 대상이 없으므로 전달되지 않습니다(null) — 확인하지 못한 원본은 외부로 나가지 않습니다.

실제 모습 (실제 응답)

MASK — PII가 매칭되어 대체되었습니다. processed_content에 마스킹된 텍스트가 담깁니다. 마스크 토큰은 [<MASK_WORD>_<n>] 형식을 따르며, 카테고리별로 번호가 매겨집니다(1부터 시작, 문서 순서대로, 그리고 값에 안정적입니다 — 동일한 원본 값은 동일한 번호를 받으므로 서로 다른 두 이름은 [PERSON_NAME_1]과 [PERSON_NAME_2]가 됩니다). 각 토큰 뒤의 원본은 matched_text로 노출되며, 이는 unmaskOutput이 복원할 때 사용하는 값입니다.

{
  "action": "MASK",
  "input_results": [{
    "index": 0, "type": "text", "action": "MASK",
    "processed_content": "제 번호는 [PHONE_NUMBER_1] 이고 이메일은 [EMAIL_1] 입니다.",
    "results": [{
      "policy_name": "PII Masking Policy", "policy_type": "PII", "action": "MASK",
      "detected_items": [
        { "rule_type": "regex", "rule_name": "phone_number", "mask_word": "PHONE_NUMBER_1", "matched_text": "010-2543-2513" },
        { "rule_type": "regex", "rule_name": "email", "mask_word": "EMAIL_1", "matched_text": "jane@acme.co.kr" }
      ]
    }]
  }]
}

BLOCK — unsafe Topic이 매칭되었습니다. processed_content는 null입니다.

{
  "action": "BLOCK",
  "input_results": [{
    "index": 0, "type": "text", "action": "BLOCK", "processed_content": null,
    "results": [{
      "policy_name": "Topic Policy", "policy_type": "TOPIC", "action": "BLOCK",
      "detected_items": [{ "rule_id": "WPN", "rule_name": "무기", "action": "BLOCK", "confidence": 0.91 }]
    }]
  }]
}

전체 필드 레퍼런스(PII와 Topic의 detected_items)는 응답 형식을 참고하세요.

액션을 확인할 수 있는 위치

API 개발자는 Guard API 응답에서 action을 읽습니다.
Account Admin은 Opticon 모니터링에서 모든 액션을 PASS / MASK / BLOCK 태그가 붙은 트레이스로 확인합니다.
Desktop Agent 사용자는 AI 도구를 사용하면서 MASK/BLOCK을 투명하게 경험합니다.

PASS

MASK

BLOCK

​전체 액션은 가장 높은 심각도입니다

​외부로 나가는 것은 처리본입니다

​실제 모습 (실제 응답)

​액션을 확인할 수 있는 위치

전체 액션은 가장 높은 심각도입니다

외부로 나가는 것은 처리본입니다

실제 모습 (실제 응답)

액션을 확인할 수 있는 위치