REST Resource: projects.locations.templates

Recurso: Plantilla

Mensaje que describe el recurso de plantilla

Representación JSON 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "filterConfig": {
    object (FilterConfig)
  },
  "templateMetadata": {
    object (TemplateMetadata)
  }
}
Campos
name

string

Identificador. Nombre del recurso
createTime

string (Timestamp format)

Solo salida. [Solo salida] Crear marca de tiempo

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. [Solo salida] Actualiza la marca de tiempo

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Opcional. Etiquetas como pares clave-valor

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
filterConfig

object (FilterConfig)

Obligatorio. Configuración del filtro para esta plantilla
templateMetadata

object (TemplateMetadata)

Opcional. Metadatos de esta plantilla

FilterConfig

Configuración de filtros.

Representación JSON 
{
  "raiSettings": {
    object (RaiFilterSettings)
  },
  "sdpSettings": {
    object (SdpFilterSettings)
  },
  "piAndJailbreakFilterSettings": {
    object (PiAndJailbreakFilterSettings)
  },
  "maliciousUriFilterSettings": {
    object (MaliciousUriFilterSettings)
  }
}
Campos
raiSettings

object (RaiFilterSettings)

Opcional. Configuración de IA responsable
sdpSettings

object (SdpFilterSettings)

Opcional. Configuración de Sensitive Data Protection.
piAndJailbreakFilterSettings

object (PiAndJailbreakFilterSettings)

Opcional. Configuración de filtros de inyección de instrucciones y jailbreak.
maliciousUriFilterSettings

object (MaliciousUriFilterSettings)

Opcional. Configuración del filtro de URI malicioso

RaiFilterSettings

Configuración del filtro de IA responsable.

Representación JSON 
{
  "raiFilters": [
    {
      object (RaiFilter)
    }
  ]
}
Campos
raiFilters[]

object (RaiFilter)

Obligatorio. Es la lista de filtros de IA responsable habilitados para la plantilla.

RaiFilter

Filtro de IA responsable.

Representación JSON 
{
  "filterType": enum (RaiFilterType),
  "confidenceLevel": enum (DetectionConfidenceLevel)
}
Campos
filterType

enum (RaiFilterType)

Obligatorio. Tipo de filtro de IA responsable.
confidenceLevel

enum (DetectionConfidenceLevel)

Opcional. Nivel de confianza de este filtro de RAI. Durante la limpieza de datos, si estos se clasifican en este filtro con un nivel de confianza igual o superior al nivel especificado, se informa de una coincidencia positiva. Si no se especifica el nivel de confianza (es decir, 0), el sistema usará un nivel predeterminado razonable según el filterType.

RaiFilterType

Opciones para los tipos de filtros de IA responsable.

Enums
RAI_FILTER_TYPE_UNSPECIFIED Tipo de filtro no especificado.
SEXUALLY_EXPLICIT Contenido sexual explícito
HATE_SPEECH Incitación al odio o a la violencia
HARASSMENT Acoso
DANGEROUS Peligro

DetectionConfidenceLevel

Niveles de confianza de los detectores Un valor más alto se asigna a un nivel de confianza mayor. Para aplicar un nivel más estricto, se debe usar un valor más bajo.

Enums
DETECTION_CONFIDENCE_LEVEL_UNSPECIFIED Es igual que LOW_AND_ABOVE.
LOW_AND_ABOVE Mayor probabilidad de un falso positivo.
MEDIUM_AND_ABOVE Hay alguna posibilidad de falsos positivos.
HIGH Baja probabilidad de falsos positivos.

SdpFilterSettings

Configuración de Sensitive Data Protection.

Representación 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.
}
Campos
Campo de unión sdp_configuration. Cualquier configuración básica o avanzada de la Protección de datos sensibles sdp_configuration puede ser solo uno de los siguientes:
basicConfig

object (SdpBasicConfig)

Opcional. La configuración básica de la Protección de datos sensibles inspecciona el contenido en busca de datos sensibles con un conjunto fijo de seis infotipos. Las plantillas de Protección de datos sensibles no se pueden usar con la configuración básica. Solo se admite la operación de inspección de Sensitive Data Protection con la configuración básica.
advancedConfig

object (SdpAdvancedConfig)

Opcional. Configuración avanzada de Protección de datos sensibles que permite el uso de plantillas de Protección de datos sensibles. Admite operaciones de inspección y desidentificación de Sensitive Data Protection.

SdpBasicConfig

Configuración básica de la Protección de datos sensibles

Representación JSON 
{
  "filterEnforcement": enum (SdpBasicConfigEnforcement)
}
Campos
filterEnforcement

enum (SdpBasicConfigEnforcement)

Opcional. Indica si la configuración básica de Protección de datos sensibles está habilitada o inhabilitada.

SdpBasicConfigEnforcement

Es la opción para especificar el estado de la configuración básica de Sensitive Data Protection (ENABLED/DISABLED).

Enums
SDP_BASIC_CONFIG_ENFORCEMENT_UNSPECIFIED Igual que Inhabilitado
ENABLED Habilitado
DISABLED Inhabilitado

SdpAdvancedConfig

Configuración avanzada de Sensitive Data Protection.

Representación JSON 
{
  "inspectTemplate": string,
  "deidentifyTemplate": string
}
Campos
inspectTemplate

string

Opcional. Nombre del recurso de la plantilla de inspección de Sensitive Data Protection

Si solo se proporciona la plantilla de inspección (no se proporciona la plantilla de desidentificación), se realiza la acción InspectContent de Sensitive Data Protection durante la limpieza. Todos los hallazgos de la Protección de datos sensibles identificados durante la inspección se mostrarán como SdpFinding en SdpInsepctionResult.

p. e.j, projects/{project}/locations/{location}/inspectTemplates/{inspectTemplate}
deidentifyTemplate

string

Opcional. Nombre del recurso de plantilla de desidentificación de Sensitive Data Protection opcional.

Si se proporciona, la acción DeidentifyContent se realiza durante la limpieza con esta plantilla y la de inspección. Los datos desidentificados se devolverán en SdpDeidentifyResult. Ten en cuenta que todos los tipos de información presentes en la plantilla de anonimización deben estar presentes en la plantilla de inspección.

p. e.j, projects/{project}/locations/{location}/deidentifyTemplates/{deidentifyTemplate}

PiAndJailbreakFilterSettings

Configuración de inyección de instrucciones y filtro de jailbreak.

Representación JSON 
{
  "filterEnforcement": enum (PiAndJailbreakFilterEnforcement),
  "confidenceLevel": enum (DetectionConfidenceLevel)
}
Campos
filterEnforcement

enum (PiAndJailbreakFilterEnforcement)

Opcional. Indica si el filtro de inyección de instrucciones y jailbreak está habilitado o inhabilitado.
confidenceLevel

enum (DetectionConfidenceLevel)

Opcional. Nivel de confianza de este filtro. El nivel de confianza se usa para determinar el umbral del filtro. Si la confianza de detección es igual o superior al nivel especificado, se informa de una coincidencia positiva. El nivel de confianza solo se usará si el filtro está habilitado.

PiAndJailbreakFilterEnforcement

Es la opción para especificar el estado del filtro de inyección de instrucciones y jailbreak (ENABLED/DISABLED).

Enums
PI_AND_JAILBREAK_FILTER_ENFORCEMENT_UNSPECIFIED Igual que Inhabilitado
ENABLED Habilitado
DISABLED Habilitado

MaliciousUriFilterSettings

Configuración del filtro de URI malicioso

Representación JSON 
{
  "filterEnforcement": enum (MaliciousUriFilterEnforcement)
}
Campos
filterEnforcement

enum (MaliciousUriFilterEnforcement)

Opcional. Indica si el filtro de URI malicioso está habilitado o inhabilitado.

MaliciousUriFilterEnforcement

Es la opción para especificar el estado del filtro de URI malicioso (ENABLED/DISABLED).

Enums
MALICIOUS_URI_FILTER_ENFORCEMENT_UNSPECIFIED Igual que Inhabilitado
ENABLED Habilitado
DISABLED Inhabilitado

TemplateMetadata

Mensaje que describe TemplateMetadata

Representación JSON 
{
  "ignorePartialInvocationFailures": boolean,
  "customPromptSafetyErrorCode": integer,
  "customPromptSafetyErrorMessage": string,
  "customLlmResponseSafetyErrorCode": integer,
  "customLlmResponseSafetyErrorMessage": string,
  "logTemplateOperations": boolean,
  "logSanitizeOperations": boolean
}
Campos
ignorePartialInvocationFailures

boolean

Opcional. Si es verdadero, se deben ignorar las fallas parciales del detector.
customPromptSafetyErrorCode

integer

Opcional. Indica el código de error personalizado que estableció el usuario para que la extensión del servicio lo muestre al usuario final si la solicitud activa los filtros de Model Armor.
customPromptSafetyErrorMessage

string

Opcional. Indica el mensaje de error personalizado que estableció el usuario para que se muestre al usuario final si la solicitud activa los filtros de Model Armor.
customLlmResponseSafetyErrorCode

integer

Opcional. Indica el código de error personalizado que estableció el usuario para que se devuelva al usuario final si la respuesta del LLM activa los filtros de Model Armor.
customLlmResponseSafetyErrorMessage

string

Opcional. Indica el mensaje de error personalizado que estableció el usuario para que se devuelva al usuario final si la respuesta del LLM activa los filtros de Model Armor.
logTemplateOperations

boolean

Opcional. Si es verdadero, registra las operaciones de CRUD de la plantilla.
logSanitizeOperations

boolean

Opcional. Si es verdadero, registra las operaciones de limpieza.

Métodos

create

 Crea una plantilla nueva en un proyecto y una ubicación determinados.

delete

 Borra una sola plantilla.

get

 Obtiene detalles de una sola plantilla.

list

 Enumera plantillas en una ubicación y un proyecto determinados.

patch

 Actualiza los parámetros de una sola plantilla.

sanitizeModelResponse

 Limpia la respuesta del modelo.

sanitizeUserPrompt

 Limpia la instrucción del usuario.