Para começar a usar a Vertex AI, esta página mostra como criar um projeto do Google Cloud e ativar as APIs da Vertex AI. Se você não tiver permissões para executar essas tarefas, peça a um administrador para configurar um projeto e ativar a Vertex AI para você. Nesta página, também mostramos como configurar a CLI do Google Cloud no seu ambiente de desenvolvimento local.
Configurar um projeto
Siga estas etapas para configurar um projeto:
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Vertex AI API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Update and install
gcloud
components:gcloud components update
gcloud components install beta -
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Vertex AI API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Update and install
gcloud
components:gcloud components update
gcloud components install beta
Ativar APIs da Vertex AI
- No console do Google Cloud, verifique se o nome do seu projeto é exibido na parte superior do console do Google Cloud. Se não estiver, clique em Selecionar um projeto para abrir o Seletor de projetos e escolha o projeto pretendido.
- Se você não estiver na parte da Vertex AI do console do Google Cloud,
faça o seguinte:
- Em Pesquisar, insira "Vertex AI" e retorne
- Nos resultados da pesquisa, clique em Vertex AI
O painel da Vertex AI será exibido.
- Clique em Ativar todas as APIs recomendadas no painel da Vertex AI.
O processo de ativação pode levar alguns instantes para ser concluído. Um anel azul ao redor do ícone de sino aparece no canto superior direito do console do Google Cloud à medida que as APIs estão sendo ativadas.
Instalar a CLI do Google Cloud
- Para ativar os serviços do Google Cloud e ter acesso a ferramentas úteis, como a gsutil, que permite a transferência de arquivos de e para o Cloud Storage, instale a CLI do Google Cloud.
- Para inicializar a gcloud CLI, execute o seguinte comando no prompt de comando:
gcloud init
- Para atualizar e instalar componentes Beta da CLI Google Cloud, execute o seguinte:
gcloud components update
gcloud components install beta
Pedir a um administrador para configurar um projeto da Vertex AI para você
Nesta seção, descrevemos como um administrador concede os papéis necessários para usar a Vertex AI.
- Determine um nome e ID de projeto significativos para facilitar a identificação. Se você faz parte de uma organização ou planeja criar vários projetos, considere quais convenções de nomenclatura e hierarquias de pasta são seguidas ou podem ser seguidas, para deixar a organização do projeto clara.
- Papéis necessários:
- O acesso à maioria dos recursos da Vertex AI é concedido pelo papel do IAM
Usuário da Vertex AI
(roles/aiplatform.user)
e é suficiente para a maioria dos usuários da Vertex AI. Para ter controle total dos recursos da Vertex AI, solicite o papel Administrador da Vertex AI(roles/aiplatform.admin)
. Para entender as diferenças entre esses e outros papéis da Vertex AI, consulte Controle de acesso da Vertex AI com IAM. - Se você também pretende usar os
notebooks do Vertex AI Workbench
no Google Cloud, peça para o administrador conceder a você o papel do IAM de
administrador de notebooks
(roles/notebooks.admin)
para o projeto, bem como o papel do IAM de usuário da conta de serviço(roles/iam.serviceAccountUser)
no projeto ou no Conta de serviço padrão do Compute Engine. - Além disso, para ativar as APIs necessárias, você precisa do papel do IAM de
Administrador do Service Usage
(roles/serviceusage.serviceUsageAdmin)
ou seu administrador precisa ativar as APIs para você, seguindo as primeiras etapas.
- O acesso à maioria dos recursos da Vertex AI é concedido pelo papel do IAM
Usuário da Vertex AI
- Peça para o administrador ativar as APIs Vertex AI para você.
Se você recebeu o papel do IAM
(roles/serviceusage.serviceUsageAdmin)
de Administrador do Service Usage, poderá fazer isso por conta própria seguindo a seção Ativar as APIs Vertex AI.
A seguir
Leia uma visão geral da Vertex AI.
Siga um dos tutoriais para saber como usar a Vertex AI.
Saiba como usar o SDK da Vertex AI para Python, que fornece outra maneira de interagir com a Vertex AI.