Instala las bibliotecas cliente de Vertex AI

Las bibliotecas cliente brindan una experiencia optimizada para los desarrolladores para llamar a la API de Vertex AI. Las bibliotecas cliente usan las convenciones naturales de cada idioma compatible y reducen el código estándar que debes escribir. En la siguiente guía, se explica cómo instalarlas.

Antes de comenzar

1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

2. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

   Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

   Ir al selector de proyectos

3. Habilita Vertex AI API.

   Habilita la API

4. Crear una cuenta de servicio:

   1. En la consola de Google Cloud, ve a la página Crear cuenta de servicio.

      Ve a Crear cuenta de servicio
   2. Elige tu proyecto.

   3. Ingresa un nombre en el campo Nombre de cuenta de servicio. La consola de Google Cloud completa el campo ID de cuenta de servicio en función de este nombre.

      Opcional: en el campo Descripción de la cuenta de servicio, ingresa una descripción. Por ejemplo, Service account for quickstart.

   4. Haz clic en Crear y continuar.

   5. Otorga el rol Project > Owner a la cuenta de servicio.

      Para otorgar el rol, busca la lista Seleccionar un rol y, luego, selecciona Project > Owner.

      Nota: El campo Rol afecta a qué recursos puede acceder tu cuenta de servicio en el proyecto. Puedes revocar estos roles o asignar otros más adelante. En entornos de producción, no otorgues los roles de propietario, editor o visualizador. En su lugar, otorga un rol predefinido o un rol personalizado que satisfaga tus necesidades.
   6. Haga clic en Continuar.

   7. Haz clic en Listo para terminar de crear la cuenta de servicio.

      No cierres la ventana del navegador. La usarás en la próxima tarea.

5. Haz lo siguiente para crear una clave de cuenta de servicio:

   1. En la consola de Google Cloud, haz clic en la dirección de correo electrónico de la cuenta de servicio que creaste.
   2. Haga clic en Claves.
   3. Haz clic en Agregar clave y, luego, en Crear clave nueva.
   4. Haga clic en Crear. Se descargará un archivo de claves JSON en tu computadora.
   5. Haga clic en Cerrar.

6. Configura la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta del archivo JSON que contiene tus credenciales. Esta variable solo se aplica a la sesión actual de Cloud Shell. Por lo tanto, si abres una sesión nueva, deberás volver a configurar la variable.

   Ejemplo: Linux o macOS

   export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Reemplaza KEY_PATH por la ruta del archivo JSON que contiene tus credenciales.

   Por ejemplo:

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

   Ejemplo: Windows

   Para PowerShell:

   $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Reemplaza KEY_PATH por la ruta del archivo JSON que contiene tus credenciales.

   Por ejemplo:

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

   Para el símbolo del sistema:

   set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

   Reemplaza KEY_PATH por la ruta del archivo JSON que contiene tus credenciales.

7. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

   Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

   Ir al selector de proyectos

8. Habilita Vertex AI API.

   Habilita la API

9. Crear una cuenta de servicio:

   1. En la consola de Google Cloud, ve a la página Crear cuenta de servicio.

      Ve a Crear cuenta de servicio
   2. Elige tu proyecto.

   3. Ingresa un nombre en el campo Nombre de cuenta de servicio. La consola de Google Cloud completa el campo ID de cuenta de servicio en función de este nombre.

      Opcional: en el campo Descripción de la cuenta de servicio, ingresa una descripción. Por ejemplo, Service account for quickstart.

   4. Haz clic en Crear y continuar.

   5. Otorga el rol Project > Owner a la cuenta de servicio.

      Para otorgar el rol, busca la lista Seleccionar un rol y, luego, selecciona Project > Owner.

      Nota: El campo Rol afecta a qué recursos puede acceder tu cuenta de servicio en el proyecto. Puedes revocar estos roles o asignar otros más adelante. En entornos de producción, no otorgues los roles de propietario, editor o visualizador. En su lugar, otorga un rol predefinido o un rol personalizado que satisfaga tus necesidades.
   6. Haga clic en Continuar.

   7. Haz clic en Listo para terminar de crear la cuenta de servicio.

      No cierres la ventana del navegador. La usarás en la próxima tarea.

10. Haz lo siguiente para crear una clave de cuenta de servicio:

    1. En la consola de Google Cloud, haz clic en la dirección de correo electrónico de la cuenta de servicio que creaste.
    2. Haga clic en Claves.
    3. Haz clic en Agregar clave y, luego, en Crear clave nueva.
    4. Haga clic en Crear. Se descargará un archivo de claves JSON en tu computadora.
    5. Haga clic en Cerrar.

11. Configura la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta del archivo JSON que contiene tus credenciales. Esta variable solo se aplica a la sesión actual de Cloud Shell. Por lo tanto, si abres una sesión nueva, deberás volver a configurar la variable.

    Ejemplo: Linux o macOS

    export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Reemplaza KEY_PATH por la ruta del archivo JSON que contiene tus credenciales.

    Por ejemplo:

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

    Ejemplo: Windows

    Para PowerShell:

    $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Reemplaza KEY_PATH por la ruta del archivo JSON que contiene tus credenciales.

    Por ejemplo:

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

    Para el símbolo del sistema:

    set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

    Reemplaza KEY_PATH por la ruta del archivo JSON que contiene tus credenciales.

Bibliotecas cliente

Vertex AI proporciona bibliotecas cliente para los siguientes idiomas. Selecciona el idioma que quieres usar.

C#

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

dotnet add package Google.Cloud.AIPlatform.V1

Prueba las muestras de código

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

Documentación de la biblioteca cliente

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

Java

Si usas Maven, agrega 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, agrega lo siguiente a las dependencias:

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

Si usas sbt, agrega lo siguiente a las dependencias:

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

Prueba las muestras de código

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

Documentación de la biblioteca cliente

Si deseas obtener más información, consulta la documentación de la 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 cliente:

npm install @google-cloud/aiplatform

Documentación de la biblioteca cliente

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

Python

La biblioteca cliente de Python de Vertex AI se instala cuando instalas el SDK de Vertex AI para Python.

Si deseas obtener más información, consulta Instala el SDK de Vertex AI para Python.

Go

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

Revisa los paquetes disponibles

Revisa los paquetes disponibles de Go de la API de Vertex AI para determinar qué paquete se adapta mejor a las necesidades de tu proyecto:

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

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

  Se recomienda este paquete como punto de partida para la mayoría de los desarrolladores que compilan con la API de Vertex AI. Para acceder a las capacidades y funciones que aún no se incluyen en este paquete, usa el aiplatform generado de forma automática.

• Paquete cloud.google.com/go/aiplatform

  aiplatform es un paquete generado de forma automática.

  Este paquete está diseñado para proyectos que requieren acceso a capacidades y funciones de la API de Vertex AI que aún no proporciona el paquete vertexai creado por personas.

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
  

• Paquete cloud.google.com/go/aiplatform

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

  go get cloud.google.com/go/aiplatform
  

Muestras

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

  Las muestras para usar este paquete están disponibles en el repositorio de GitHub golang-samples en el directorio vertexai de nivel superior:

  github.com/GoogleCloudPlatform/golang-samples > vertexai

• Paquete cloud.google.com/go/aiplatform

  Las muestras para usar este paquete están disponibles en el repositorio de GitHub golang-samples en el directorio aiplatform de nivel superior:

  github.com/GoogleCloudPlatform/golang-samples > aiplatform

Documentación de la biblioteca cliente

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

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

  • Vertex AI cloud.google.com/go/vertexai Referencia de la API

• Paquete cloud.google.com/go/aiplatform

  • Vertex AI cloud.google.com/go/aiplatform v1 Referencia de la API
  • Vertex AI cloud.google.com/go/aiplatform v1beta1 Referencia de la API