Installer les bibliothèques clientes Vertex AI

Les bibliothèques clientes offrent une expérience développeur optimisée pour appeler l'API Vertex AI. Les bibliothèques clientes utilisent les conventions naturelles de chaque langage compatible et réduisent la quantité de code récurrent que vous devez écrire. Le guide suivant explique comment installer les bibliothèques et configurer l'authentification pour les utiliser dans un environnement de développement local.

Avant de commencer

  1. Connectez-vous à votre compte Google Cloud . Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $de crédits sans frais pour exécuter, tester et déployer des charges de travail.

  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. Si vous utilisez un shell local, créez des identifiants d'authentification locaux pour votre compte utilisateur : 

    gcloud auth application-default login

    Vous n'avez pas besoin de le faire si vous utilisez Cloud Shell.

    Si une erreur d'authentification est renvoyée et que vous utilisez un fournisseur d'identité (IdP) externe, vérifiez que vous vous êtes connecté à la gcloud CLI avec votre identité fédérée.

Bibliothèques clientes

Vertex AI fournit des bibliothèques clientes pour les langages suivants. Sélectionnez le langage que vous souhaitez utiliser.

C#

Exécutez la commande suivante pour ajouter la référence du package Google.Cloud.AIPlatform.V1 à votre fichier de projet :

dotnet add package Google.Cloud.AIPlatform.V1

Essayer des exemples de code

Pour afficher ou obtenir des exemples de code individuels, accédez au dépôt GitHub dotnet-aiplatform.

Documentation de la bibliothèque cliente

Pour en savoir plus, consultez la documentation de la bibliothèque cliente Vertex AI .NET.

Java

Si vous utilisez Maven, ajoutez les éléments suivants à vos dépendances :

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

Si vous utilisez Gradle, ajoutez les éléments suivants à vos dépendances :

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

Si vous utilisez sbt, ajoutez les éléments suivants à vos dépendances :

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

Essayer des exemples de code

Pour afficher ou obtenir des exemples de code individuels, accédez au dépôt GitHub java-aiplatform.

Documentation de la bibliothèque cliente

Pour plus d'informations, consultez la documentation sur la bibliothèque cliente Vertex AI pour Java.

Node.js

Avant d'installer la bibliothèque, préparez votre environnement pour le développement Node.js.

Exécutez la commande suivante dans votre environnement pour installer la bibliothèque cliente :

npm install @google-cloud/aiplatform

Documentation de la bibliothèque cliente

Pour en savoir plus, consultez la documentation sur la bibliothèque cliente Vertex AI pour Node.js.

Python

La bibliothèque cliente Vertex AI pour Python est installée lorsque vous installez le SDK Vertex AI pour Python.

Pour en savoir plus, consultez la section Installer le SDK Vertex AI pour Python.

Go

Avant d'installer la bibliothèque, préparez votre environnement pour le développement Go.

Examiner les packages disponibles

Examinez les packages Go de l'API Vertex AI disponibles pour déterminer le package qui répond le mieux aux besoins de votre projet :

  • Package cloud.google.com/go/vertexai (recommandé)

    vertexai est un package créé manuellement qui permet d'accéder aux fonctionnalités courantes.

    Ce package est recommandé comme point de départ pour la plupart des développeurs utilisant l'API Vertex AI. Pour accéder à des fonctionnalités qui ne sont pas encore couvertes par ce package, utilisez plutôt le package aiplatform généré automatiquement.

  • Package cloud.google.com/go/aiplatform

    aiplatform est un package généré automatiquement.

    Ce package est destiné aux projets nécessitant un accès aux fonctionnalités de l'API Vertex AI qui ne sont pas encore fournies par le package vertexai créé manuellement.

Installation

  • Package cloud.google.com/go/vertexai (recommandé)

    Exécutez la commande suivante pour installer ce package dans votre environnement :

    go get cloud.google.com/go/vertexai

  • Package cloud.google.com/go/aiplatform

    Exécutez la commande suivante pour installer ce package dans votre environnement :

    go get cloud.google.com/go/aiplatform

Exemples

Documentation de la bibliothèque cliente

Pour en savoir plus sur la bibliothèque, consultez la documentation de la bibliothèque cliente Vertex AI pour Go :