Utilizza l'SDK Vertex AI per Python

L'SDK Vertex AI per Python ti aiuta ad automatizzare l'importazione dei dati e addestrare i modelli per ricevere previsioni su Vertex AI. L'SDK utilizza il codice Python per accedere all'API Vertex AI, in modo da poter svolgere in modo programmatico tutto ciò che puoi fare nella console di Vertex AI.

Perché utilizzare l'SDK Vertex AI

L'SDK è consigliato se sei un tecnico esperto di machine learning (ML) e di intelligenza artificiale (AI) o un data scientist che vuole automatizzare il flusso di lavoro in modo programmatico. L'SDK Vertex AI per Python è simile alla libreria client Python dell'AI Vertex, tranne per il fatto che l'SDK è di livello superiore e meno granulare. Per ulteriori informazioni, consulta Comprendere le differenze tra SDK e libreria client.

Installa l'SDK Vertex AI

L'installazione dell'SDK Vertex AI per Python include i seguenti passaggi:

  1. Crea un ambiente Python isolato
  2. Installa il pacchetto dell'SDK Vertex AI
  3. Inizializza l'SDK Vertex AI

Creare un ambiente Python isolato

Una best practice Python è installare l'SDK Vertex AI in un ambiente Python isolato per ogni progetto. Ciò consente di evitare conflitti tra dipendenza, versione e autorizzazioni. Puoi creare un ambiente isolato per l'utilizzo della riga di comando in una shell o per l'utilizzo di un blocco note.

Per creare un ambiente isolato quando utilizzi la riga di comando, attiva un ambiente venv. Dopo aver attivato l'ambiente venv, puoi installare l'SDK Vertex AI ed eseguire gli script Python. Per saperne di più, consulta Utilizzare venv per isolare le dipendenze e Configurare un ambiente di sviluppo Python.

Per utilizzare un blocco note per il tuo ambiente isolato, crea un'istanza di blocco note. Dopo aver creato l'istanza di blocco note, utilizzala per installare l'SDK AI Vertex ed eseguire gli script Python. Per maggiori informazioni, consulta Creare un'istanza di blocchi note gestiti dall'utente.

Installa il pacchetto dell'SDK Vertex AI

Per installare l'SDK Vertex AI, esegui il comando seguente nel tuo ambiente virtuale:

pip install google-cloud-aiplatform

Inizializza l'SDK Vertex AI

Dopo aver installato l'SDK Vertex AI per Python, devi inizializzare l'SDK con i dettagli di Vertex AI e Google Cloud. Ad esempio, quando inizializza l'SDK, specifichi informazioni quali nome del progetto, regione e bucket Cloud Storage gestione temporanea. Il seguente metodo è un esempio di metodo che inizializza l'SDK Vertex AI.

def init_sample(
    project: Optional[str] = None,
    location: Optional[str] = None,
    experiment: Optional[str] = None,
    staging_bucket: Optional[str] = None,
    credentials: Optional[auth_credentials.Credentials] = None,
    encryption_spec_key_name: Optional[str] = None,
):

    from google.cloud import aiplatform

    aiplatform.init(
        project=project,
        location=location,
        experiment=experiment,
        staging_bucket=staging_bucket,
        credentials=credentials,
        encryption_spec_key_name=encryption_spec_key_name,
    )

Scrivi il codice con l'SDK Vertex AI

Per utilizzare l'SDK Vertex AI per Python, devi aggiungere una riga nel codice per importarne lo spazio dei nomi. Successivamente, utilizza la documentazione di riferimento e gli esempi di codice dell'SDK Vertex AI per scoprire di più su classi, metodi e proprietà.

Importa lo spazio dei nomi dell'SDK Vertex AI

L'SDK Vertex AI per Python utilizza lo spazio dei nomi google.cloud.aiplatform. Per accedere alle funzionalità dell'SDK, importa questo spazio dei nomi aggiungendo la seguente riga al codice Python:

from google.cloud import aiplatform

Scopri di più sull'SDK Vertex AI

Il riferimento dell'SDK Vertex AI per Python documenta la funzionalità dell'SDK Vertex AI per Python. Questo riferimento include definizioni di classi, metodi, proprietà e tutto ciò che è necessario per utilizzare l'SDK Vertex AI per automatizzare in modo programmatico Vertex AI. Per ulteriori informazioni, consulta il riferimento all'SDK Vertex AI.

Prova gli esempi di codice e i tutorial

I tutorial sul blocco note Jupyter mostrano come utilizzare l'SDK Vertex AI per Python come parte di un flusso di lavoro più ampio. Per ulteriori informazioni, consulta i tutorial su Notebooks di Vertex AI.

Gli esempi di codice nel repository GitHub di Vertex AI SDK per Python mostrano come completare le singole attività. Per ulteriori informazioni, consulta il repository GitHub Vertex AI per Python.

Comprendi le differenze tra SDK e libreria client

Quando installi l'SDK Vertex AI per Python, viene installata anche la libreria client Python di Vertex AI. L'SDK Vertex AI e la libreria client Python su Vertex AI offrono 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, mentre la libreria client di 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.

Usa la libreria client Python di Vertex AI e l'SDK insieme

Se utilizzi l'SDK Vertex AI per Python e scopri di avere bisogno di una maggiore flessibilità o controllo oppure se ti serve un metodo non incluso nell'SDK, puoi utilizzare la libreria client Python dell'AI Vertex nello stesso flusso di lavoro. La libreria client Python di Vertex AI utilizza uno spazio dei nomi diverso per accedere all'API Vertex AI. La libreria client e gli spazi dei nomi dell'SDK Python possono essere utilizzati nello stesso script Python aggiungendo una riga import per ciascuno script Python.

Per saperne di più sullo spazio dei nomi dell'SDK Vertex AI, consulta Importare lo spazio dei nomi dell'SDK Vertex AI nella prima pagina di questa pagina.

Importa 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 è mappato 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 una delle seguenti opzioni nello script Python: 

from google.cloud import aiplatform_gapic
from google.cloud import aiplatform_v1

Passaggi successivi