메인 콘텐츠로 건너뛰기
Guardian이 콘텐츠를 평가할 때마다 액션을 반환합니다. 중간 상태는 정책 유형에 따라 다릅니다. PII 정책은 PASS / MASK / BLOCK을 사용하고, Topic 정책은 PASS / CHECK / BLOCK을 사용합니다.

PASS

매칭된 규칙이 없습니다(또는 PASSING 규칙만 매칭됨). 콘텐츠가 변경 없이 계속 진행됩니다.

MASK

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

CHECK

(Topic 전용) controversial 주제가 매칭되었습니다 — 검토가 필요한 것으로 표시됩니다. Desktop Agent와 Proxy Server에서는 CHECK가 PASS로 집행됩니다(콘텐츠가 통과하며 트레이스에만 기록됨). API 호출자는 CHECK를 직접 받습니다.

BLOCK

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

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

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

​
실제 모습 (실제 응답)

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 / CHECK / BLOCK 태그가 붙은 트레이스로 확인합니다(트레이스 태그는 PASS로 집행된 경우에도 CHECK를 유지합니다).
  • Desktop Agent 사용자는 AI 도구를 사용하면서 MASK/BLOCK을 투명하게 경험합니다.