Instala las bibliotecas cliente de la Agent Platform de Gemini Enterprise

Las bibliotecas cliente proporcionan una experiencia optimizada para los desarrolladores para llamar a la API de Agent Platform. Las bibliotecas cliente usan las convenciones naturales de cada lenguaje compatible y reducen el código estándar que debes 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 comenzar

  1. Accede a tu Google Cloud cuenta de. 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. 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 Agent Platform 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 Agent Platform 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 usas un shell local, crea credenciales de autenticación locales para tu cuenta de usuario: 

    gcloud auth application-default login

    No es necesario que lo hagas si usas Cloud Shell.

    Si se muestra un error de autenticación y usas un proveedor de identidad (IdP) externo, confirma que accediste a gcloud CLI con tu identidad federada.

Bibliotecas cliente

Agent Platform proporciona bibliotecas cliente para los siguientes lenguajes. Selecciona el lenguaje 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 obtener o ver muestras de código individuales, ve al repositorio de GitHub dotnet-aiplatform.

Documentación de la biblioteca cliente

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

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 obtener o ver 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 Agent Platform 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 documentación de la biblioteca cliente de Agent Platform para Node.js.

Python

La biblioteca cliente de Python de Agent Platform de Gemini Enterprise se instala cuando instalas el SDK de Agent Platform para Python.

Para obtener más información, consulta Instala el SDK de Agent Platform 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 Agent Platform 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 Agent Platform. 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 Agent Platform que aún no proporciona el paquete vertexai creado por personas.

Instalación

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

    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

Documentación de la biblioteca cliente

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