Introduzione all'SDK Agent Platform Python

L'SDK Agent Platform Python ti aiuta ad automatizzare l'importazione dati, addestrare i modelli ed eseguire previsioni sulla piattaforma agentica Gemini Enterprise. L'SDK Vertex AI utilizza il codice Python per accedere all'API Agent Platform, 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 Agent Platform Python, consulta Installare l' SDK Agent Platform Python. Per saperne di più, consulta la documentazione di riferimento dell'API Python dell'SDK Agent Platform.

Perché utilizzare l'SDK Vertex AI

L'SDK Agent Platform Python è consigliato se sei un ML engineer o un AI engineer esperto o un data scientist che vuole automatizzare il flusso di lavoro in modo programmatico. L'SDK Agent Platform Python è simile alla libreria client Python della piattaforma agentica Gemini Enterprise, ma l'SDK Vertex AI è di livello superiore e meno granulare. Per saperne di più, consulta Informazioni sulle differenze tra SDK e libreria client.

Scrivere codice con l'SDK Agent Platform Python

Per utilizzare l'SDK Agent Platform Python:

  1. Installa il pacchetto google-cloud-aiplatform, che include sia l'SDK Agent Platform Python sia la libreria client Python della piattaforma agentica Gemini Enterprise, eseguendo il seguente comando nell'ambiente virtuale:

    pip install --upgrade google-cloud-aiplatform

  2. Utilizza il seguente codice per importare lo spazio dei nomi google.cloud.aiplatform:

    from google.cloud import aiplatform

  3. 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 Agent Platform Python

Consulta la seguente documentazione:

Provare esempi di codice e tutorial

I tutorial sui blocchi note mostrano come utilizzare l'SDK Agent Platform Python nell'ambito di un flusso di lavoro più ampio. Per saperne di più, consulta Tutorial sui blocchi note della piattaforma agentica Gemini Enterprise.

Gli esempi di codice nel repository GitHub dell'SDK Agent Platform Python mostrano come completare le singole attività. Per saperne di più, consulta il repository GitHub dell'SDK Agent Platform Python.

Informazioni sulle differenze tra l'SDK Vertex AI e la libreria client

Quando installi l'SDK Agent Platform Python, viene installata anche la libreria client Python della piattaforma agentica Gemini Enterprise. L'SDK Vertex AI e la libreria client Python della piattaforma agentica Gemini Enterprise 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 della piattaforma agentica Gemini Enterprise.

L'SDK Vertex AI è disponibile per Python e una libreria client della piattaforma agentica Gemini Enterprise è disponibile per Python, Java e Node.js. Per scoprire come installare la libreria client Java o Node.js, consulta Installare le librerie client della piattaforma agentica Gemini Enterprise. Se una libreria client non è disponibile nel linguaggio di programmazione che preferisci, puoi utilizzare l'API REST della piattaforma agentica Gemini Enterprise. Per saperne di più, consulta il riferimento REST della piattaforma agentica Gemini Enterprise.

Utilizzare insieme la libreria client Python e l'SDK della piattaforma agentica Gemini Enterprise

Se utilizzi l'SDK Agent Platform 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 della piattaforma agentica Gemini Enterprise nello stesso flusso di lavoro. La libreria client Python della piattaforma agentica Gemini Enterprise utilizza uno spazio dei nomi diverso per accedere all'API Agent Platform. Gli spazi dei nomi della libreria client e dell'SDK Agent Platform 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 della piattaforma agentica Gemini Enterprise

Lo spazio dei nomi della libreria client Python della piattaforma agentica Gemini Enterprise è 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