开始使用 Model Armor

本页面详细介绍了 Model Armor 所需的权限，并提供了启用和停用 Model Armor 的说明。

所需权限

您可以使用 IAM 角色控制对 Model Armor 的访问权限。以下角色可授予对 Model Armor 功能的访问权限：

角色 权限
管理员和所有者

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
计划过滤提示和回答的用户和应用

modelarmor.user

 resourcemanager.projects.get
resourcemanager.projects.list
modelarmor.templates.useToSanitizeUserPrompt
modelarmor.templates.useToSanitizeModelResponse
模板查看者（检测器和阈值）

modelarmor.viewer

 resourcemanager.projects.get
resourcemanager.projects.list
modelarmor.templates.get
modelarmor.templates.list
管理员和所有者

modelarmor.floorSettingsAdmin

 resourcemanager.projects.get
resourcemanager.projects.list
resourcemanager.folders.get
resourcemanager.folders.list
resourcemanager.organizations.get
modelarmor.floorSettings.get
modelarmor.floorSettings.update
下限设置查看者

modelarmor.floorSettingsViewer

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

启用 Model Armor

您必须先启用 Model Armor API，然后才能使用 Model Armor。

控制台

  1. 在 Google Cloud 控制台中，前往 Model Armor 页面。
  2. 点击启用 Model Armor API。

gcloud

在开始之前，请使用 Google Cloud CLI 命令行工具和 Model Armor API 按照以下步骤操作：

  1. 运行 gcloud auth login 命令以对您的 Google Cloud账号进行身份验证，以便 Google Cloud CLI 工具能够代表您与 Google Cloud服务进行交互。

  2. 运行以下命令，为 Google Cloud CLI 工具设置默认 Google Cloud 项目。

    gcloud config set project PROJECT_ID

    将 PROJECT_ID 替换为您的项目的实际 ID。

  3. 运行以下命令，为 Model Armor 服务设置 API 端点。

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

    将 LOCATION 替换为您要使用 Model Armor 的区域。

启用 Model Armor

运行以下命令以启用 Model Armor。

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

将 PROJECT_ID 替换为相应项目的 ID。

停用 Model Armor

运行以下命令以停用 Model Armor。

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

将 PROJECT_ID 替换为相应项目的 ID。

在 Python 中初始化 Model Armor 客户端

运行以下命令以初始化用于与 Model Armor API 互动的客户端。

  • 对于 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"})

  • 对于 modelarmor.googleapis.com 端点：

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

后续步骤