L'SDK Vertex AI per Python ti aiuta ad automatizzare l'importazione dati, addestrare i modelli e ottenere previsioni su Vertex AI. L'SDK Vertex AI utilizza il codice Python per accedere all'API Vertex AI, in modo da poter eseguire in modo programmatico la maggior parte delle operazioni che puoi eseguire nella Google Cloud console.
Per scoprire come installare o aggiornare l'SDK Vertex AI per Python, consulta Installare l'SDK Vertex AI per Python. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API dell'SDK Vertex AI Python.
Perché utilizzare l'SDK Vertex AI
L'SDK Vertex AI per Python è consigliato se sei un ML engineer o un AI engineer esperto o un data scientist che vuole automatizzare il workflow in modo programmatico. L'SDK Vertex AI Python è simile alla libreria client Python di Vertex AI, tranne per il fatto che l'SDK Vertex AI è di livello superiore e meno granulare. Per ulteriori informazioni, consulta Informazioni sulle differenze tra SDK e libreria client.
Scrivere codice con l'SDK Vertex AI Python
Per utilizzare l'SDK Vertex AI per Python:
Installa il pacchetto
google-cloud-aiplatform, che include sia l'SDK Vertex AI Python sia la libreria client Python di Vertex AI, eseguendo il seguente comando nell'ambiente virtuale:pip install --upgrade google-cloud-aiplatformUtilizza il seguente codice per importare lo spazio dei nomi
google.cloud.aiplatform:from google.cloud import aiplatform-
Se utilizzi una shell locale, crea le credenziali di autenticazione locali per il tuo account utente:
gcloud auth application-default login
Non devi eseguire questa operazione se utilizzi Cloud Shell.
Se viene restituito un errore di autenticazione e utilizzi un provider di identità (IdP) esterno, verifica di aver acceduto a gcloud CLI con la tua identità federata.
Informazioni sull'SDK Vertex AI per Python
Consulta la seguente documentazione:
Panoramica della classe dell'SDK Vertex AI: introduce le classi e le funzionalità chiave dell'SDK Vertex AI.
Riferimento Python per Vertex AI: contiene la documentazione di riferimento per tutti gli spazi dei nomi, le classi, i metodi e le proprietà del pacchetto
google-cloud-aiplatform, che include l'SDK Vertex AI, l'anteprima dell'SDK Vertex AI e le librerie client di Vertex AI.
Provare esempi di codice e tutorial
I tutorial sui blocchi note mostrano come utilizzare l'SDK Vertex AI per Python nell'ambito di un flusso di lavoro più ampio. Per ulteriori informazioni, consulta Tutorial sui blocchi note di Vertex AI.
Gli esempi di codice nel repository GitHub dell'SDK Vertex AI Python mostrano come completare le singole attività. Per ulteriori informazioni, consulta il repository GitHub dell'SDK Vertex AI Python.
Informazioni sulle differenze tra l'SDK Vertex AI e la libreria client
Quando installi l'SDK Vertex AI Python, viene installata anche la libreria client Python di Vertex AI. L'SDK Vertex AI e la libreria client Python di Vertex AI forniscono funzionalità simili con diversi livelli di granularità. L'SDK Vertex AI opera a un livello di astrazione superiore rispetto alla libreria client ed è adatto alla maggior parte dei flussi di lavoro di data science più comuni. Se hai bisogno di funzionalità di livello inferiore, utilizza la libreria client Python di Vertex AI.
L'SDK Vertex AI è disponibile per Python e una libreria client Vertex AI è disponibile per Python, Java e Node.js. Per scoprire come installare la libreria client Java o Node.js, consulta Installare le librerie client di Vertex AI. Se una libreria client non è disponibile nel linguaggio di programmazione che preferisci, puoi utilizzare l'API REST di Vertex AI. Per ulteriori informazioni, consulta il riferimento REST di Vertex AI.
Utilizzare insieme la libreria client Python di Vertex AI e l'SDK
Se utilizzi l'SDK Vertex AI Python e scopri di aver bisogno di maggiore flessibilità o controllo oppure se hai bisogno di un metodo non incluso nell'SDK Vertex AI, puoi utilizzare la libreria client Python di Vertex AI nello stesso workflow. La libreria client Python di Vertex AI utilizza uno spazio dei nomi diverso per accedere all'API Vertex AI. Gli spazi dei nomi della libreria client e dell'SDK Vertex AI Python possono essere utilizzati nello stesso script Python aggiungendo una riga import per ciascuno nello script Python.
Importare lo spazio dei nomi della libreria client Python di Vertex AI
Lo spazio dei nomi della libreria client Python di Vertex AI è google.cloud.aiplatform.gapic. Questo spazio dei nomi esegue il mapping allo spazio dei nomi google.cloud.aiplatform_v1. Questi due spazi dei nomi possono essere utilizzati in modo intercambiabile. Per importare la libreria client Python, includi uno dei seguenti elementi nello script Python:
from google.cloud import aiplatform_v1
from google.cloud.aiplatform import gapic
Passaggi successivi
Scopri come scegliere un metodo di addestramento.