Starfort

가드레일 테스트 화면은 입력한 메시지를 Starfort Guard API로 그대로 보내고, 받은 응답을 HTTP 상태, X-Request-ID와 함께 보여 줍니다. AI 에이전트에 가드레일을 적용하기 전에 판정이 어떻게 나오는지 확인하거나, 접속 문제를 진단할 때 사용합니다.

검사 요청

왼쪽 패널에서 요청을 구성합니다.

• 접속 프로파일 - 검사에 사용할 AIM Starfort 접속 프로파일입니다. 사용 권한이 있는 프로파일만 표시됩니다

• 메시지 - 검사할 메시지 목록입니다. 메시지마다 역할(system, user, assistant)과 내용을 입력합니다. 메시지 추가로 여러 메시지를 한 번에 보낼 수 있으며, 응답에는 메시지마다 결과가 따로 표시됩니다

• 예시 - 버튼을 클릭하면 메시지가 예시로 바뀝니다

  버튼	예상 판정
  휴대폰 번호 (MASK)	MASK
  이메일 (MASK)	MASK
  테스트 번호 (PASS)	PASS

• 추가 옵션 - 펼치면 요청의 부가 값을 지정할 수 있습니다

  항목	설명
  process_type	기본값 input. Starfort의 개인정보 탐지 정책은 input에만 적용됩니다
  x-trace-id	호출을 구분할 추적 값입니다. Starfort 호출 기록을 찾을 때 사용합니다
  opticon.session_id / user_id / tags	호출 기록에 붙일 정보입니다. 태그는 쉼표로 구분합니다

검사 요청을 클릭하면 요청을 보냅니다.

응답

오른쪽 패널에 응답이 표시됩니다.

• HTTP 상태, X-Request-ID, 지연 시간 - Starfort에 문의할 때는 X-Request-ID를 함께 전달하십시오
• 판정 - PASS(초록), MASK(주황), BLOCK(빨강) 배지와 판정별 처리 방법이 표시됩니다
• 원문과 processed_content - 메시지마다 원문과 마스킹된 내용을 나란히 표시합니다
• 탐지 항목 (detected_items) - 걸린 규칙(rule_name), 분류와 순번(mask_word), 원문(matched_text), 설명(alert_message)
• 마스킹 대응 (mask_mappings) - 원문(original_text)과 바뀐 값(masked_text)의 대응
• 요청 본문 / 응답 본문 (JSON) - 실제로 주고받은 JSON입니다. 펼쳐서 확인합니다

오류

판정을 받지 못하면 오류 코드, Starfort의 error.code, error.message, error.details와 함께 조치 방법이 표시됩니다.

HTTP 상태	의미	조치
400	요청 형식 오류	error.details를 보고 요청을 수정합니다
401	API 키가 없거나 잘못됨, 사용 중지됨	접속 프로파일의 API 키를 확인합니다
403	접근 제한	AIM Intelligence에 문의합니다
422	검사 엔진이 받지 않는 요청	입력을 줄이거나 형식을 수정합니다
5xx	검사 엔진이 판정을 내지 못함	잠시 후 다시 시도하고, 계속되면 문의합니다

접속 프로파일 단계의 오류 코드(217400~217421)는 설치 매뉴얼의 문제 해결 표를 참고하십시오.