開始使用 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 CLI 工具代表您與服務互動。 Google CloudGoogle 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"})

後續步驟