Instalar las bibliotecas de cliente de Vertex AI

Las bibliotecas de cliente ofrecen una experiencia de desarrollo optimizada para llamar a la API de Vertex AI. Las bibliotecas de cliente usan las convenciones naturales de cada lenguaje admitido y reducen el código estándar que tienes que escribir. En la siguiente guía se explica cómo instalar las bibliotecas y configurar la autenticación para usarlas en un entorno de desarrollo local.

Antes de empezar

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  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 (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 (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. If you're using a local shell, then create local authentication credentials for your user account: 

    gcloud auth application-default login

    You don't need to do this if you're using Cloud Shell.

    If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

    7. Bibliotecas de cliente

    Vertex AI proporciona bibliotecas de cliente para los siguientes lenguajes. Selecciona el idioma que quieras utilizar.

    C#

    Ejecuta el siguiente comando para añadir la referencia del paquete Google.Cloud.AIPlatform.V1 al archivo de tu proyecto:

    dotnet add package Google.Cloud.AIPlatform.V1

    Probar códigos de ejemplo

    Para ver o descargar ejemplos de código concretos, ve al repositorio de GitHub dotnet-aiplatform.

    Documentación de la biblioteca de cliente

    Para obtener más información, consulta la documentación de la biblioteca de cliente de .NET de Vertex AI.

    Java

    Si usas Maven, añade lo siguiente a tus dependencias:

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

    Si usas Gradle, añade lo siguiente a tus dependencias:

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

    Si usas sbt, añade lo siguiente a tus dependencias:

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

    Probar códigos de ejemplo

    Para ver u obtener ejemplos de código concretos, ve al repositorio de GitHub java-aiplatform.

    Documentación de la biblioteca de cliente

    Para obtener más información, consulta la documentación de la biblioteca de cliente de Vertex AI para Java.

    Node.js

    Antes de instalar la biblioteca, prepara tu entorno para el desarrollo de Node.js.

    Ejecuta el siguiente comando en tu entorno para instalar la biblioteca de cliente:

    npm install @google-cloud/aiplatform

    Documentación de la biblioteca de cliente

    Para obtener más información, consulta la documentación de la biblioteca de cliente de Vertex AI para Node.js.

    Python

    La biblioteca de cliente de Python de Vertex AI se instala al instalar el SDK de Vertex AI para Python.

    Para obtener más información, consulta Instalar el SDK de Vertex AI para Python.

    Go

    Antes de instalar la biblioteca, prepara tu entorno para el desarrollo en Go.

    Revisar los paquetes disponibles

    Consulta los paquetes Go de la API Vertex AI disponibles para determinar cuál se adapta mejor a las necesidades de tu proyecto:

    • Paquete cloud.google.com/go/vertexai (recomendado)

      vertexai es un paquete creado por humanos que proporciona acceso a funciones y capacidades comunes.

      Recomendamos este paquete como punto de partida para la mayoría de los desarrolladores que crean aplicaciones con la API de Vertex AI. Para acceder a funciones y características que aún no se incluyen en este paquete, usa el aiplatform generado automáticamente.

    • Package cloud.google.com/go/aiplatform

      aiplatform es un paquete generado automáticamente.

      Este paquete está pensado para proyectos que requieren acceso a las funciones y características de la API Vertex AI que aún no ofrece el paquete vertexai creado por humanos.

    Instalación

    • Paquete cloud.google.com/go/vertexai (recomendado)

      Ejecuta el siguiente comando para instalar este paquete en tu entorno:

      go get cloud.google.com/go/vertexai

    • Package cloud.google.com/go/aiplatform

      Ejecuta el siguiente comando para instalar este paquete en tu entorno:

      go get cloud.google.com/go/aiplatform

    Ejemplos

    Documentación de la biblioteca de cliente

    Para obtener más información sobre la biblioteca, consulta la documentación de la biblioteca de cliente de Vertex AI para Go: