REST Resource: projects.locations.templates

Risorsa: modello

Messaggio che descrive la risorsa Modello

Rappresentazione JSON 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "filterConfig": {
    object (FilterConfig)
  },
  "templateMetadata": {
    object (TemplateMetadata)
  }
}
Campi
name

string

Identificatore. Nome della risorsa
createTime

string (Timestamp format)

Solo output. [Solo output] Timestamp creazione

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Solo output. [Solo output] Timestamp aggiornamento

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
labels

map (key: string, value: string)

Facoltativo. Etichette come coppie chiave-valore

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
filterConfig

object (FilterConfig)

Obbligatorio. Configurazione del filtro per questo modello
templateMetadata

object (TemplateMetadata)

(Facoltativo) Metadati per questo modello

FilterConfig

Configurazione dei filtri.

Rappresentazione JSON 
{
  "raiSettings": {
    object (RaiFilterSettings)
  },
  "sdpSettings": {
    object (SdpFilterSettings)
  },
  "piAndJailbreakFilterSettings": {
    object (PiAndJailbreakFilterSettings)
  },
  "maliciousUriFilterSettings": {
    object (MaliciousUriFilterSettings)
  }
}
Campi
raiSettings

object (RaiFilterSettings)

Facoltativo. Impostazioni di IA responsabile.
sdpSettings

object (SdpFilterSettings)

Facoltativo. Impostazioni di Sensitive Data Protection.
piAndJailbreakFilterSettings

object (PiAndJailbreakFilterSettings)

Facoltativo. Impostazioni del filtro prompt injection e jailbreak.
maliciousUriFilterSettings

object (MaliciousUriFilterSettings)

Facoltativo. Impostazioni del filtro URI dannosi.

RaiFilterSettings

Impostazioni del filtro AI responsabile.

Rappresentazione JSON 
{
  "raiFilters": [
    {
      object (RaiFilter)
    }
  ]
}
Campi
raiFilters[]

object (RaiFilter)

Obbligatorio. Elenco dei filtri di IA responsabile abilitati per il modello.

RaiFilter

Filtro AI responsabile.

Rappresentazione JSON 
{
  "filterType": enum (RaiFilterType),
  "confidenceLevel": enum (DetectionConfidenceLevel)
}
Campi
filterType

enum (RaiFilterType)

Obbligatorio. Tipo di filtro AI responsabile.
confidenceLevel

enum (DetectionConfidenceLevel)

Facoltativo. Livello di confidenza per questo filtro AI responsabile. Se i dati, durante la sanitizzazione, sono classificati in questo filtro con un livello di confidenza maggiore o uguale a quello specificato, viene segnalata una corrispondenza positiva. Se il livello di confidenza non è specificato (ovvero è uguale a 0), il sistema utilizzerà un livello predefinito ragionevole in base a filterType.

RaiFilterType

Opzioni per i tipi di filtro AI responsabile.

Enum
RAI_FILTER_TYPE_UNSPECIFIED Tipo di filtro non specificato.
SEXUALLY_EXPLICIT Contenuti sessualmente espliciti.
HATE_SPEECH Incitamento all'odio.
HARASSMENT Molestie.
DANGEROUS Pericolo

DetectionConfidenceLevel

Livelli di confidenza per i rilevatori. Un valore più elevato corrisponde a un livello di confidenza maggiore. Per applicare un livello più rigoroso, deve essere utilizzato un valore inferiore.

Enum
DETECTION_CONFIDENCE_LEVEL_UNSPECIFIED Uguale a LOW_AND_ABOVE.
LOW_AND_ABOVE Probabilità più elevata di un falso positivo.
MEDIUM_AND_ABOVE È possibile che si verifichino dei falsi positivi.
HIGH Bassa probabilità di falsi positivi.

SdpFilterSettings

Impostazioni di Sensitive Data Protection.

Rappresentazione 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.
}
Campi
Campo unione sdp_configuration. Configurazione di base o avanzata di Sensitive Data Protection. sdp_configuration può essere solo uno dei seguenti:
basicConfig

object (SdpBasicConfig)

Facoltativo. La configurazione di base di Sensitive Data Protection controlla la presenza di dati sensibili nei contenuti utilizzando un insieme fisso di sei tipi di informazioni. I modelli di Sensitive Data Protection non possono essere utilizzati con la configurazione di base. Con la configurazione di base è supportata solo l'operazione di ispezione di Sensitive Data Protection.
advancedConfig

object (SdpAdvancedConfig)

Facoltativo. Configurazione avanzata di Sensitive Data Protection che consente l'utilizzo dei modelli di Sensitive Data Protection. Supporta sia le operazioni di ispezione che quelle di anonimizzazione di Sensitive Data Protection.

SdpBasicConfig

Configurazione di base di Sensitive Data Protection.

Rappresentazione JSON 
{
  "filterEnforcement": enum (SdpBasicConfigEnforcement)
}
Campi
filterEnforcement

enum (SdpBasicConfigEnforcement)

Facoltativo. Indica se la configurazione di base di Sensitive Data Protection è abilitata o disabilitata.

SdpBasicConfigEnforcement

Opzione per specificare lo stato della configurazione di base di Sensitive Data Protection (ENABLED/DISABLED).

Enum
SDP_BASIC_CONFIG_ENFORCEMENT_UNSPECIFIED Uguale a Disattivato
ENABLED Abilitato
DISABLED Disabilitato

SdpAdvancedConfig

Configurazione avanzata di Sensitive Data Protection.

Rappresentazione JSON 
{
  "inspectTemplate": string,
  "deidentifyTemplate": string
}
Campi
inspectTemplate

string

Facoltativo. Nome della risorsa del modello di ispezione Sensitive Data Protection

Se viene fornito solo il modello di ispezione e non quello di anonimizzazione, l'azione InspectContent di Sensitive Data Protection viene eseguita durante la sanitizzazione. Tutti i risultati di Sensitive Data Protection identificati durante l'ispezione verranno restituiti come SdpFinding in SdpInsepctionResult, ad esempio organizations/{organization}/inspectTemplates/{inspectTemplate}, projects/{project}/inspectTemplates/{inspectTemplate} organizations/{organization}/locations/{location}/inspectTemplates/{inspectTemplate} projects/{project}/locations/{location}/inspectTemplates/{inspectTemplate}
deidentifyTemplate

string

Facoltativo. Nome della risorsa del modello di anonimizzazione Sensitive Data Protection facoltativo.

Se specificata, l'azione DeidentifyContent viene eseguita durante la sanitizzazione utilizzando questo modello e il modello di ispezione. I dati anonimizzati verranno restituiti in SdpDeidentifyResult. Tieni presente che tutti gli infoType presenti nel modello di anonimizzazione devono essere presenti nel modello di ispezione.

ad es. organizations/{organization}/deidentifyTemplates/{deidentifyTemplate}, projects/{project}/deidentifyTemplates/{deidentifyTemplate} organizations/{organization}/locations/{location}/deidentifyTemplates/{deidentifyTemplate} projects/{project}/locations/{location}/deidentifyTemplates/{deidentifyTemplate}

PiAndJailbreakFilterSettings

Impostazioni del filtro Prompt injection e Jailbreak.

Rappresentazione JSON 
{
  "filterEnforcement": enum (PiAndJailbreakFilterEnforcement),
  "confidenceLevel": enum (DetectionConfidenceLevel)
}
Campi
filterEnforcement

enum (PiAndJailbreakFilterEnforcement)

Facoltativo. Indica se il filtro prompt injection e jailbreak è attivato o disattivato.
confidenceLevel

enum (DetectionConfidenceLevel)

Facoltativo. Livello di confidenza per questo filtro. Il livello di confidenza viene utilizzato per determinare la soglia per il filtro. Se il livello di confidenza del rilevamento è uguale o maggiore del livello specificato, viene segnalata una corrispondenza positiva. Il livello di confidenza verrà utilizzato solo se il filtro è abilitato.

PiAndJailbreakFilterEnforcement

Opzione per specificare lo stato del filtro Prompt Injection e Jailbreak (ENABLED/DISABLED).

Enum
PI_AND_JAILBREAK_FILTER_ENFORCEMENT_UNSPECIFIED Uguale a Disattivato
ENABLED Abilitato
DISABLED Abilitato

MaliciousUriFilterSettings

Impostazioni del filtro URI dannosi.

Rappresentazione JSON 
{
  "filterEnforcement": enum (MaliciousUriFilterEnforcement)
}
Campi
filterEnforcement

enum (MaliciousUriFilterEnforcement)

Facoltativo. Indica se il filtro URI dannoso è abilitato o disabilitato.

MaliciousUriFilterEnforcement

Opzione per specificare lo stato del filtro URI dannosi (ABILITA/DISATTIVA).

Enum
MALICIOUS_URI_FILTER_ENFORCEMENT_UNSPECIFIED Uguale a Disattivato
ENABLED Abilitato
DISABLED Disabilitato

TemplateMetadata

Messaggio che descrive TemplateMetadata

Rappresentazione JSON 
{
  "ignorePartialInvocationFailures": boolean,
  "customPromptSafetyErrorCode": integer,
  "customPromptSafetyErrorMessage": string,
  "customLlmResponseSafetyErrorCode": integer,
  "customLlmResponseSafetyErrorMessage": string,
  "logTemplateOperations": boolean,
  "logSanitizeOperations": boolean
}
Campi
ignorePartialInvocationFailures

boolean

Facoltativo. Se il valore è true, gli errori parziali del rilevatore devono essere ignorati.
customPromptSafetyErrorCode

integer

Facoltativo. Indica il codice di errore personalizzato impostato dall'utente da restituire all'utente finale dall'estensione del servizio se la richiesta attiva i filtri di Model Armor.
customPromptSafetyErrorMessage

string

Facoltativo. Indica il messaggio di errore personalizzato impostato dall'utente da restituire all'utente finale se la richiesta attiva i filtri di Model Armor.
customLlmResponseSafetyErrorCode

integer

Facoltativo. Indica il codice di errore personalizzato impostato dall'utente da restituire all'utente finale se la risposta dell'LLM attiva i filtri Model Armor.
customLlmResponseSafetyErrorMessage

string

Facoltativo. Indica il messaggio di errore personalizzato impostato dall'utente da restituire all'utente finale se la risposta dell'LLM attiva i filtri Model Armor.
logTemplateOperations

boolean

Facoltativo. Se true, registra le operazioni di creazione, modifica e eliminazione del modello.
logSanitizeOperations

boolean

Facoltativo. Se true, registra le operazioni di sanitizzazione.

Metodi

create

 Crea un nuovo modello in un determinato progetto e posizione.

delete

 Consente di eliminare un singolo modello.

get

 Recupera i dettagli di un singolo modello.

list

 Elenca i modelli in un determinato progetto e località.

patch

 Aggiorna i parametri di un singolo modello.

sanitizeModelResponse

 Sanitizza la risposta del modello.

sanitizeUserPrompt

 Sanifica il prompt dell'utente.