Erste Schritte mit Model Armor

Auf dieser Seite finden Sie Informationen zu den für Model Armor erforderlichen Berechtigungen und eine Anleitung zum Aktivieren und Deaktivieren von Model Armor.

Erforderliche Berechtigungen

Sie steuern den Zugriff auf Model Armor mit IAM-Rollen. Die folgenden Rollen gewähren Zugriff auf die Model Armor-Funktionen:

Rolle Berechtigungen
Administratoren und Inhaber

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
Nutzer und Anwendungen, die Prompts und Antworten prüfen möchten

modelarmor.user

 resourcemanager.projects.get
resourcemanager.projects.list
modelarmor.templates.useToSanitizeUserPrompt
modelarmor.templates.useToSanitizeModelResponse
Vorlagenbetrachter (Detektoren und Grenzwerte)

modelarmor.viewer

 resourcemanager.projects.get
resourcemanager.projects.list
modelarmor.templates.get
modelarmor.templates.list
Administratoren und Inhaber

modelarmor.floorSettingsAdmin

 resourcemanager.projects.get
resourcemanager.projects.list
resourcemanager.folders.get
resourcemanager.folders.list
resourcemanager.organizations.get
modelarmor.floorSettings.get
modelarmor.floorSettings.update
Nutzer, die sich die Einstellungen für die Fußböden angesehen haben

modelarmor.floorSettingsViewer

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

Model Armor aktivieren

Sie müssen Model Armor APIs aktivieren, bevor Sie Model Armor verwenden können.

Console gcloud
  1. Rufen Sie in der Google Cloud Console die Seite Model Armor auf.
  2. Klicken Sie auf Model Armor APIs aktivieren.

Führen Sie vor Beginn die folgenden Schritte aus, um das Befehlszeilentool der Google Cloud CLI mit der Model Armor API zu verwenden:

  1. Führen Sie den Befehl gcloud auth login aus, um Ihr Google Cloud-Konto zu authentifizieren, damit das Google Cloud CLI-Tool in Ihrem Namen mit Google Cloud-Diensten interagieren kann.

  2. Führen Sie den folgenden Befehl aus, um das Standardprojekt für die Google Cloud CLI festzulegen. Google Cloud 

    gcloud config set project PROJECT_ID

    Ersetzen Sie PROJECT_ID durch die tatsächliche ID Ihres Projekts.

  3. Führen Sie den folgenden Befehl aus, um den API-Endpunkt für den Model Armor-Dienst festzulegen.

    gcloud config set api_endpoint_overrides/modelarmor "https://modelarmor.LOCATION.rep.googleapis.com/"

    Ersetzen Sie LOCATION durch die Region, in der Sie Model Armor verwenden möchten.

Model Armor aktivieren

Führen Sie den folgenden Befehl aus, um Model Armor zu aktivieren.

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

Ersetzen Sie PROJECT_ID durch die ID des Projekts.

Model Armor deaktivieren

Führen Sie den folgenden Befehl aus, um Model Armor zu deaktivieren.

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

Ersetzen Sie PROJECT_ID durch die ID des Projekts.

Model Armor-Client in Python initialisieren

Führen Sie die folgenden Befehle aus, um einen Client für die Interaktion mit der Model Armor API zu initialisieren.

  • Für den modelarmor.LOCATION.rep.googleapis.com-Endpunkt:

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

  • Für den modelarmor.googleapis.com-Endpunkt:

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

Nächste Schritte