Per iniziare a utilizzare Vertex AI, questa pagina ti guida nella creazione di un progetto e nell'attivazione delle API Vertex AI. Google Cloud Se non disponi delle autorizzazioni per eseguire queste attività, chiedi a un amministratore di configurare un progetto e abilitare Vertex AI per te. Questa pagina illustra anche come configurare Google Cloud CLI nel tuo ambiente di sviluppo locale.
Configura un progetto
Per configurare un progetto, segui questi passaggi:
- 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.
-
Verify that billing is enabled for your Google Cloud project.
-
Enable the Vertex AI API.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Verify that billing is enabled for your Google Cloud project.
-
Enable the Vertex AI API.
-
Install the Google Cloud CLI.
-
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere alla gcloud CLI con la tua identità federata.
-
Dopo aver inizializzato gcloud CLI, aggiornala e installa i componenti richiesti:
gcloud components update gcloud components install beta
-
Install the Google Cloud CLI.
-
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere alla gcloud CLI con la tua identità federata.
-
Dopo aver inizializzato gcloud CLI, aggiornala e installa i componenti richiesti:
gcloud components update gcloud components install beta
- Determina un nome e un ID progetto significativi per identificare il tuo progetto. Se fai parte di un'organizzazione o prevedi di creare più progetti, valuta quali convenzioni di denominazione e gerarchie di cartelle vengono seguite o potrebbero essere seguite per rendere chiara l'organizzazione dei progetti.
- Ruoli richiesti:
- L'accesso alla maggior parte delle funzionalità di Vertex AI viene concesso dal ruolo IAM Vertex AI User
(roles/aiplatform.user)
e dovrebbe essere sufficiente per la maggior parte degli utenti di Vertex AI. Per il controllo completo delle risorse Vertex AI, puoi richiedere il ruolo Amministratore Vertex AI(roles/aiplatform.admin)
. Per esplorare le differenze tra questi e altri ruoli Vertex AI, consulta Controllo dellcontrollo dell'accessoso di Vertex AI con IAM. - Se intendi utilizzare anche le
istanze Vertex AI Workbench in Google Cloud, chiedi all'amministratore di concederti il ruolo IAM
Amministratore
notebook
(roles/notebooks.admin)
per il progetto, nonché il ruolo IAM Utente service account(roles/iam.serviceAccountUser)
per il progetto o per il service account predefinito di Compute Engine. - Inoltre, per abilitare le API necessarie, devi disporre del ruolo IAM Amministratore utilizzo servizi
(roles/serviceusage.serviceUsageAdmin)
oppure l'amministratore deve abilitare le API per te seguendo i primi passaggi.
- L'accesso alla maggior parte delle funzionalità di Vertex AI viene concesso dal ruolo IAM Vertex AI User
- Chiedi all'amministratore di abilitare le API Vertex AI per te.
Se ti viene concesso il ruolo IAM Amministratore utilizzo servizi
(roles/serviceusage.serviceUsageAdmin)
, potrai farlo autonomamente. Leggi una panoramica di Vertex AI.
Segui uno dei tutorial sull'utilizzo di Vertex AI.
Scopri come utilizzare l'SDK Vertex AI per Python, che offre un altro modo per interagire con Vertex AI.
Configura l'autenticazione
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Python
Per utilizzare gli esempi di Python questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale nella documentazione sull'autenticazione Google Cloud .
REST
Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, devi utilizzare le credenziali che fornisci a gcloud CLI.
Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .
Chiedi a un amministratore di configurare un progetto Vertex AI per te
Questa sezione descrive come un amministratore concede i ruoli necessari per utilizzare Vertex AI.
Passaggi successivi
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-05 UTC.