SanitizationResult

입력 콘텐츠에 모든 필터를 적용한 후의 정리 결과입니다.

JSON 표현 
{
  "filterMatchState": enum (FilterMatchState),
  "filterResults": {
    string: {
      object (FilterResult)
    },
    ...
  },
  "invocationResult": enum (InvocationResult),
  "sanitizationMetadata": {
    object (SanitizationMetadata)
  }
}
필드
filterMatchState

enum (FilterMatchState)

출력 전용입니다. 정리 작업의 전반적인 필터 일치 상태입니다. 상태는 다음 두 값을 가질 수 있습니다.

1) NO_MATCH_FOUND: 구성에 일치 기준을 충족하는 필터가 없습니다. 즉, 입력이 모든 필터를 통과했습니다.

2) MATCH_FOUND: 구성의 필터 중 하나 이상이 일치를 충족합니다. 즉, 입력이 하나 이상의 필터를 통과하지 못했습니다.
filterResults

map (key: string, value: object (FilterResult))

출력 전용입니다. 키가 필터 이름인 모든 필터의 결과입니다('csam', 'malicious_uris', 'rai', 'pi_and_jailbreak' ,'sdp' 중 하나).

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
invocationResult

enum (InvocationResult)

출력 전용입니다. 일치 상태와 관계없이 호출의 결과를 나타내는 필드입니다. 다음 세 가지 값을 가질 수 있습니다. 성공: 모든 필터가 성공적으로 실행되었습니다. PARTIAL: 일부 필터가 건너뛰거나 실행에 실패했습니다. FAILURE: 모든 필터가 건너뛰거나 실행에 실패했습니다.
sanitizationMetadata

object (SanitizationMetadata)

출력 전용입니다. 정리와 관련된 메타데이터입니다.

FilterMatchState

필터 일치 상태를 지정하는 옵션입니다.

열거형
FILTER_MATCH_STATE_UNSPECIFIED 미사용
NO_MATCH_FOUND 필터에 일치 기준이 적용되지 않습니다.
MATCH_FOUND 필터에 일치 기준이 설정됩니다.

FilterResult

정리 작업 후 얻은 필터 결과입니다.

JSON 표현 
{

  // Union field filter_result can be only one of the following:
  "raiFilterResult": {
    object (RaiFilterResult)
  },
  "sdpFilterResult": {
    object (SdpFilterResult)
  },
  "piAndJailbreakFilterResult": {
    object (PiAndJailbreakFilterResult)
  },
  "maliciousUriFilterResult": {
    object (MaliciousUriFilterResult)
  },
  "csamFilterFilterResult": {
    object (CsamFilterResult)
  },
  "virusScanFilterResult": {
    object (VirusScanFilterResult)
  }
  // End of list of possible types for union field filter_result.
}
필드
통합 필드 filter_result. 책임감 있는 AI, 민감한 정보 보호, 프롬프트 삽입 및 탈옥, 악성 URI, 아동 성적 학대 콘텐츠, 바이러스 검사 관련 필터 결과 중 하나를 캡슐화합니다. filter_result은 다음 중 하나여야 합니다.
raiFilterResult

object (RaiFilterResult)

책임감 있는 AI 필터링 결과입니다.
sdpFilterResult

object (SdpFilterResult)

민감한 정보 보호 결과
piAndJailbreakFilterResult

object (PiAndJailbreakFilterResult)

프롬프트 삽입 및 탈옥 필터 결과
maliciousUriFilterResult

object (MaliciousUriFilterResult)

악성 URI 필터 결과
csamFilterFilterResult

object (CsamFilterResult)

아동 성적 학대 콘텐츠 필터링 결과
virusScanFilterResult

object (VirusScanFilterResult)

바이러스 검사 결과

RaiFilterResult

책임감 있는 AI 결과

JSON 표현 
{
  "executionState": enum (FilterExecutionState),
  "messageItems": [
    {
      object (MessageItem)
    }
  ],
  "matchState": enum (FilterMatchState),
  "raiFilterTypeResults": {
    string: {
      object (RaiFilterTypeResult)
    },
    ...
  }
}
필드
executionState

enum (FilterExecutionState)

출력 전용입니다. RAI 필터가 실행되었는지 여부를 보고합니다.
messageItems[]

object (MessageItem)

결과에 해당하는 메시지(선택사항) 메시지는 경고 또는 오류 세부정보를 제공할 수 있습니다. 예를 들어 실행 상태가 건너뛰어지면 이 필드에 관련 이유/설명이 제공됩니다.
matchState

enum (FilterMatchState)

출력 전용입니다. RAI의 전체 필터 일치 상태입니다. 하나 이상의 RAI 필터 신뢰도 수준이 구성에 정의된 신뢰도 수준보다 높거나 같은 경우 값은 MATCH_FOUND입니다.
raiFilterTypeResults

map (key: string, value: object (RaiFilterTypeResult))

RAI 필터 결과의 맵으로, 키는 RAI 필터 유형('sexually_explicit', 'hate_speech', 'harassment', 'dangerous' 중 하나)입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

FilterExecutionState

특정 필터가 실행되었는지 여부를 보고하는 enum입니다.

열거형
FILTER_EXECUTION_STATE_UNSPECIFIED 미사용
EXECUTION_SUCCESS 필터가 실행되었습니다.
EXECUTION_SKIPPED 필터 실행을 건너뛰었습니다. 서버 측 오류나 권한 문제로 인해 발생할 수 있습니다.

MessageItem

정보, 경고 또는 오류 메시지를 보고하는 메시지 항목입니다.

JSON 표현 
{
  "messageType": enum (MessageType),
  "message": string
}
필드
messageType

enum (MessageType)

메시지 유형입니다.
message

string

메시지 콘텐츠입니다.

MessageType

메시지 유형을 지정하는 옵션입니다.

열거형
MESSAGE_TYPE_UNSPECIFIED 미사용
INFO 정보 관련 메시지
WARNING 경고 관련 메시지
ERROR 오류 메시지

RaiFilterTypeResult

책임감 있는 AI 필터 유형별 세부 필터 결과입니다.

JSON 표현 
{
  "filterType": enum (RaiFilterType),
  "confidenceLevel": enum (DetectionConfidenceLevel),
  "matchState": enum (FilterMatchState)
}
필드
filterType

enum (RaiFilterType)

책임감 있는 AI 필터의 유형입니다.
confidenceLevel

enum (DetectionConfidenceLevel)

이 RAI 필터에 대해 식별된 신뢰도 수준입니다.
matchState

enum (FilterMatchState)

출력 전용입니다. 이 RAI 필터의 일치 상태입니다.

SdpFilterResult

Sensitive Data Protection 필터 결과

JSON 표현 
{

  // Union field result can be only one of the following:
  "inspectResult": {
    object (SdpInspectResult)
  },
  "deidentifyResult": {
    object (SdpDeidentifyResult)
  }
  // End of list of possible types for union field result.
}
필드
통합 필드 result. 민감한 정보 보호 검사 결과 또는 익명처리 결과 중 하나입니다. result은 다음 중 하나여야 합니다.
inspectResult

object (SdpInspectResult)

검사가 실행된 경우 Sensitive Data Protection 검사 결과입니다.
deidentifyResult

object (SdpDeidentifyResult)

익명화가 실행된 경우 Sensitive Data Protection 익명화 결과입니다.

SdpInspectResult

민감한 정보 보호 검사 결과

JSON 표현 
{
  "executionState": enum (FilterExecutionState),
  "messageItems": [
    {
      object (MessageItem)
    }
  ],
  "matchState": enum (FilterMatchState),
  "findings": [
    {
      object (SdpFinding)
    }
  ],
  "findingsTruncated": boolean
}
필드
executionState

enum (FilterExecutionState)

출력 전용입니다. 민감한 정보 보호 검사가 실행되었는지 여부를 보고합니다.
messageItems[]

object (MessageItem)

결과에 해당하는 메시지(선택사항) 메시지는 경고 또는 오류 세부정보를 제공할 수 있습니다. 예를 들어 실행 상태가 건너뛰어지면 이 필드에 관련 이유/설명이 제공됩니다.
matchState

enum (FilterMatchState)

출력 전용입니다. SDP 검사의 일치 상태입니다. 민감한 정보 보호 발견 항목이 하나 이상 식별되면 값은 MATCH_FOUND입니다.
findings[]

object (SdpFinding)

민감한 정보 보호 발견 항목 목록
findingsTruncated

boolean

true인 경우 더 많은 발견 항목이 식별되었으며 반환된 발견 항목이 모든 발견 항목의 하위 집합일 수 있습니다. 입력 항목이 너무 크거나 서버가 단일 API 호출에 허용되는 최대 리소스 양에 도달하여 발견 항목 목록이 잘릴 수 있습니다.

SdpFinding

민감한 정보 보호 필터에 해당하는 발견 항목입니다.

JSON 표현 
{
  "infoType": string,
  "likelihood": enum (SdpFindingLikelihood),
  "location": {
    object (SdpFindingLocation)
  }
}
필드
infoType

string

이 발견 항목의 민감한 정보 보호 정보 유형 이름입니다.
likelihood

enum (SdpFindingLikelihood)

infoType의 신뢰도 가능성을 확인했습니다.
location

object (SdpFindingLocation)

이 발견 항목의 위치입니다.

SdpFindingLikelihood

각 민감한 정보 보호 가능성 수준에 관한 자세한 내용은 https://cloud.google.com/sensitive-data-protection/docs/likelihood를 참고하세요.

열거형
SDP_FINDING_LIKELIHOOD_UNSPECIFIED 기본값. POSSIBLE과 동일합니다.
VERY_UNLIKELY 거짓양성이 발생할 가능성이 가장 높습니다.
UNLIKELY 거짓양성 가능성이 높습니다.
POSSIBLE 일치하는 신호가 몇 개 있습니다. 기본값입니다.
LIKELY 거짓양성 가능성이 낮습니다.
VERY_LIKELY 신뢰도 수준이 높습니다. 거짓양성 가능성이 가장 낮습니다.

SdpFindingLocation

입력 콘텐츠 내에서 이 민감한 정보 보호 발견 항목의 위치입니다.

JSON 표현 
{
  "byteRange": {
    object (RangeInfo)
  },
  "codepointRange": {
    object (RangeInfo)
  }
}
필드
byteRange

object (RangeInfo)

발견 항목을 구분하는 0부터 시작하는 바이트 오프셋입니다. 이는 발견 항목의 포함 요소를 기준으로 합니다. 콘텐츠가 텍스트가 아닌 경우 콘텐츠의 UTF-8 인코딩된 텍스트 표현을 참조합니다.
codepointRange

object (RangeInfo)

발견 항목을 구분하는 유니코드 문자 오프셋입니다. 이는 발견 항목의 포함 요소를 기준으로 합니다. 콘텐츠가 텍스트인 경우 제공됩니다.

RangeInfo

절반 개방 범위 간격 [start, end)

JSON 표현 
{
  "start": string,
  "end": string
}
필드
start

string (int64 format)

proto3의 경우 필드가 선택사항이 아닌 한 값을 0으로 설정할 수 없습니다. 참조: https://protobuf.dev/programming-guides/proto3/#default 첫 번째 문자의 인덱스 (양 끝값 포함)입니다.
end

string (int64 format)

마지막 문자의 색인입니다 (해당 값 제외).

SdpDeidentifyResult

민감한 정보 보호 익명화 결과

JSON 표현 
{
  "executionState": enum (FilterExecutionState),
  "messageItems": [
    {
      object (MessageItem)
    }
  ],
  "matchState": enum (FilterMatchState),
  "data": {
    object (DataItem)
  },
  "transformedBytes": string
}
필드
executionState

enum (FilterExecutionState)

출력 전용입니다. 민감한 정보 보호 익명화가 성공적으로 실행되었는지 여부를 보고합니다.
messageItems[]

object (MessageItem)

결과에 해당하는 메시지(선택사항) 메시지는 경고 또는 오류 세부정보를 제공할 수 있습니다. 예를 들어 실행 상태가 건너뛰어지면 이 필드에 관련 이유/설명이 제공됩니다.
matchState

enum (FilterMatchState)

출력 전용입니다. 민감한 정보 보호 익명화의 상태를 일치시킵니다. 콘텐츠가 익명처리된 경우 값은 MATCH_FOUND입니다.
data

object (DataItem)

익명화된 데이터
transformedBytes

string (int64 format)

익명처리 중에 변환된 총 크기(바이트)입니다.

PiAndJailbreakFilterResult

프롬프트 삽입 및 탈옥 필터 결과

JSON 표현 
{
  "executionState": enum (FilterExecutionState),
  "messageItems": [
    {
      object (MessageItem)
    }
  ],
  "matchState": enum (FilterMatchState),
  "confidenceLevel": enum (DetectionConfidenceLevel)
}
필드
executionState

enum (FilterExecutionState)

출력 전용입니다. 프롬프트 삽입 및 탈옥 필터가 실행되었는지 여부를 보고합니다.
messageItems[]

object (MessageItem)

결과에 해당하는 메시지(선택사항) 메시지는 경고 또는 오류 세부정보를 제공할 수 있습니다. 예를 들어 실행 상태가 건너뛰어지면 이 필드에 관련 이유/설명이 제공됩니다.
matchState

enum (FilterMatchState)

출력 전용입니다. 프롬프트 삽입 및 탈옥의 일치 상태입니다.
confidenceLevel

enum (DetectionConfidenceLevel)

프롬프트 삽입 및 탈옥에 대해 식별된 신뢰도 수준입니다.

MaliciousUriFilterResult

악성 URI 필터 결과

JSON 표현 
{
  "executionState": enum (FilterExecutionState),
  "messageItems": [
    {
      object (MessageItem)
    }
  ],
  "matchState": enum (FilterMatchState),
  "maliciousUriMatchedItems": [
    {
      object (MaliciousUriMatchedItem)
    }
  ]
}
필드
executionState

enum (FilterExecutionState)

출력 전용입니다. 악성 URI 필터가 실행되었는지 여부를 보고합니다.
messageItems[]

object (MessageItem)

결과에 해당하는 메시지(선택사항) 메시지는 경고 또는 오류 세부정보를 제공할 수 있습니다. 예를 들어 실행 상태가 건너뛰어지면 이 필드에 관련 이유/설명이 제공됩니다.
matchState

enum (FilterMatchState)

출력 전용입니다. 이 악성 URI의 일치 상태입니다. 악성 URI가 하나 이상 발견되면 값은 MATCH_FOUND입니다.
maliciousUriMatchedItems[]

object (MaliciousUriMatchedItem)

데이터에서 발견된 악성 URI 목록입니다.

MaliciousUriMatchedItem

악성 URI 및 입력 콘텐츠 내 위치에 관한 정보입니다.

JSON 표현 
{
  "uri": string,
  "locations": [
    {
      object (RangeInfo)
    }
  ]
}
필드
uri

string

악성 URI
locations[]

object (RangeInfo)

악성 URI가 식별된 위치 목록입니다. locations 필드는 일반 텍스트 콘텐츠(예: ByteItemType.PLAINTEXT_UTF8)에만 지원됩니다.

CsamFilterResult

아동 성적 학대 콘텐츠 (CSAM) 필터 결과

JSON 표현 
{
  "executionState": enum (FilterExecutionState),
  "messageItems": [
    {
      object (MessageItem)
    }
  ],
  "matchState": enum (FilterMatchState)
}
필드
executionState

enum (FilterExecutionState)

출력 전용입니다. 아동 성적 학대 콘텐츠 필터가 실행되었는지 여부를 보고합니다.
messageItems[]

object (MessageItem)

결과에 해당하는 메시지(선택사항) 메시지는 경고 또는 오류 세부정보를 제공할 수 있습니다. 예를 들어 실행 상태가 건너뛰어지면 이 필드에 관련 이유/설명이 제공됩니다.
matchState

enum (FilterMatchState)

출력 전용입니다. 아동 성적 학대 콘텐츠의 일치 상태입니다.

VirusScanFilterResult

바이러스 검사 결과

JSON 표현 
{
  "executionState": enum (FilterExecutionState),
  "messageItems": [
    {
      object (MessageItem)
    }
  ],
  "matchState": enum (FilterMatchState),
  "scannedContentType": enum (ScannedContentType),
  "virusDetails": [
    {
      object (VirusDetail)
    }
  ],
  "scannedSize": string
}
필드
executionState

enum (FilterExecutionState)

출력 전용입니다. 바이러스 검사가 성공적으로 실행되었는지 여부를 보고합니다.
messageItems[]

object (MessageItem)

결과에 해당하는 메시지(선택사항) 메시지는 경고 또는 오류 세부정보를 제공할 수 있습니다. 예를 들어 실행 상태가 건너뛰어지면 이 필드에 관련 이유/설명이 제공됩니다.
matchState

enum (FilterMatchState)

출력 전용입니다. 바이러스의 일치 상태입니다. 데이터가 바이러스에 감염된 경우 값은 MATCH_FOUND입니다.
scannedContentType

enum (ScannedContentType)

스캔된 콘텐츠 유형입니다.
virusDetails[]

object (VirusDetail)

식별된 바이러스 목록 바이러스가 감지되지 않으면 이 필드는 비어 있습니다.
scannedSize

string (int64 format)

스캔된 콘텐츠의 크기(바이트)입니다.

ScannedContentType

스캔된 콘텐츠 유형입니다.

열거형
SCANNED_CONTENT_TYPE_UNSPECIFIED 미사용
UNKNOWN 알 수 없는 콘텐츠
PLAINTEXT 일반 텍스트
PDF PDF 전용 PDF 스캔이 지원됩니다.

VirusDetail

확인된 바이러스의 세부정보

JSON 표현 
{
  "vendor": string,
  "names": [
    string
  ],
  "threatType": enum (ThreatType)
}
필드
vendor

string

이 바이러스 식별을 생성한 공급업체의 이름입니다.
names[]

string

이 바이러스의 이름입니다.
threatType

enum (ThreatType)

식별된 바이러스의 위협 유형

ThreatType

바이러스의 모든 위협 유형을 정의합니다.

열거형
THREAT_TYPE_UNSPECIFIED 미사용
UNKNOWN 위협을 분류할 수 없음
VIRUS_OR_WORM 바이러스 또는 웜 위협
MALICIOUS_PROGRAM 악성 프로그램 예: 스파이웨어, 트로이 목마
POTENTIALLY_HARMFUL_CONTENT 유해할 수 있는 콘텐츠 예: 삽입된 코드, 매크로
POTENTIALLY_UNWANTED_CONTENT 원치 않을 가능성이 있는 콘텐츠 예: 애드웨어

InvocationResult

일치 상태와 관계없이 호출의 결과를 나타내는 필드입니다.

열거형
INVOCATION_RESULT_UNSPECIFIED 사용되지 않습니다. 기본값
SUCCESS 모든 필터가 성공적으로 호출되었습니다.
PARTIAL 일부 필터가 건너뛰거나 실패했습니다.
FAILURE 모든 필터가 건너뛰거나 실패했습니다.

SanitizationMetadata

정리 메타데이터를 설명하는 메시지입니다.

JSON 표현 
{
  "errorCode": string,
  "errorMessage": string
}
필드
errorCode

string (int64 format)

오류 코드(있는 경우)
errorMessage

string

오류 메시지(있는 경우)