Comienza a usar Model Armor

En esta página, se detallan los permisos necesarios para Model Armor y se proporcionan instrucciones para habilitarlo y inhabilitarlo.

Permisos necesarios

Puedes controlar el acceso a Model Armor con roles de IAM. Los siguientes roles otorgan acceso a las funciones de Model Armor:

Rol Permisos
Administradores y propietarios

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
Usuarios y aplicaciones que planean filtrar instrucciones y respuestas

modelarmor.user

 resourcemanager.projects.get
resourcemanager.projects.list
modelarmor.templates.useToSanitizeUserPrompt
modelarmor.templates.useToSanitizeModelResponse
Visores de plantillas (detectores y umbrales)

modelarmor.viewer

 resourcemanager.projects.get
resourcemanager.projects.list
modelarmor.templates.get
modelarmor.templates.list
Administradores y propietarios

modelarmor.floorSettingsAdmin

 resourcemanager.projects.get
resourcemanager.projects.list
resourcemanager.folders.get
resourcemanager.folders.list
resourcemanager.organizations.get
modelarmor.floorSettings.get
modelarmor.floorSettings.update
Visualizadores de configuración de límites

modelarmor.floorSettingsViewer

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

Habilita Model Armor

Debes habilitar las APIs de Model Armor para poder usarlas.

Console

  1. En la consola de Google Cloud , ve a la página Model Armor.
  2. Haz clic en Habilitar las APIs de Model Armor.

gcloud

Antes de comenzar, sigue estos pasos con la herramienta de línea de comandos de Google Cloud CLI con la API de Model Armor:

  1. Ejecuta el comando gcloud auth login para autenticar tu cuenta de Google Cloud de modo que la herramienta Google Cloud CLI pueda interactuar con los servicios de Google Cloud en tu nombre.

  2. Ejecuta el siguiente comando para establecer el proyecto Google Cloud predeterminado de la herramienta Google Cloud CLI.

    gcloud config set project PROJECT_ID

    Reemplaza PROJECT_ID por el ID real de tu proyecto.

  3. Ejecuta el siguiente comando para establecer el extremo de la API del servicio de Model Armor.

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

    Reemplaza LOCATION por la región en la que deseas usar Model Armor.

Habilita Model Armor

Ejecuta el siguiente comando para habilitar Model Armor.

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

Reemplaza PROJECT_ID por el ID del proyecto.

Inhabilita Model Armor

Ejecuta el siguiente comando para inhabilitar Model Armor.

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

Reemplaza PROJECT_ID por el ID del proyecto.

Cómo inicializar un cliente de Model Armor en Python

Ejecuta los siguientes comandos para inicializar un cliente para interactuar con la API de Model Armor.

  • Para el extremo modelarmor.LOCATION.rep.googleapis.com, haz lo siguiente:

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

  • Para el extremo modelarmor.googleapis.com, haz lo siguiente:

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

¿Qué sigue?