REST Resource: projects.locations.templates

리소스: Template

템플릿 리소스를 설명하는 메시지

JSON 표현 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "filterConfig": {
    object (FilterConfig)
  },
  "templateMetadata": {
    object (TemplateMetadata)
  }
}
필드
name

string

식별자. 리소스의 이름
createTime

string (Timestamp format)

출력 전용입니다. [출력 전용] 생성 타임스탬프

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. [출력 전용] 업데이트 타임스탬프

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
labels

map (key: string, value: string)

선택사항입니다. 키-값 쌍인 라벨입니다.

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

object (FilterConfig)

필수. 이 템플릿의 필터 구성
templateMetadata

object (TemplateMetadata)

선택사항. 이 템플릿의 메타데이터

FilterConfig

필터 구성

JSON 표현 
{
  "raiSettings": {
    object (RaiFilterSettings)
  },
  "sdpSettings": {
    object (SdpFilterSettings)
  },
  "piAndJailbreakFilterSettings": {
    object (PiAndJailbreakFilterSettings)
  },
  "maliciousUriFilterSettings": {
    object (MaliciousUriFilterSettings)
  }
}
필드
raiSettings

object (RaiFilterSettings)

선택사항입니다. 책임감 있는 AI 설정
sdpSettings

object (SdpFilterSettings)

선택사항입니다. 민감한 정보 보호 설정
piAndJailbreakFilterSettings

object (PiAndJailbreakFilterSettings)

선택사항입니다. 프롬프트 삽입 및 탈옥 필터 설정
maliciousUriFilterSettings

object (MaliciousUriFilterSettings)

선택사항입니다. 악성 URI 필터 설정

RaiFilterSettings

책임감 있는 AI 필터 설정

JSON 표현 
{
  "raiFilters": [
    {
      object (RaiFilter)
    }
  ]
}
필드
raiFilters[]

object (RaiFilter)

필수 입력란입니다. 템플릿에 사용 설정된 책임감 있는 AI 필터 목록입니다.

RaiFilter

책임감 있는 AI 필터입니다.

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

enum (RaiFilterType)

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

enum (DetectionConfidenceLevel)

선택사항입니다. 이 RAI 필터의 신뢰도 수준입니다. 데이터 정리 중에 데이터가 이 필터에 따라 분류되고 신뢰도 수준이 지정된 수준 이상이면 양성 일치가 보고됩니다. 신뢰도 수준이 지정되지 않은 경우(즉, 0) 시스템에서 filterType를 기반으로 적절한 기본 수준을 사용합니다.

RaiFilterType

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

열거형
RAI_FILTER_TYPE_UNSPECIFIED 지정되지 않은 필터 유형입니다.
SEXUALLY_EXPLICIT 성적으로 노골적입니다.
HATE_SPEECH 증오심 표현
HARASSMENT 괴롭힘
DANGEROUS 위험

DetectionConfidenceLevel

감지기의 신뢰도 수준입니다. 값이 높을수록 신뢰도가 높습니다. 더 엄격한 수준을 적용하려면 더 낮은 값을 사용해야 합니다.

열거형
DETECTION_CONFIDENCE_LEVEL_UNSPECIFIED LOW_AND_ABOVE와 동일합니다.
LOW_AND_ABOVE 거짓양성이 발생할 가능성이 가장 높습니다.
MEDIUM_AND_ABOVE 거짓양성이 발생할 수 있습니다.
HIGH 거짓양성 가능성이 낮습니다.

SdpFilterSettings

민감한 정보 보호 설정

JSON 표현 
{

  // Union field sdp_configuration can be only one of the following:
  "basicConfig": {
    object (SdpBasicConfig)
  },
  "advancedConfig": {
    object (SdpAdvancedConfig)
  }
  // End of list of possible types for union field sdp_configuration.
}
필드
통합 필드 sdp_configuration. Sensitive Data Protection 기본 또는 고급 구성 중 하나 sdp_configuration은 다음 중 하나여야 합니다.
basicConfig

object (SdpBasicConfig)

선택사항입니다. 기본 민감한 정보 보호 구성은 6개의 고정된 정보 유형 집합을 사용하여 콘텐츠에서 민감한 정보를 검사합니다. 민감한 정보 보호 템플릿은 기본 구성에서는 사용할 수 없습니다. 기본 구성에서는 민감한 정보 보호 검사 작업만 지원됩니다.
advancedConfig

object (SdpAdvancedConfig)

선택사항입니다. 민감한 정보 보호 템플릿을 사용할 수 있는 고급 민감한 정보 보호 구성 민감한 정보 보호 검사 및 익명화 작업을 모두 지원합니다.

SdpBasicConfig

Sensitive Data Protection 기본 구성

JSON 표현 
{
  "filterEnforcement": enum (SdpBasicConfigEnforcement)
}
필드
filterEnforcement

enum (SdpBasicConfigEnforcement)

선택사항입니다. 민감한 정보 보호 기본 구성이 사용 설정되었는지 또는 사용 중지되었는지 알려줍니다.

SdpBasicConfigEnforcement

민감한 정보 보호 기본 구성의 상태 (ENABLED/DISABLED)를 지정하는 옵션입니다.

열거형
SDP_BASIC_CONFIG_ENFORCEMENT_UNSPECIFIED 사용 중지와 동일
ENABLED 사용 설정됨
DISABLED 사용 중지됨

SdpAdvancedConfig

민감한 정보 보호 고급 구성

JSON 표현 
{
  "inspectTemplate": string,
  "deidentifyTemplate": string
}
필드
inspectTemplate

string

선택사항입니다. 민감한 정보 보호 검사 템플릿 리소스 이름

검사 템플릿만 제공되고 (익명화 템플릿은 제공되지 않음) 정리 중에 Sensitive Data Protection InspectContent 작업이 실행됩니다. 검사 중에 식별된 모든 민감한 정보 보호 발견 항목은 SdpInsepctionResult에서 SdpFinding으로 반환됩니다.

예: projects/{project}/locations/{location}/inspectTemplates/{inspectTemplate}
deidentifyTemplate

string

선택사항입니다. 선택사항인 민감한 정보 보호 익명화 템플릿 리소스 이름입니다.

제공된 경우 이 템플릿을 사용하여 정리 중에 DeidentifyContent 작업이 수행되고 템플릿이 검사됩니다. 익명화된 데이터는 SdpDeidentifyResult로 반환됩니다. 익명화 템플릿에 있는 모든 정보 유형은 검사 템플릿에 있어야 합니다.

예: projects/{project}/locations/{location}/deidentifyTemplates/{deidentifyTemplate}

PiAndJailbreakFilterSettings

프롬프트 삽입 및 탈옥 필터 설정

JSON 표현 
{
  "filterEnforcement": enum (PiAndJailbreakFilterEnforcement),
  "confidenceLevel": enum (DetectionConfidenceLevel)
}
필드
filterEnforcement

enum (PiAndJailbreakFilterEnforcement)

선택사항입니다. 프롬프트 삽입 및 탈옥 필터가 사용 설정되었는지 또는 사용 중지되었는지 알려줍니다.
confidenceLevel

enum (DetectionConfidenceLevel)

선택사항입니다. 이 필터의 신뢰도 수준입니다. 신뢰도 수준은 필터의 기준점을 결정하는 데 사용됩니다. 감지 신뢰도가 지정된 수준 이상이면 양성 일치가 보고됩니다. 신뢰도 수준은 필터가 사용 설정된 경우에만 사용됩니다.

PiAndJailbreakFilterEnforcement

프롬프트 삽입 및 탈옥 필터의 상태 (ENABLED/DISABLED)를 지정하는 옵션입니다.

열거형
PI_AND_JAILBREAK_FILTER_ENFORCEMENT_UNSPECIFIED 사용 중지와 동일
ENABLED 사용 설정됨
DISABLED 사용 설정됨

MaliciousUriFilterSettings

악성 URI 필터 설정

JSON 표현 
{
  "filterEnforcement": enum (MaliciousUriFilterEnforcement)
}
필드
filterEnforcement

enum (MaliciousUriFilterEnforcement)

선택사항입니다. 악성 URI 필터가 사용 설정되었는지 또는 사용 중지되었는지 알려줍니다.

MaliciousUriFilterEnforcement

악성 URI 필터의 상태 (ENABLED/DISABLED)를 지정하는 옵션입니다.

열거형
MALICIOUS_URI_FILTER_ENFORCEMENT_UNSPECIFIED 사용 중지와 동일
ENABLED 사용 설정됨
DISABLED 사용 중지됨

TemplateMetadata

TemplateMetadata를 설명하는 메시지

JSON 표현 
{
  "ignorePartialInvocationFailures": boolean,
  "customPromptSafetyErrorCode": integer,
  "customPromptSafetyErrorMessage": string,
  "customLlmResponseSafetyErrorCode": integer,
  "customLlmResponseSafetyErrorMessage": string,
  "logTemplateOperations": boolean,
  "logSanitizeOperations": boolean
}
필드
ignorePartialInvocationFailures

boolean

선택사항입니다. true인 경우 부분적인 감지기 실패는 무시해야 합니다.
customPromptSafetyErrorCode

integer

선택사항입니다. 프롬프트가 모델 아머 필터를 트리거하는 경우 서비스 확장 프로그램에서 최종 사용자에게 반환하도록 사용자가 설정한 맞춤 오류 코드를 나타냅니다.
customPromptSafetyErrorMessage

string

선택사항입니다. 프롬프트가 모델 아머 필터를 트리거하는 경우 최종 사용자에게 반환되도록 사용자가 설정한 맞춤 오류 메시지를 나타냅니다.
customLlmResponseSafetyErrorCode

integer

선택사항입니다. LLM 응답으로 인해 모델 아머 필터가 트리거되는 경우 최종 사용자에게 반환되도록 사용자가 설정한 맞춤 오류 코드를 나타냅니다.
customLlmResponseSafetyErrorMessage

string

선택사항입니다. LLM 응답으로 인해 모델 아머 필터가 트리거되는 경우 최종 사용자에게 반환되도록 사용자가 설정한 맞춤 오류 메시지를 나타냅니다.
logTemplateOperations

boolean

선택사항입니다. true이면 템플릿 crud 작업을 로깅합니다.
logSanitizeOperations

boolean

선택사항입니다. true이면 정리 작업을 로깅합니다.

메서드

create

 특정 프로젝트 및 위치에 새 템플릿을 만듭니다.

delete

 단일 템플릿을 삭제합니다.

get

 단일 템플릿의 세부정보를 가져옵니다.

list

 특정 프로젝트 및 위치의 템플릿을 나열합니다.

patch

 단일 템플릿의 매개변수를 업데이트합니다.

sanitizeModelResponse

 모델 응답을 정리합니다.

sanitizeUserPrompt

 사용자 프롬프트를 정리합니다.