starfort-guard-batch
입력 레코드마다 text 필드를 Starfort Guard API로 검사하여 판정, 마스킹된 내용, 탐지 항목을 추가합니다.
starfort-guard-batch [profile=값] [role=값]
- profile=값
- 선택. Starfort 접속 프로파일 식별자. 사용할 수 있는 프로파일이 여러 개이면 지정해야 합니다
- role=값
- 선택. 메시지 역할: system, user, assistant. 미지정 시 user
출력 필드
| 필드 | 타입 | 이름 | 설명 |
|---|---|---|---|
| action | 문자열 | 판정 | PASS, MASK, BLOCK 중 하나. 판정을 받지 못하면 null. 예: MASK |
| processed_content | 문자열 | 마스킹된 내용 | MASK 판정일 때의 processed_content. 예: 제 휴대폰 번호는 010-****-5678 입니다. |
| detected_items | 목록 | 탐지 항목 | policy_name, rule_name, mask_word, matched_text, alert_message, action을 담은 detected_items 목록 |
| mask_mappings | 목록 | 마스킹 대응 | seq, original_text, masked_text, mask_word, mode를 담은 mask_mappings 목록 |
| request_id | 문자열 | 요청 ID | X-Request-ID 응답 헤더. 예: 7eced4e9-3bc4-44ea-965b-5a5ab5155850 |
| http_status | 32비트 정수 | HTTP 상태 | 검사 호출의 HTTP 상태 코드. 예: 200 |
| latency_ms | 64비트 정수 | 지연 시간 | 검사 호출 지연 시간(밀리초). 예: 120 |
| error | 문자열 | 오류 | 판정을 받지 못한 경우의 오류 코드와 메시지이며, 이때 action은 null입니다. 예: 217411: Starfort가 API 키를 거부했습니다(HTTP 401). [API_KEY_INVALID] |