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 installare le librerie e configurare l'autenticazione per utilizzarle in un ambiente di sviluppo locale.

Prima di iniziare

  1. Accedi al tuo Google Cloud account. 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 senza costi per l'esecuzione, il test e il deployment dei workload.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Enable the Vertex AI API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Enable the Vertex AI API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    6.

  6. 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.

Librerie client

Vertex AI fornisce librerie client per i seguenti linguaggi. Seleziona il linguaggio che vuoi utilizzare.

C#

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

dotnet add package Google.Cloud.AIPlatform.V1

Provare esempi di codice

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

Documentazione della libreria client

Per saperne di più, consulta la documentazione della libreria client .NET di Vertex AI.

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"

Provare esempi di codice

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

Documentazione della libreria client

Per saperne di più, consulta la documentazione della libreria client di Vertex AI per Java.

Node.js

Prima di installare la libreria, prepara l'ambiente per lo sviluppo Node.js development.

Esegui il comando seguente nel tuo ambiente per installare la libreria client:

npm install @google-cloud/aiplatform

Documentazione della libreria client

Per saperne di più, consulta la documentazione della libreria client di Vertex AI per Node.js.

Python

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

Per saperne di più, consulta Installare l'SDK Vertex AI Python.

Vai

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

Esaminare i pacchetti disponibili

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

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

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

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

  • Pacchetto cloud.google.com/go/aiplatform

    aiplatform è un pacchetto generato automaticamente.

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

Installazione

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

    Esegui il comando seguente per installare questo pacchetto nel tuo ambiente:

    go get cloud.google.com/go/vertexai

  • Pacchetto cloud.google.com/go/aiplatform

    Esegui il comando seguente per installare questo pacchetto nel tuo ambiente:

    go get cloud.google.com/go/aiplatform

Esempi

Documentazione della libreria client

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