Requisitos previos de la plataforma Gemini Enterprise Agent (Vertex AI) para el conector de Google Gemini en Jitterbit Studio

Introducción

Estos son los requisitos previos para la autenticación con el conector de Google Gemini utilizando la opción de plataforma Vertex AI, que se conecta a la plataforma Gemini Enterprise Agent (anteriormente conocida como Vertex AI).

Crear una cuenta de servicio

Siga estos pasos para crear una cuenta de servicio y otorgar roles para proporcionar acceso al proyecto de Google Cloud que se utilizará con el conector de Google Gemini:

1. En la Consola de Google Cloud, cree un proyecto de Google Cloud o seleccione un proyecto existente.

2. Habilite la API de Agent Platform para el proyecto seleccionado.

3. En el menú de navegación, navegue a IAM y Admin > Cuentas de Servicio.

4. Haga clic en Crear Cuenta de Servicio, ubicada en la parte superior de la página.

5. Ingrese los detalles de la cuenta de servicio:

   • Nombre de la cuenta de servicio: Ingrese cualquier cadena para el nombre de la cuenta de servicio.

   • ID de la cuenta de servicio: Este campo se completa automáticamente para coincidir con el nombre de la cuenta de servicio y se puede editar, si se desea.

   • Descripción de la cuenta de servicio: Ingrese una descripción para la cuenta de servicio.

6. Haz clic en Crear y Continuar.

7. Asigna un rol para permitir el acceso a la Plataforma de Agentes Empresariales de Gemini (requerido para una conexión exitosa en el conector de Google Gemini):

   • Rol: Usando el menú, selecciona Usuario de la Plataforma de Agentes (Usuario de Vertex AI) como el Rol (roles/aiplatform.user) para permitir el acceso a la Plataforma de Agentes Empresariales de Gemini, luego haz clic en Continuar.

8. Opcionalmente, otorga acceso a la cuenta de servicio a usuarios específicos.

9. Haz clic en Listo.

Obtener credenciales de la cuenta de servicio

Sigue estos pasos para obtener las credenciales requeridas para la configuración de conexión:

1. En la página de Cuentas de servicio, haz clic en el menú de Acciones para la cuenta de servicio creada arriba, luego haz clic en Administrar claves.

2. Haz clic en Agregar clave > Crear nueva clave, selecciona JSON como el Tipo de clave, y luego haz clic en Crear para descargar el archivo de clave JSON a tu computadora.

3. Abre el archivo JSON descargado en un editor de texto y retén los valores de project_id, client_email, y private_key que se utilizarán durante la configuración de conexión.

Habilitar corpora RAG

Para usar la función de corpus RAG en la actividad de Prompt, se aplican estos requisitos previos adicionales:

• El Motor RAG debe estar habilitado para tu proyecto de Google Cloud.

• Uno o más corpora RAG deben existir ya en tu proyecto de Google Cloud antes de que puedan ser seleccionados en la configuración de la actividad de Prompt. Consulta Crear un corpus RAG en la documentación de la Plataforma de Agentes Empresariales de Gemini para más detalles.

• La cuenta de servicio debe tener el rol de Usuario del Motor RAG (Usuario del Motor RAG de Vertex AI) (roles/aiplatform.ragEngineUser) asignado, además del rol de Usuario de la Plataforma de Agentes asignado arriba, para acceder a los corpus RAG.