응답 포맷

Top-Level 필드

Field	Type	설명
`guardian`	`string`	판정을 수행한 Guardian 이름.
`action`	`string`	최종 Action: `PASS`, `MASK`, `BLOCK`.
`processed_content`	`string \| null`	MASK 시 마스킹 텍스트, PASS 시 원본, BLOCK 시 `null`.
`results`	`object`	Policy type별 요약. key가 policy type (`PII`, `TOPIC`, …).
`processing_time_ms`	`integer`	전체 처리 지연 시간.

`results.{type}`

Field	Type	설명
`action`	`string`	해당 Policy type의 판정: `PASS`, `MASK`, `BLOCK`.
`detected_count`	`integer`	규칙 매칭 수.
`detected_items`	`array`	매칭 상세 (아래 참고).

`results.PII.detected_items`

Field	설명
`rule_name`	매칭된 규칙 이름.
`action`	규칙의 Action (`PASS` / `MASK` / `BLOCK`).
`alert_message`	규칙의 알림 메시지.

`results.TOPIC.detected_items`

Field	설명
`rule_name`	매칭된 토픽 카테고리 제목.
`action`	`PASS` 또는 `BLOCK`.
`classification`	`safe`, `unsafe`, `controversial`.

응답 예시

PASS
MASK
BLOCK

{
  "guardian": "텍스트 분석 Guardian",
  "action": "PASS",
  "processed_content": "오늘 점심 메뉴 추천해줘.",
  "results": {
    "PII":   { "action": "PASS", "detected_count": 0, "detected_items": [] },
    "TOPIC": { "action": "PASS", "detected_count": 0, "detected_items": [] }
  },
  "processing_time_ms": 156
}

{
  "guardian": "텍스트 분석 Guardian",
  "action": "MASK",
  "processed_content": "[PERSON_NAME]의 주민번호는 [RESIDENT_NUMBER]입니다.",
  "results": {
    "PII": {
      "action": "MASK",
      "detected_count": 2,
      "detected_items": [
        { "rule_name": "person name (Korea)", "action": "MASK", "alert_message": "person name detected" },
        { "rule_name": "resident_number:_all_gender_with_separators", "action": "MASK", "alert_message": "resident number detected" }
      ]
    }
  },
  "processing_time_ms": 98
}

{
  "guardian": "텍스트 분석 Guardian",
  "action": "BLOCK",
  "processed_content": null,
  "results": {
    "PII": {
      "action": "BLOCK",
      "detected_count": 1,
      "detected_items": [
        { "rule_name": "HBM4", "action": "BLOCK", "alert_message": "Unreleased Project Name (HBM4) Detected" }
      ]
    }
  },
  "processing_time_ms": 342
}

PASS / MASK / BLOCK

여러 Policy 유형이 섞인 요청에서 최종 Action이 결정되는 방식.

개발자 가이드

Top-Level 필드

`results.{type}`

`results.PII.detected_items`

`results.TOPIC.detected_items`

응답 예시

관련 문서

PASS / MASK / BLOCK

개발자 가이드

​Top-Level 필드

​results.{type}

​results.PII.detected_items

​results.TOPIC.detected_items

​응답 예시

​관련 문서

PASS / MASK / BLOCK

Top-Level 필드

`results.{type}`

`results.PII.detected_items`

`results.TOPIC.detected_items`

응답 예시

관련 문서