Questo documento spiega come visualizzare e aggiornare le impostazioni di base di Model Armor e fornisce un esempio di violazione di un'impostazione di base.
Le impostazioni di base di Model Armor definiscono regole che specificano i requisiti minimi per tutti i modelli Model Armor creati in un punto specifico della gerarchia delle risorse (ovvero a livello di organizzazione, cartella o progetto). Google Cloud Se più impostazioni del prezzo minimo sono in conflitto, hanno la precedenza quelle più in basso nella gerarchia delle risorse. Ad esempio, se viene creato un criterio di impostazione del prezzo minimo a livello di cartella e progetto, viene applicato il criterio a livello di progetto. Questo comportamento si applica solo ai progetti che si trovano all'interno di questa cartella specifica.
Ad esempio, supponiamo di aver impostato un criterio a livello di cartella su una cartella specifica, attivando un filtro URI dannoso per tutti i contenuti al suo interno. Poi, all'interno della stessa cartella, hai un progetto specifico. In questo progetto hai configurato un criterio più specifico a livello di progetto. Questa norma a livello di progetto richiede il rilevamento di prompt injection e jailbreaking con una soglia di affidabilità media.
Il risultato è il seguente:
Qualsiasi modello Model Armor creato all'interno di questo progetto specifico deve includere il filtro di rilevamento di prompt injection e jailbreaking, impostato con almeno una soglia di confidenza media. Questo perché il criterio a livello di progetto stabilisce un requisito minimo per tutti i modelli all'interno del progetto.
I modelli creati al di fuori della cartella principale di questo progetto non sono interessati dalle norme specifiche della cartella. Pertanto, se crei un modello in una cartella diversa o a livello di root, non verrà richiesto automaticamente il filtro URI dannosi impostato per questa cartella specifica. Ciò evidenzia che queste norme sono limitate al loro livello gerarchico specifico e non si applicano a livello globale, a meno che non siano impostate a un livello organizzativo più alto e più ampio.
Le impostazioni di base aiutano i CISO e gli architetti della sicurezza a imporre una postura di sicurezza minima per tutti i modelli Model Armor della loro organizzazione. Queste impostazioni aiutano a impedire agli sviluppatori di compromettere gli standard di sicurezza. Se utilizzi il livello di servizio Premium o Enterprise di Security Command Center, le violazioni dell'impostazione del pavimento attivano i risultati. Se viene creato un modello con impostazioni meno restrittive prima di un'impostazione di base, Security Command Center mostra un risultato. Queste impostazioni ti aiutano a identificare e correggere i modelli Model Armor meno sicuri. Le impostazioni del piano non possono applicare Sensitive Data Protection.
Prima di iniziare
Prima di iniziare, completa le seguenti attività.
Ottenere le autorizzazioni richieste
Per ottenere le autorizzazioni
necessarie per gestire le impostazioni del pavimento,
chiedi all'amministratore di concederti il
ruolo IAM Model Armor Floor Setting Admin (roles/modelarmor.floorSettingsAdmin
)
sulle impostazioni del pavimento di Model Armor.
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Abilita API
Prima di poter utilizzare Model Armor, devi abilitare le API Model Armor.
Console
Enable the Model Armor API.
Seleziona il progetto in cui vuoi attivare Model Armor.
gcloud
Prima di iniziare, segui questi passaggi utilizzando Google Cloud CLI con l'API Model Armor:
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Esegui questo comando per impostare l'endpoint API per il servizio Model Armor.
gcloud config set api_endpoint_overrides/modelarmor "https://modelarmor.LOCATION.rep.googleapis.com/"
Sostituisci
LOCATION
con la regione in cui vuoi utilizzare Model Armor.- Nella console Google Cloud , vai alla pagina Model Armor.
- Seleziona un progetto.
- Nella pagina Model Armor, vai alla scheda Impostazioni di base e fai clic su Configura le impostazioni di base.
- Nella pagina Configura impostazioni piano, seleziona l'opzione di configurazione.
- Nella sezione Rilevamenti, configura le impostazioni di rilevamento.
- (Facoltativo) Se selezioni il rilevamento di Sensitive Data Protection, devi configurare le impostazioni di Sensitive Data Protection.
Nella sezione AI responsabile, imposta il livello di confidenza per ogni filtro dei contenuti.
Nella sezione Servizi, scegli i servizi in cui verranno applicate queste impostazioni di base.
Nella sezione Log, seleziona Abilita Cloud Logging per registrare tutti i prompt degli utenti, le risposte del modello e i risultati del rilevatore delle impostazioni di base.
Seleziona Abilita supporto di più lingue per utilizzare le impostazioni di rilevamento multilingue.
Fai clic su Salva impostazioni del piano.
Eredita le impostazioni di base del livello principale: eredita le impostazioni di base impostate a un livello superiore della gerarchia di risorse. Fai clic su Salva impostazioni del piano e salta i passaggi successivi. Per visualizzare le impostazioni ereditate, vai alla scheda Impostazioni del piano.
Personalizzato: definisci le impostazioni di base per questo progetto. Le impostazioni personalizzate che definisci per un progetto sostituiscono qualsiasi impostazione di base ereditata.
Disattiva: disattiva tutte le impostazioni di base ereditate, il che significa che non vengono applicate regole di rilevamento ai modelli Model Armor e a Vertex AI per i tuoi workload Gemini. Fai clic su Salva impostazioni del piano e salta i passaggi successivi. Visualizza lo stato di disattivazione nella scheda Impostazioni piano.
- Model Armor - Creazione e aggiornamento dei modelli: ogni modello Model Armor nuovo e modificato in un progetto viene controllato per assicurarsi che le impostazioni minime siano specificate in base alle impostazioni di base.
Vertex AI: filtra le richieste inviate ai modelli Gemini e registra o blocca quelle che soddisfano le soglie delle impostazioni di base.
Se selezioni Vertex AI, viene visualizzata la sezione Vertex AI, in cui puoi scegliere come applicare le impostazioni del prezzo minimo.
- Solo ispezione: rileva le richieste che non soddisfano le impostazioni di base, ma non bloccarle.
- Ispeziona e blocca le violazioni: rileva e blocca le richieste che non soddisfano le impostazioni di base.
Nella console Google Cloud , vai alla pagina Model Armor.
Verifica di visualizzare il progetto su cui hai attivato Model Armor.
Nella pagina Model Armor, vai alla scheda Impostazioni di base. Se le impostazioni del piano sono impostate a livello di organizzazione, puoi visualizzarle qui. Se non sono definite impostazioni di base, devi configurarle. Per saperne di più, vedi Configurare le impostazioni del piano.
Visualizza l'impostazione di base di Model Armor per un determinato progetto.
gcloud model-armor floorsettings describe \ --full-uri='projects/PROJECT_ID/locations/global/floorSetting'
Visualizza l'impostazione di base di Model Armor per una determinata organizzazione.
gcloud model-armor floorsettings describe \ --full-uri='organizations/ORGANIZATION_ID/locations/global/floorSetting'
Visualizza l'impostazione di base di Model Armor per una determinata cartella.
gcloud model-armor floorsettings describe \ --full-uri='folders/FOLDER_ID/locations/global/floorSetting'
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto per le impostazioni del piano.FOLDER_ID
: l'ID della cartella per le impostazioni del piano.ORGANIZATION_ID
: l'ID dell'organizzazione per le impostazioni del piano.
Visualizza l'impostazione di base di Model Armor per un determinato progetto.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://modelarmor.googleapis.com/v1/projects/PROJECT_ID/locations/global/floorSetting"
Visualizza l'impostazione di base di Model Armor per una determinata cartella.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://modelarmor.googleapis.com/v1/folders/FOLDER_ID/locations/global/floorSetting"
Visualizza l'impostazione di base di Model Armor per una determinata organizzazione.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://modelarmor.googleapis.com/v1/organizations/ORGANIZATION_ID/locations/global/floorSetting"
PROJECT_ID
: l'ID del progetto per le impostazioni del piano.FOLDER_ID
: l'ID della cartella per le impostazioni del piano.ORGANIZATION_ID
: l'ID dell'organizzazione per le impostazioni del piano.Visualizza l'impostazione di base di Model Armor per un determinato progetto.
Visualizza l'impostazione di base di Model Armor per una determinata cartella.
Visualizza l'impostazione di base di Model Armor per una determinata organizzazione.
Visualizza l'impostazione di base di Model Armor per un determinato progetto.
Visualizza l'impostazione di base di Model Armor per una determinata cartella.
Visualizza l'impostazione di base di Model Armor per una determinata organizzazione.
Visualizza l'impostazione di base di Model Armor per un determinato progetto.
Visualizza l'impostazione di base di Model Armor per una determinata cartella.
Visualizza l'impostazione di base di Model Armor per una determinata organizzazione.
Visualizza l'impostazione di base di Model Armor per un determinato progetto.
Visualizza l'impostazione di base di Model Armor per una determinata cartella.
Visualizza l'impostazione di base di Model Armor per una determinata organizzazione.
Visualizza l'impostazione di base di Model Armor per un determinato progetto.
Visualizza l'impostazione di base di Model Armor per una determinata cartella.
Visualizza l'impostazione di base di Model Armor per una determinata organizzazione.
Nella console Google Cloud , vai alla pagina Model Armor.
Verifica di visualizzare il progetto su cui hai attivato Model Armor.
Nella pagina Model Armor, vai alla scheda Impostazioni di base e fai clic su Configura le impostazioni di base.
Aggiorna i campi obbligatori e fai clic su Salva impostazioni del piano.
Aggiorna l'impostazione di base di Model Armor per un determinato progetto.
curl -X PATCH -d '{"filterConfig" :{"piAndJailbreakFilterSettings": { "filterEnforcement": "ENABLED"}, "maliciousUriFilterSettings": { "filterEnforcement": "ENABLED" }, "rai_settings":{"rai_filters":{"filter_type":"DANGEROUS", "confidence_level":"LOW_AND_ABOVE" }, \ "rai_filters":{"filter_type":"HATE_SPEECH", "confidence_level":"LOW_AND_ABOVE" }, "rai_filters":{"filter_type":"HARASSMENT", "confidence_level":"LOW_AND_ABOVE" }, "rai_filters":{"filter_type":"SEXUALLY_EXPLICIT", "confidence_level":"LOW_AND_ABOVE" }}},"enableFloorSettingEnforcement":"true"}' -H "Content-Type: application/json" -H "Authorization: Bearer $(gcloud auth print-access-token) "https://modelarmor.googleapis.com/v1/projects/PROJECT_ID/locations/global/floorSetting"
Aggiorna l'impostazione di base di Model Armor per una determinata cartella.
curl -X PATCH \ -d '{"filterConfig" :{"piAndJailbreakFilterSettings": { "filterEnforcement": "ENABLED"}, "maliciousUriFilterSettings": { "filterEnforcement": "ENABLED" }},"enableFloorSettingEnforcement":"true"}' \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://modelarmor.googleapis.com/v1/folders/FOLDER_ID/locations/global/floorSetting"
Aggiorna l'impostazione di base di Model Armor per una determinata organizzazione.
curl -X PATCH \ -d '{"filterConfig" :{"piAndJailbreakFilterSettings": { "filterEnforcement": "ENABLED"}, "maliciousUriFilterSettings": { "filterEnforcement": "ENABLED" }},"enableFloorSettingEnforcement":"true"}' \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://modelarmor.googleapis.com/v1/organizations/ORGANIZATION_ID/locations/global/floorSetting"
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto per le impostazioni del piano.FOLDER_ID
: l'ID della cartella per le impostazioni del piano.ORGANIZATION_ID
: l'ID dell'organizzazione per le impostazioni del piano.
Il comando di aggiornamento restituisce la seguente risposta:
{ "name": "projects/PROJECT_ID/locations/global/floorSetting", "updateTime": "2024-12-19T15:36:21.318191Z", "filterConfig": { "piAndJailbreakFilterSettings": { "filterEnforcement": "ENABLED" }, "maliciousUriFilterSettings": { "filterEnforcement": "ENABLED" } } }
Aggiorna l'impostazione di base di Model Armor per un determinato progetto.
Aggiorna l'impostazione di base di Model Armor per una determinata cartella.
Aggiorna l'impostazione di base di Model Armor per una determinata organizzazione.
Aggiorna l'impostazione di base di Model Armor per un determinato progetto.
Aggiorna l'impostazione di base di Model Armor per una determinata cartella.
Aggiorna l'impostazione di base di Model Armor per una determinata organizzazione.
Aggiorna l'impostazione di base di Model Armor per un determinato progetto.
Aggiorna l'impostazione di base di Model Armor per una determinata cartella.
Aggiorna l'impostazione di base di Model Armor per una determinata organizzazione.
Aggiorna l'impostazione di base di Model Armor per un determinato progetto.
Aggiorna l'impostazione di base di Model Armor per una determinata cartella.
Aggiorna l'impostazione di base di Model Armor per una determinata organizzazione.
Aggiorna l'impostazione di base di Model Armor per un determinato progetto.
Aggiorna l'impostazione di base di Model Armor per una determinata cartella.
Aggiorna l'impostazione di base di Model Armor per una determinata organizzazione.
- Scopri di più su Model Armor.
- Scopri di più sui modelli Model Armor.
- Sanifica prompt e risposte.
- Risolvi i problemi di Model Armor.
Esegui questo comando per attivare Model Armor.
gcloud services enable modelarmor.googleapis.com --project=PROJECT_ID
Sostituisci PROJECT_ID
con l'ID del progetto.
Integrazione con Vertex AI
Model Armor si integra con Vertex AI per esaminare le richieste e le risposte del modello Gemini in base alle impostazioni di base definite. Devi abilitare Cloud Logging per avere visibilità su prompt e risposte. Per ulteriori informazioni, consulta Integrazione di Model Armor con Vertex AI.
Configura impostazioni di base
Utilizzi le impostazioni di base per configurare le soglie minime di rilevamento per i modelli Model Armor. Queste impostazioni verificano che tutti i modelli nuovi e modificati soddisfino determinati requisiti. Per configurare le impostazioni di base:
Console
REST
curl -X PATCH \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -d '{"filterConfig" : {}, "integratedServices": "AI_PLATFORM", "aiPlatformFloorSetting":{"inspect_only":true, "enableCloudLogging":true}}' \ "https://modelarmor.googleapis.com/v1/projects/PROJECT_ID/locations/global/floorSetting"
Sostituisci PROJECT_ID
con l'ID del progetto per le impostazioni del piano.
Definisci come vengono ereditate le impostazioni di base
Quando configuri le impostazioni di base, seleziona l'opzione di configurazione.
Definisci dove vengono applicate le impostazioni di base
Seleziona uno dei seguenti servizi in cui vengono applicate le impostazioni di base configurate.
Visualizzare le impostazioni di base di Model Armor
Visualizza le impostazioni di base di Model Armor per verificare le impostazioni esistenti, per identificare i requisiti minimi per le tue applicazioni di AI o per risolvere i problemi quando un modello non si comporta come previsto.
Esegui questo comando per visualizzare le impostazioni del piano di Model Armor.
Console
gcloud
REST
Sostituisci quanto segue:
Vai
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Go e installare l'SDK Model Armor Go.
Java
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Java e installare l'SDK Java Model Armor.
Node.js
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Node.js e installare l'SDK Node.js di Model Armor.
PHP
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo PHP e installare l'SDK PHP Model Armor.
Python
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Python e installare l'SDK Python di Model Armor.
Aggiornare le impostazioni di base di Model Armor
Aggiorna le impostazioni di base di Model Armor per modificare i requisiti minimi dei modelli in modo che riflettano le modifiche alle norme di sicurezza, per correggere configurazioni errate o per risolvere i conflitti tra le impostazioni di base.
Esegui questo comando per aggiornare le impostazioni del piano di Model Armor.
Console
gcloud
gcloud model-armor floorsettings update --full-uri=<full-uri-of-the-floorsetting>
Comando di esempio:
gcloud model-armor floorsettings update \
--malicious-uri-filter-settings-enforcement=ENABLED \
--pi-and-jailbreak-filter-settings-enforcement=DISABLED \
--pi-and-jailbreak-filter-settings-confidence-level=LOW_AND_ABOVE \
--basic-config-filter-enforcement=ENABLED \
--add-rai-settings-filters='[{"confidenceLevel": "low_and_above", "filterType": "HARASSMENT"}, {"confidenceLevel": "high", "filterType": "SEXUALLY_EXPLICIT"}]'
--full-uri='folders/FOLDER_ID/locations/global/floorSetting' \
--enable-floor-setting-enforcement=true
Sostituisci FOLDER_ID
con l'ID della cartella per le impostazioni del piano.
REST
Vai
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Go e installare l'SDK Model Armor Go.
Java
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Java e installare l'SDK Java Model Armor.
Node.js
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Node.js e installare l'SDK Node.js di Model Armor.
PHP
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo PHP e installare l'SDK PHP Model Armor.
Python
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Python e installare l'SDK Python di Model Armor.
Esaminare i risultati relativi alla violazione dell'impostazione eCPM Floor
Ogni risultato di Model Armor identifica una violazione dell'impostazione di base. Una violazione si verifica quando un modello Model Armor non soddisfa gli standard minimi di sicurezza definiti dalle impostazioni di base della gerarchia delle risorse. Le impostazioni di base definiscono i requisiti minimi per i modelli. Una violazione dell'impostazione del limite inferiore potrebbe comportare l'assenza di filtri obbligatori in un modello o il mancato raggiungimento del livello di confidenza minimo per questi filtri. Quando viene rilevata una violazione, in Security Command Center viene generato un risultato di gravità elevata. Il risultato specifica l'impostazione di base violata, il modello non conforme e i dettagli della violazione.
L'esempio seguente mostra il campo sourceProperties
del risultato. Questa
violazione, relativa al filtro URI dannosi, si è verificata
perché l'impostazione del modello per maliciousUriFilterSettings
è
DISABLED
, ma le impostazioni del piano richiedono che sia ENABLED
.
{ "filterConfig": { "raiSettings": { "raiFilters": [ { "filterType": "HATE_SPEECH", "confidenceLevel": { "floorSettings": "LOW_AND_ABOVE", "template": "MEDIUM_AND_ABOVE" } }, { "filterType": "HARASSMENT", "confidenceLevel": { "floorSettings": "MEDIUM_AND_ABOVE", "template": "HIGH" } } ] }, "piAndJailbreakFilterSettings": { "confidenceLevel": { "floorSettings": "LOW_AND_ABOVE", "template": "HIGH" } }, "maliciousUriFilterSettings": { "floorSettings": "ENABLED", "template": "DISABLED" } } }
Passaggi successivi
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-09-05 UTC.