Ce document explique comment afficher et modifier les paramètres de plancher Model Armor, et fournit un exemple de non-respect de ces paramètres.
Les paramètres de plancher Model Armor définissent des règles qui spécifient les exigences minimales pour tous les modèles Model Armor créés à un point spécifique de la hiérarchie des ressources Google Cloud (c'est-à-dire au niveau d'une organisation, d'un dossier ou d'un projet). Si plusieurs paramètres d'étage sont en conflit, ceux qui se trouvent plus bas dans la hiérarchie des ressources sont prioritaires. Par exemple, si une règle de paramètre de plancher est créée au niveau d'un dossier et d'un projet, la règle au niveau du projet est appliquée. Ce comportement ne s'applique qu'aux projets qui se trouvent dans ce dossier spécifique.
Par exemple, supposons que vous ayez défini une règle au niveau d'un dossier spécifique, en activant un filtre d'URI malveillants pour tout le contenu qu'il contient. Ensuite, dans ce même dossier, vous avez un projet spécifique. Vous avez configuré une règle plus spécifique au niveau du projet. Cette règle au niveau du projet exige la détection des injections de prompts et des tentatives de jailbreaking avec un seuil de confiance moyen.
Le résultat est le suivant :
Tout modèle Model Armor créé dans ce projet spécifique doit inclure le filtre de détection de l'injection de requêtes et du jailbreaking, défini avec un seuil de confiance au moins moyen. En effet, la stratégie au niveau du projet établit une exigence minimale pour tous les modèles de ce projet.
Les modèles créés en dehors du dossier parent de ce projet ne sont pas concernés par les règles de ce dossier spécifique. Par conséquent, si vous créez un modèle dans un autre dossier ou au niveau racine, le filtre d'URI malveillants défini pour ce dossier spécifique ne sera pas automatiquement requis. Cela souligne que ces règles sont limitées à leur niveau hiérarchique spécifique et ne s'appliquent pas globalement, sauf si elles sont définies à un niveau organisationnel plus élevé et plus large.
Les paramètres de plancher aident les responsables de la sécurité des systèmes d'information et les architectes de sécurité à appliquer une posture de sécurité minimale à tous les modèles Model Armor de leur organisation. Ces paramètres permettent d'empêcher les développeurs de compromettre les normes de sécurité. Si vous utilisez le niveau de service Premium ou Enterprise de Security Command Center, les non-respects des paramètres de seuil déclenchent des résultats. Si un modèle avec des paramètres moins restrictifs est créé avant un paramètre de plancher, Security Command Center génère un résultat. Ces paramètres vous aident à identifier et à corriger les modèles Model Armor moins sécurisés. Les paramètres de base ne peuvent pas appliquer la protection des données sensibles.
Avant de commencer
Avant de commencer, effectuez les tâches suivantes.
Obtenir les autorisations requises
Pour obtenir les autorisations nécessaires pour gérer les paramètres de seuil, demandez à votre administrateur de vous accorder le rôle IAM Administrateur des paramètres de seuil Model Armor (roles/modelarmor.floorSettingsAdmin
) sur les paramètres de seuil Model Armor.
Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.
Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.
Activer les API
Vous devez activer les API Model Armor avant de pouvoir utiliser Model Armor.
Console
Enable the Model Armor API.
Sélectionnez le projet dans lequel vous souhaitez activer Model Armor.
gcloud
Avant de commencer, suivez ces étapes à l'aide de la Google Cloud CLI avec 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.
Exécutez la commande suivante pour définir le point de terminaison de l'API pour le service Model Armor.
gcloud config set api_endpoint_overrides/modelarmor "https://modelarmor.LOCATION.rep.googleapis.com/"
Remplacez
LOCATION
par la région dans laquelle vous souhaitez utiliser Model Armor.- Dans la console Google Cloud , accédez à la page Model Armor.
- Sélectionnez un projet.
- Sur la page Model Armor, accédez à l'onglet Paramètres de plancher, puis cliquez sur Configurer les paramètres de plancher.
- Sur la page Configurer les paramètres de l'étage, sélectionnez l'option de configuration.
- Dans la section Détections, configurez les paramètres de détection.
- Facultatif : Si vous sélectionnez la détection Sensitive Data Protection, vous devez configurer les paramètres Sensitive Data Protection.
Dans la section IA responsable, définissez le niveau de confiance pour chaque filtre de contenu.
Dans la section Services, choisissez les services auxquels ces paramètres de plancher s'appliqueront.
Dans la section Journaux, sélectionnez Activer Cloud Logging pour consigner toutes les requêtes utilisateur, les réponses du modèle et les résultats du détecteur de paramètres de plancher.
Sélectionnez Activer la compatibilité multilingue pour utiliser les paramètres de détection multilingue.
Cliquez sur Enregistrer les paramètres de l'étage.
Hériter des paramètres de plancher du parent : hérite des paramètres de plancher définis plus haut dans la hiérarchie des ressources. Cliquez sur Enregistrer les paramètres du sol et ignorez les étapes suivantes. Pour afficher les paramètres hérités, accédez à l'onglet Paramètres de l'étage.
Personnalisé : définissez les paramètres de plancher pour ce projet. Les paramètres personnalisés que vous définissez pour un projet remplacent tous les paramètres de plancher hérités.
Désactiver : désactive tous les paramètres de plancher hérités. Aucune règle de détection n'est donc appliquée aux modèles Model Armor ni à Vertex AI pour vos charges de travail Gemini. Cliquez sur Enregistrer les paramètres de l'étage et ignorez les étapes suivantes. Consultez l'état désactivé dans l'onglet Paramètres de l'étage.
- Model Armor – Création et modification de modèles : chaque modèle Model Armor nouveau ou modifié dans un projet est vérifié pour s'assurer que les paramètres minimaux sont spécifiés conformément aux paramètres de plancher.
Vertex AI : examine les requêtes envoyées aux modèles Gemini et consigne ou bloque celles qui atteignent les seuils des paramètres de base.
Si vous sélectionnez Vertex AI, la section Vertex AI s'affiche. Vous pouvez y choisir comment les paramètres de plancher sont appliqués.
- Inspecter uniquement : détecte les requêtes qui ne respectent pas les paramètres de plancher, sans les bloquer.
- Inspecter et bloquer les non-respects : détecter et bloquer les demandes qui ne respectent pas les paramètres de plancher.
Dans la console Google Cloud , accédez à la page Model Armor.
Vérifiez que vous consultez le projet sur lequel vous avez activé Model Armor.
Sur la page Model Armor, accédez à l'onglet Paramètres de plancher. Si des paramètres de plancher sont définis au niveau de l'organisation, vous pouvez les consulter ici. Si aucun paramètre de plancher n'est défini, vous devez les configurer. Pour en savoir plus, consultez Configurer les paramètres des étages.
Affichez le paramètre de plancher Model Armor pour un projet donné.
gcloud model-armor floorsettings describe \ --full-uri='projects/PROJECT_ID/locations/global/floorSetting'
Affichez le paramètre de plancher Model Armor pour une organisation donnée.
gcloud model-armor floorsettings describe \ --full-uri='organizations/ORGANIZATION_ID/locations/global/floorSetting'
Affichez le paramètre de plancher Model Armor pour un dossier donné.
gcloud model-armor floorsettings describe \ --full-uri='folders/FOLDER_ID/locations/global/floorSetting'
Remplacez les éléments suivants :
PROJECT_ID
: ID du projet pour les paramètres de l'étage.FOLDER_ID
: ID du dossier pour les paramètres de plancher.ORGANIZATION_ID
: ID de l'organisation pour les paramètres de base.
Affichez le paramètre de plancher Model Armor pour un projet donné.
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"
Affichez le paramètre de plancher Model Armor pour un dossier donné.
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"
Affichez le paramètre de plancher Model Armor pour une organisation donnée.
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
: ID du projet pour les paramètres de l'étage.FOLDER_ID
: ID du dossier pour les paramètres de plancher.ORGANIZATION_ID
: ID de l'organisation pour les paramètres de base.Affichez le paramètre de plancher Model Armor pour un projet donné.
Affichez le paramètre de plancher Model Armor pour un dossier donné.
Affichez le paramètre de plancher Model Armor pour une organisation donnée.
Affichez le paramètre de plancher Model Armor pour un projet donné.
Affichez le paramètre de plancher Model Armor pour un dossier donné.
Affichez le paramètre de plancher Model Armor pour une organisation donnée.
Affichez le paramètre de plancher Model Armor pour un projet donné.
Affichez le paramètre de plancher Model Armor pour un dossier donné.
Affichez le paramètre de plancher Model Armor pour une organisation donnée.
Affichez le paramètre de plancher Model Armor pour un projet donné.
Affichez le paramètre de plancher Model Armor pour un dossier donné.
Affichez le paramètre de plancher Model Armor pour une organisation donnée.
Affichez le paramètre de plancher Model Armor pour un projet donné.
Affichez le paramètre de plancher Model Armor pour un dossier donné.
Affichez le paramètre de plancher Model Armor pour une organisation donnée.
Dans la console Google Cloud , accédez à la page Model Armor.
Vérifiez que vous consultez le projet sur lequel vous avez activé Model Armor.
Sur la page Model Armor, accédez à l'onglet Paramètres de plancher, puis cliquez sur Configurer les paramètres de plancher.
Mettez à jour les champs obligatoires, puis cliquez sur Enregistrer les paramètres de l'étage.
Mettez à jour le paramètre de plancher Model Armor pour un projet donné.
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"
Mettez à jour le paramètre de plancher Model Armor pour un dossier donné.
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"
Mettez à jour le paramètre de plancher Model Armor pour une organisation donnée.
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"
Remplacez les éléments suivants :
PROJECT_ID
: ID du projet pour les paramètres de l'étage.FOLDER_ID
: ID du dossier pour les paramètres de plancher.ORGANIZATION_ID
: ID de l'organisation pour les paramètres de base.
La commande de mise à jour renvoie la réponse suivante :
{ "name": "projects/PROJECT_ID/locations/global/floorSetting", "updateTime": "2024-12-19T15:36:21.318191Z", "filterConfig": { "piAndJailbreakFilterSettings": { "filterEnforcement": "ENABLED" }, "maliciousUriFilterSettings": { "filterEnforcement": "ENABLED" } } }
Mettez à jour le paramètre de plancher Model Armor pour un projet donné.
Mettez à jour le paramètre de plancher Model Armor pour un dossier donné.
Mettez à jour le paramètre de plancher Model Armor pour une organisation donnée.
Mettez à jour le paramètre de plancher Model Armor pour un projet donné.
Mettez à jour le paramètre de plancher Model Armor pour un dossier donné.
Mettez à jour le paramètre de plancher Model Armor pour une organisation donnée.
Mettez à jour le paramètre de plancher Model Armor pour un projet donné.
Mettez à jour le paramètre de plancher Model Armor pour un dossier donné.
Mettez à jour le paramètre de plancher Model Armor pour une organisation donnée.
Mettez à jour le paramètre de plancher Model Armor pour un projet donné.
Mettez à jour le paramètre de plancher Model Armor pour un dossier donné.
Mettez à jour le paramètre de plancher Model Armor pour une organisation donnée.
Mettez à jour le paramètre de plancher Model Armor pour un projet donné.
Mettez à jour le paramètre de plancher Model Armor pour un dossier donné.
Mettez à jour le paramètre de plancher Model Armor pour une organisation donnée.
- En savoir plus sur Model Armor
- En savoir plus sur les modèles Model Armor
- Nettoyer les requêtes et les réponses
- Résoudre les problèmes liés à Model Armor
Exécutez la commande suivante pour activer Model Armor.
gcloud services enable modelarmor.googleapis.com --project=PROJECT_ID
Remplacez PROJECT_ID
par l'ID du projet.
Intégration à Vertex AI
Model Armor s'intègre à Vertex AI pour analyser les requêtes et les réponses du modèle Gemini en fonction des paramètres de seuil que vous avez définis. Vous devez activer Cloud Logging pour obtenir de la visibilité sur les requêtes et les réponses. Pour en savoir plus, consultez Intégration de Model Armor à Vertex AI.
Configurer les paramètres de plancher
Vous utilisez les paramètres de plancher pour configurer les seuils de détection minimaux pour les modèles Model Armor. Ces paramètres permettent de vérifier que tous les modèles nouveaux et modifiés respectent certaines exigences. Pour configurer les paramètres de plancher, procédez comme suit :
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"
Remplacez PROJECT_ID
par l'ID du projet pour les paramètres de plancher.
Définir la façon dont les paramètres de plancher sont hérités
Lorsque vous configurez les paramètres de plancher, sélectionnez l'option de configuration.
Définir où les paramètres de plancher sont appliqués
Sélectionnez l'un des services suivants auxquels les paramètres de plancher configurés sont appliqués.
Afficher les paramètres de plancher Model Armor
Affichez les paramètres de plancher de Model Armor pour vérifier les paramètres existants, identifier les exigences minimales pour vos applications d'IA ou résoudre les problèmes lorsqu'un modèle ne se comporte pas comme prévu.
Exécutez la commande suivante pour afficher les paramètres de protection du modèle.
Console
gcloud
REST
Remplacez les éléments suivants :
Go
Pour exécuter ce code, commencez par configurer un environnement de développement Go et installez le SDK Model Armor pour Go.
Java
Pour exécuter ce code, commencez par configurer un environnement de développement Java et installez le SDK Model Armor pour Java.
Node.js
Pour exécuter ce code, commencez par configurer un environnement de développement Node.js et installez le SDK Model Armor pour Node.js.
PHP
Pour exécuter ce code, commencez par configurer un environnement de développement PHP et installez le SDK Model Armor pour PHP.
Python
Pour exécuter ce code, commencez par configurer un environnement de développement Python et installez le SDK Model Armor pour Python.
Mettre à jour les paramètres de plancher Model Armor
Mettez à jour les paramètres de plancher de Model Armor pour modifier les exigences minimales des modèles afin de refléter les modifications apportées aux règles de sécurité, corriger les erreurs de configuration ou résoudre les conflits entre les paramètres de plancher.
Exécutez la commande suivante pour mettre à jour les paramètres de protection du modèle.
Console
gcloud
gcloud model-armor floorsettings update --full-uri=<full-uri-of-the-floorsetting>
Exemple de commande :
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
Remplacez FOLDER_ID
par l'ID du dossier contenant les paramètres de l'étage.
REST
Go
Pour exécuter ce code, commencez par configurer un environnement de développement Go et installez le SDK Model Armor pour Go.
Java
Pour exécuter ce code, commencez par configurer un environnement de développement Java et installez le SDK Model Armor pour Java.
Node.js
Pour exécuter ce code, commencez par configurer un environnement de développement Node.js et installez le SDK Model Armor pour Node.js.
PHP
Pour exécuter ce code, commencez par configurer un environnement de développement PHP et installez le SDK Model Armor pour PHP.
Python
Pour exécuter ce code, commencez par configurer un environnement de développement Python et installez le SDK Model Armor pour Python.
Examiner les résultats concernant le non-respect des paramètres d'eCPM minimal
Chaque résultat Model Armor identifie une violation des paramètres de plancher. Un cas de non-respect se produit lorsqu'un modèle Model Armor ne respecte pas les normes de sécurité minimales définies par les paramètres plancher de la hiérarchie des ressources. Les paramètres plancher définissent les exigences minimales pour les modèles. Un non-respect du paramètre de seuil peut impliquer qu'un modèle ne comporte pas les filtres requis ou ne respecte pas le niveau de confiance minimal pour ces filtres. Lorsqu'une violation est détectée, un résultat de gravité élevée est généré dans Security Command Center. Le résultat indique le paramètre de plancher non respecté, le modèle non conforme et des informations sur le non-respect.
L'exemple suivant montre le champ sourceProperties
du résultat. Ce non-respect, lié au filtre d'URI malveillants, s'est produit parce que le paramètre de modèle pour maliciousUriFilterSettings
est DISABLED
, mais que les paramètres de plancher exigent qu'il soit 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" } } }
Étapes suivantes
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/05 (UTC).