Installa le librerie client di Vertex AI

Le librerie client offrono agli sviluppatori un'esperienza ottimizzata per chiamare l'API Vertex AI. Le librerie client utilizzano le convenzioni naturali di ogni linguaggio supportato e riducono il codice boilerplate che devi scrivere. La seguente guida spiega come installarli.

Prima di iniziare

1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

2. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   Vai al selettore progetti

3. Attiva Vertex AI API.

   Abilita l'API

4. Crea un account di servizio:

   1. Nella console Google Cloud, vai alla pagina Crea account di servizio.

      Vai a Crea account di servizio
   2. Seleziona il progetto.

   3. Nel campo Nome account di servizio, inserisci un nome. La console Google Cloud compila il campo ID account di servizio in base a questo nome.

      Nel campo Descrizione account di servizio, inserisci una descrizione. Ad esempio, Service account for quickstart.

   4. Fai clic su Crea e continua.

   5. Concedi il ruolo Project > Owner all'account di servizio.

      Per concedere il ruolo, trova l'elenco Seleziona un ruolo e scegli Project > Owner.

      Nota: il campo Ruolo influisce sulle risorse a cui l'account di servizio può accedere nel progetto. Puoi revocare questi ruoli o concedere ruoli aggiuntivi in un secondo momento. In ambienti di produzione, non concedere i ruoli Proprietario, Editor o Visualizzatore. Concedi invece un ruolo predefinito o un ruolo personalizzato che soddisfi le tue esigenze.
   6. Fai clic su Continua.

   7. Fai clic su Fine per completare la creazione dell'account di servizio.

      Non chiudere la finestra del browser. La utilizzerai nel passaggio successivo.

5. Crea una chiave dell'account di servizio:

   1. Nella console Google Cloud, fai clic sull'indirizzo email dell'account di servizio che hai creato.
   2. Fai clic su Chiavi.
   3. Fai clic su Aggiungi chiave, quindi su Crea nuova chiave.
   4. Fai clic su Crea. Un file della chiave JSON viene scaricato sul computer.
   5. Fai clic su Chiudi.

6. Imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS sul percorso del file JSON che contiene le tue credenziali. Questa variabile si applica solo alla sessione di shell attuale. Pertanto, se apri una nuova sessione, imposta di nuovo la variabile.

   Esempio: Linux o macOS

   export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Sostituisci KEY_PATH con il percorso del file JSON che contiene le tue credenziali.

   Ad esempio:

   export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

   Esempio: Windows

   Per PowerShell:

   $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Sostituisci KEY_PATH con il percorso del file JSON che contiene le tue credenziali.

   Ad esempio:

   $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

   Per il prompt dei comandi:

   set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

   Sostituisci KEY_PATH con il percorso del file JSON che contiene le tue credenziali.

7. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   Vai al selettore progetti

8. Attiva Vertex AI API.

   Abilita l'API

9. Crea un account di servizio:

   1. Nella console Google Cloud, vai alla pagina Crea account di servizio.

      Vai a Crea account di servizio
   2. Seleziona il progetto.

   3. Nel campo Nome account di servizio, inserisci un nome. La console Google Cloud compila il campo ID account di servizio in base a questo nome.

      Nel campo Descrizione account di servizio, inserisci una descrizione. Ad esempio, Service account for quickstart.

   4. Fai clic su Crea e continua.

   5. Concedi il ruolo Project > Owner all'account di servizio.

      Per concedere il ruolo, trova l'elenco Seleziona un ruolo e scegli Project > Owner.

      Nota: il campo Ruolo influisce sulle risorse a cui l'account di servizio può accedere nel progetto. Puoi revocare questi ruoli o concedere ruoli aggiuntivi in un secondo momento. In ambienti di produzione, non concedere i ruoli Proprietario, Editor o Visualizzatore. Concedi invece un ruolo predefinito o un ruolo personalizzato che soddisfi le tue esigenze.
   6. Fai clic su Continua.

   7. Fai clic su Fine per completare la creazione dell'account di servizio.

      Non chiudere la finestra del browser. La utilizzerai nel passaggio successivo.

10. Crea una chiave dell'account di servizio:

    1. Nella console Google Cloud, fai clic sull'indirizzo email dell'account di servizio che hai creato.
    2. Fai clic su Chiavi.
    3. Fai clic su Aggiungi chiave, quindi su Crea nuova chiave.
    4. Fai clic su Crea. Un file della chiave JSON viene scaricato sul computer.
    5. Fai clic su Chiudi.

11. Imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS sul percorso del file JSON che contiene le tue credenziali. Questa variabile si applica solo alla sessione di shell attuale. Pertanto, se apri una nuova sessione, imposta di nuovo la variabile.

    Esempio: Linux o macOS

    export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Sostituisci KEY_PATH con il percorso del file JSON che contiene le tue credenziali.

    Ad esempio:

    export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

    Esempio: Windows

    Per PowerShell:

    $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Sostituisci KEY_PATH con il percorso del file JSON che contiene le tue credenziali.

    Ad esempio:

    $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

    Per il prompt dei comandi:

    set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

    Sostituisci KEY_PATH con il percorso del file JSON che contiene le tue credenziali.

Librerie client

Vertex AI fornisce librerie client per i seguenti linguaggi. Seleziona la lingua che vuoi utilizzare.

C#

Esegui questo comando per aggiungere il riferimento al pacchetto Google.Cloud.AIPlatform.V1 al file di progetto:

dotnet add package Google.Cloud.AIPlatform.V1

Prova gli esempi di codice

Per visualizzare o ottenere singoli esempi di codice, vai al repository GitHub di dotnet-aiplatform.

Documentazione della libreria client

Per ulteriori informazioni, consulta la documentazione relativa alla libreria client di Vertex AI .NET.

Java

Se utilizzi Maven, aggiungi quanto segue alle dipendenze:

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>google-cloud-aiplatform</artifactId>
  <version>3.35.0</version>
</dependency>

Se utilizzi Gradle, aggiungi quanto segue alle dipendenze:

compile 'com.google.cloud:google-cloud-aiplatform:3.35.0'

Se utilizzi sbt, aggiungi quanto segue alle dipendenze:

libraryDependencies += "com.google.cloud" % "google-cloud-aiplatform" % "3.35.0"

Prova gli esempi di codice

Per visualizzare o ottenere singoli esempi di codice, vai al repository GitHub di java-aiplatform.

Documentazione della libreria client

Per ulteriori informazioni, consulta la documentazione relativa alla libreria client Vertex AI per Java.

Node.js

Prima di installare la libreria, prepara il tuo ambiente per lo sviluppo con Node.js.

Esegui questo comando nel tuo ambiente per installare la libreria client:

npm install @google-cloud/aiplatform

Documentazione della libreria client

Per ulteriori informazioni, consulta la libreria client di Vertex AI per la documentazione di Node.js.

Python

La libreria client Python di Vertex AI viene installata quando installi l'SDK Vertex AI per Python.

Per maggiori informazioni, consulta Installare l'SDK Vertex AI per Python.

Go

Prima di installare la libreria, prepara l'ambiente per lo sviluppo Go.

Rivedi i pacchetti disponibili

Esamina i pacchetti Go dell'API Vertex AI disponibili per determinare quale pacchetto soddisfa meglio le esigenze del tuo progetto:

• Pacchetto cloud.google.com/go/vertexai (consigliato)

  vertexai è un pacchetto creato da persone fisiche che fornisce l'accesso a funzionalità e funzionalità comuni.

  Questo pacchetto è consigliato come punto di partenza per la maggior parte degli sviluppatori che usano l'API Vertex AI. Per accedere a funzionalità e funzionalità non ancora coperte da questo pacchetto, utilizza invece l'elemento aiplatform generato automaticamente.

• Pacchetto cloud.google.com/go/aiplatform

  aiplatform è un pacchetto generato automaticamente.

  Questo pacchetto è destinato ai progetti che richiedono l'accesso alle funzionalità e alle funzionalità dell'API Vertex AI non ancora fornite dal pacchetto vertexai creato da persone fisiche.

Installazione

• Pacchetto cloud.google.com/go/vertexai (consigliato)

  Esegui questo comando per installare il pacchetto nel tuo ambiente:

  go get cloud.google.com/go/vertexai
  

• Pacchetto cloud.google.com/go/aiplatform

  Esegui questo comando per installare il pacchetto nel tuo ambiente:

  go get cloud.google.com/go/aiplatform
  

Esempi

• Pacchetto cloud.google.com/go/vertexai (consigliato)

  Nel repository GitHub di golang-samples nella directory vertexai di primo livello sono disponibili esempi per l'utilizzo di questo pacchetto:

  github.com/GoogleCloudPlatform/golang-samples > vertexai

• Pacchetto cloud.google.com/go/aiplatform

  Nel repository GitHub di golang-samples nella directory aiplatform di primo livello sono disponibili esempi per l'utilizzo di questo pacchetto:

  github.com/GoogleCloudPlatform/golang-samples > aiplatform

Documentazione della libreria client

Per saperne di più sulla libreria, consulta la documentazione relativa alla libreria client di Vertex AI per Go:

• Pacchetto cloud.google.com/go/vertexai (consigliato)

  • Vertex AI cloud.google.com/go/vertexai Riferimento API

• Pacchetto cloud.google.com/go/aiplatform

  • Vertex AI cloud.google.com/go/aiplatform v1 Riferimento API
  • Vertex AI cloud.google.com/go/aiplatform v1beta1 Riferimento API