Para ativar os modelos abertos e fazer uma solicitação de comando, um administrador do Google Cloud precisa definir as permissões necessárias e verificar se a política da organização permite o uso das APIs necessárias.
Definir as permissões necessárias para usar modelos abertos
Os seguintes papéis e permissões são necessários para usar modelos abertos:
É necessário ter o papel de Gerente de direito de compra do consumidor do Identity and Access Management (IAM). Qualquer pessoa que tenha esse papel pode ativar modelos abertos no Model Garden.
Você precisa ter a permissão
aiplatform.endpoints.predict
. Essa permissão está incluída no papel de IAM de usuário da Vertex AI. Para mais informações, consulte Usuário da Vertex AI e Controle de acesso.
Console
Para conceder os papéis de IAM do Gerente de direito de compra do consumidor a um usuário, acesse a página IAM.
Na coluna Principal, encontre a principal do usuário cujo acesso aos modelos abertos você quer ativar e clique em . Edite a principal nessa linha.
No painel Editar acesso, clique em
Adicionar novo papel.Em Selecionar uma função, escolha Gerente de direito de compra do consumidor.
No painel Editar acesso, clique em
Adicionar outro papel.Em Selecionar um papel, escolha Usuário da Vertex AI.
Clique em Salvar.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
Conceda o papel de gerente de direito de compra do consumidor necessário para ativar os modelos abertos no Model Garden
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=PRINCIPAL --role=roles/consumerprocurement.entitlementManager
Conceda o papel de usuário da Vertex AI que inclui a permissão
aiplatform.endpoints.predict
, necessária para fazer solicitações de comando:gcloud projects add-iam-policy-binding PROJECT_ID \ --member=PRINCIPAL --role=roles/aiplatform.user
Substitua
PRINCIPAL
pelo identificador do principal. O identificador tem o formatouser|group|serviceAccount:email
oudomain:domain
, por exemplo,user:cloudysanfrancisco@gmail.com
,group:admins@example.com
,serviceAccount:test123@example.domain.com
oudomain:example.domain.com
.A saída é uma lista de vinculações de política que inclui o seguinte:
- members: - user:PRINCIPAL role: roles/roles/consumerprocurement.entitlementManager
Para mais informações, consulte Conceder um único papel e
gcloud projects add-iam-policy-binding
.
Definir a política da organização para o acesso ao modelo aberto
Para ativar os modelos abertos, a política da organização precisa permitir a seguinte
API: API Cloud Commerce Consumer Procurement - cloudcommerceconsumerprocurement.googleapis.com
Se a organização definir uma política para
restringir o uso do serviço,
um administrador da organização precisará verificar se
cloudcommerceconsumerprocurement.googleapis.com
é permitido ao
definir a política da organização.
Além disso, se você tiver uma política da organização que restringe o uso de modelos no Model Garden, ela precisará permitir o acesso aos modelos abertos. Para mais informações, consulte Controlar o acesso ao modelo.
A seguir
- Saiba como fazer uma chamada de APIs MaaS para modelos abertos.