Inizia a utilizzare Model Armor

Questa pagina descrive le autorizzazioni richieste per Model Armor e fornisce istruzioni per attivare e disattivare Model Armor.

Autorizzazioni obbligatorie

Controlli l'accesso a Model Armor utilizzando i ruoli IAM. I seguenti ruoli concedono l'accesso alle funzionalità di Model Armor:

Ruolo Autorizzazioni
Amministratori e proprietari

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
Utenti e applicazioni che pianificano di filtrare i prompt e le risposte

modelarmor.user

 resourcemanager.projects.get
resourcemanager.projects.list
modelarmor.templates.useToSanitizeUserPrompt
modelarmor.templates.useToSanitizeModelResponse
Visualizzatori di modelli (rivelatori e soglie)

modelarmor.viewer

 resourcemanager.projects.get
resourcemanager.projects.list
modelarmor.templates.get
modelarmor.templates.list
Amministratori e proprietari

modelarmor.floorSettingsAdmin

 resourcemanager.projects.get
resourcemanager.projects.list
resourcemanager.folders.get
resourcemanager.folders.list
resourcemanager.organizations.get
modelarmor.floorSettings.get
modelarmor.floorSettings.update
Visualizzatori delle impostazioni di base

modelarmor.floorSettingsViewer

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

Attivare Model Armor

Per poter utilizzare Model Armor, devi abilitare le API Model Armor.

Console

  1. Nella Google Cloud console, vai alla pagina Model Armor.
  2. Fai clic su Abilita le API Model Armor.

gcloud

Prima di iniziare, segui questi passaggi utilizzando lo strumento a riga di comando Google Cloud CLI con l'API Model Armor:

  1. Esegui il comando gcloud auth login per autenticare il tuo account Google Cloud in modo che lo strumento gcloud CLI possa interagire con i servizi Google Cloud per tuo conto.

  2. Esegui il seguente comando per impostare il progetto Google Cloud predefinito per lo strumento Google Cloud CLI.

    gcloud config set project PROJECT_ID

    Sostituisci PROJECT_ID con l'ID effettivo del tuo progetto.

  3. Esegui il seguente 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.

Attivare Model Armor

Esegui il comando seguente per attivare Model Armor.

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

Sostituisci PROJECT_ID con l'ID del progetto.

Disattivare Model Armor

Esegui il seguente comando per disattivare Model Armor.

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

Sostituisci PROJECT_ID con l'ID del progetto.

Inizializzare un client Model Armor in Python

Esegui i seguenti comandi per inizializzare un client per interagire con l'API Model Armor.

  • Per l'endpoint 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"})

  • Per l'endpoint modelarmor.googleapis.com:

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

Passaggi successivi