starfort-guard
텍스트 하나를 Starfort Guard API로 검사하여 판정, 마스킹된 내용, 탐지 항목을 출력합니다.
starfort-guard [profile=값] [role=값] text=값
- profile=값
- 선택. Starfort 접속 프로파일 식별자. 사용할 수 있는 프로파일이 여러 개이면 지정해야 합니다
- role=값
- 선택. 메시지 역할: system, user, assistant. 미지정 시 user
- text=값
- 필수. 검사할 텍스트
출력 필드
| 필드 | 타입 | 이름 | 설명 |
|---|---|---|---|
| profile | 문자열 | 접속 프로파일 | 사용한 Starfort 접속 프로파일 식별자. 예: starfort |
| text | 문자열 | 텍스트 | 검사한 텍스트. 예: 제 휴대폰 번호는 010-1234-5678 입니다. |
| 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] |