Premiers pas avec Model Armor

Cette page détaille les autorisations requises pour Model Armor et fournit des instructions pour activer et désactiver Model Armor.

Autorisations requises

Vous contrôlez l'accès à Model Armor à l'aide de rôles IAM. Les rôles suivants permettent d'accéder aux fonctionnalités Model Armor:

Rôle Autorisations
Administrateurs et propriétaires

modelarmor.admin

 resourcemanager.projects.get
resourcemanager.projects.list
modelarmor.templates.create
modelarmor.templates.update
modelarmor.templates.delete
resourcemanager.projects.get
resourcemanager.projects.list
modelarmor.templates.useToSanitizeUserPrompt
modelarmor.templates.useToSanitizeModelResponse
resourcemanager.projects.get
resourcemanager.projects.list
modelarmor.templates.get
modelarmor.templates.list
Utilisateurs et applications qui prévoient de filtrer les requêtes et les réponses

modelarmor.user

 resourcemanager.projects.get
resourcemanager.projects.list
modelarmor.templates.useToSanitizeUserPrompt
modelarmor.templates.useToSanitizeModelResponse
Lecteurs de modèles (détecteurs et seuils)

modelarmor.viewer

 resourcemanager.projects.get
resourcemanager.projects.list
modelarmor.templates.get
modelarmor.templates.list
Administrateurs et propriétaires

modelarmor.floorSettingsAdmin

 resourcemanager.projects.get
resourcemanager.projects.list
resourcemanager.folders.get
resourcemanager.folders.list
resourcemanager.organizations.get
modelarmor.floorSettings.get
modelarmor.floorSettings.update
Lecteurs de paramètres de plancher

modelarmor.floorSettingsViewer

 resourcemanager.projects.get
resourcemanager.projects.list
resourcemanager.folders.get
resourcemanager.folders.list
resourcemanager.organizations.get
modelarmor.floorSettings.get

Activer Model Armor

Vous devez activer les API Model Armor avant de pouvoir utiliser Model Armor.

Console

  1. Dans la Google Cloud console, accédez à la page Model Armor (Modèle d'armure).
  2. Cliquez sur Enable Model Armor APIs (Activer les API Model Armor).

gcloud

Avant de commencer, suivez ces étapes à l'aide de l'outil de ligne de commande Google Cloud CLI avec l'API Model Armor:

  1. Exécutez la commande gcloud auth login pour authentifier votre compte Google Cloudafin que l'outil Google Cloud CLI puisse interagir avec les services Google Clouden votre nom.

  2. Exécutez la commande suivante pour définir le projet Google Cloud par défaut pour l'outil Google Cloud CLI.

    gcloud config set project PROJECT_ID

    Remplacez PROJECT_ID par l'ID réel de votre projet.

  3. 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.

Activer 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.

Désactiver Model Armor

Exécutez la commande suivante pour désactiver Model Armor.

  gcloud services disable modelarmor.googleapis.com --project=PROJECT_ID

Remplacez PROJECT_ID par l'ID du projet.

Initialiser un client Model Armor en Python

Exécutez les commandes suivantes pour initialiser un client permettant d'interagir avec l'API Model Armor.

  • Pour le point de terminaison modelarmor.LOCATION.rep.googleapis.com:

    from google.cloud import modelarmor_v1
client = modelarmor_v1.ModelArmorClient(transport="rest", client_options = {"api_endpoint" : "modelarmor.LOCATION.rep.googleapis.com"})

  • Pour le point de terminaison modelarmor.googleapis.com:

    from google.cloud import modelarmor_v1
client = modelarmor_v1.ModelArmorClient(transport="rest", client_options = {"api_endpoint" : "modelarmor.googleapis.com"})

Étape suivante