Migra para usar los SDKs de Vertex AI en lugar de los SDKs de Google AI

Versión preliminar: Vertex AI para Firebase está en versión preliminar, lo que significa que el producto no está sujeto a ningún ANS ni a ninguna política de baja y podría cambiar de formas que generen incompatibilidad con versiones anteriores.

En esta página, se describe cómo migrar de los SDKs cliente de IA de Google a los SDKs cliente de Vertex AI para Firebase en tus apps web o para dispositivos móviles. Los SDK de Vertex AI para Firebase están disponibles para plataformas de Apple (Swift), Android (Kotlin y Java), la Web (JavaScript) y Flutter (Dart).

En el caso de las apps web o para dispositivos móviles de producción o a escala empresarial que llaman directamente a la API de Gemini, Firebase recomienda llamar a la API de Vertex AI Gemini con nuestros SDK de Vertex AI para Firebase.

Ir directamente a las instrucciones de migración

¿Por qué migrar para usar Vertex AI?

Es posible que hayas probado una versión alternativa de una API de Gemini usando Google AI Studio o los SDKs de IA de Google. Sin embargo, en el caso de las apps web y para dispositivos móviles de producción o a escala empresarial que llaman directamente a una API de Gemini, Firebase recomienda que llames a la API de Gemini de Vertex AI con nuestros SDK de Firebase.

Funciones de seguridad para apps web y para dispositivos móviles

En el caso de las apps web y para dispositivos móviles, tu código (incluidas las llamadas a la API de Gemini) se ejecuta en un entorno desprotegido, por lo que la seguridad es fundamental.

• De forma predeterminada, la API de Vertex AI Gemini está autorizada por Google Cloud IAM (en lugar de una clave de API como la API de Gemini de Google AI). Puedes llamar a la API de Vertex AI Gemini si usas los SDKs de Vertex AI para Firebase.

• En el caso de las apps web y para dispositivos móviles, también debes proteger la API de Gemini y los recursos de tu proyecto (como modelos ajustados) contra el abuso de clientes no autorizados. Puedes usar la Verificación de aplicaciones de Firebase para verificar que todas las llamadas a la API provengan de la app real, y esta función solo está disponible si usas los SDK de Vertex AI para Firebase.

Ecosistema diseñado para apps web y para dispositivos móviles

Firebase es la plataforma de Google que permite desarrollar apps web y para dispositivos móviles. Usar los SDK de Vertex AI para Firebase significa que tus apps se encuentran en un ecosistema que se enfoca en las necesidades de los desarrolladores y de las apps de pila completa. Por ejemplo, está configurado para realizar cualquiera de las siguientes acciones y mucho más:

• Usa Cloud Storage para Firebase para incluir archivos grandes en tus solicitudes multimodales. Además, aprovecha los SDK cliente que manejan cargas y descargas de archivos (incluso en condiciones de red deficientes) y ofrece más seguridad para los datos de tus usuarios finales. Obtén más información en nuestra guía de soluciones sobre el uso de Cloud Storage para Firebase.

• Administra datos estructurados con SDK de bases de datos compilados para apps web y para dispositivos móviles (como Cloud Firestore).

• De manera dinámica, establece configuraciones de tiempo de ejecución (como la ubicación) o intercambia valores en tu app (como el nombre de un modelo) sin lanzar una nueva versión de la app con Firebase Remote Config.

Funciones de la API de Vertex AI Gemini

La API de Vertex AI Gemini también ofrece funciones diferentes a las de la API de Gemini de Google AI, como más opciones para instrucciones multimodales (específicamente, entrada de texto y video y texto y audio).

Puedes obtener más información sobre las diferencias entre las dos ofertas de la API de Gemini en la documentación de Google Cloud.

Beneficios adicionales del uso de Vertex AI de Google Cloud

A medida que evoluciona el uso de la IA generativa en tu app y flujos de trabajo, es posible que necesites una plataforma que ofrezca soluciones de extremo a extremo para compilar y, luego, implementar aplicaciones de IA generativa. Google Cloud proporciona un ecosistema integral de herramientas para permitirte aprovechar el poder de la IA generativa, desde las etapas iniciales del desarrollo de apps hasta la implementación, el alojamiento de apps y la administración de datos complejos a gran escala.

La plataforma de Vertex AI de Google Cloud ofrece un conjunto de herramientas de MLOps que optimizan el uso, la implementación y la supervisión de los modelos de IA para lograr eficiencia y confiabilidad. Además, las integraciones en bases de datos, herramientas de DevOps, registros, supervisión y, también, IAM proporcionan un enfoque integral para administrar todo el ciclo de vida de la IA generativa.

Obtén más información sobre los casos de uso de Vertex AI en la documentación de Google Cloud.

Migra a los SDK de Vertex AI para Firebase

La migración a los SDK de Vertex AI para Firebase requiere tres pasos principales:

1. Configura un proyecto de Firebase nuevo o existente y conecta tu app a Firebase.

2. Migra tu base de código, lo que solo requiere cambiar el SDK y el código de inicialización (incluido el nombre del modelo). No es necesario modificar ninguno de los códigos que llaman a la API de Gemini.

3. Borra las claves de API sin usar y, luego, inhabilita las APIs que no se usen.

Paso 1: Configura un proyecto de Firebase y conecta tu app a Firebase

Incluso si ya conoces Firebase, revisa esta sección para asegurarte de que tu proyecto y app de Firebase estén configurados para usar los SDK de Vertex AI para Firebase.

Ya tienes un proyecto de Firebase y una app conectados a Firebase.

1. En Firebase console, ve a la página Compila con Gemini y haz clic en la segunda tarjeta para iniciar un flujo de trabajo que te ayude a realizar las siguientes tareas (si aún no lo han hecho):

   • Actualiza tu proyecto para usar el plan de precios Blaze (prepago).

   • Habilita las dos APIs siguientes para tu proyecto:
     aiplatform.googleapis.com y firebaseml.googleapis.com.

2. Continúa con el siguiente paso de esta guía para migrar tu base de código y usar los SDK de Vertex AI para Firebase.

No tienes un proyecto de Firebase ni una app conectados a esta.

1. Accede a Firebase console.

2. Haz clic en Crear proyecto y, luego, usa cualquiera de las siguientes opciones:

   • Opción 1: Crea un proyecto de Firebase completamente nuevo (y su proyecto de Google Cloud subyacente de forma automática). Para ello, ingresa un nombre de proyecto nuevo en el primer paso del flujo de trabajo “Crear proyecto”.

   • Opción 2: “Agrega Firebase” a un proyecto de Google Cloud existente. Para ello, selecciona el nombre de tu proyecto de Google Cloud en el menú desplegable del primer paso del flujo de trabajo “Crear proyecto”.

     • Puedes usar el proyecto de Google Cloud que Google AI Studio creó cuando creaste la clave de API de IA de Google. Puedes encontrar el nombre de ese proyecto en la sección Clave de API de Google AI Studio.

     • Puedes usar cualquier otro proyecto de Google Cloud existente.

   Ten en cuenta que, cuando se te solicite, no es necesario que configures Google Analytics para usar los SDK de Vertex AI para Firebase.

3. En Firebase console, ve a la página Compila con Gemini y haz clic en la segunda tarjeta para iniciar un flujo de trabajo que te ayude a realizar las siguientes tareas:

   • Actualiza tu proyecto para usar el plan de precios Blaze (prepago).

   • Habilita las dos APIs siguientes para tu proyecto:
     aiplatform.googleapis.com y firebaseml.googleapis.com.

4. Continúa con el flujo de trabajo de la consola para conectar la app a Firebase, que incluye estas tareas:

   • Registrando la app en el proyecto de Firebase.

   • Agregar la configuración de Firebase a la base de código de la app

   Nota: En los próximos pasos de esta guía, cambiarás la base de código de la app para usar el SDK de Vertex AI para Firebase y la inicialización específica para usar el SDK de Vertex AI para Firebase.

Paso 2: Migra tu base de código

Selecciona la plataforma de tu app para ver las instrucciones específicas de cada una.

iOS+ Android Web Flutter

Los SDK de Google AI y los de Vertex AI para Firebase se crearon para que la migración entre las dos plataformas sea lo más sencilla posible.

Para migrar, solo debes cambiar el SDK que integras en la base de código de tu app y la inicialización del servicio y el modelo generativo. No es necesario modificar el código que llama realmente a la API de Gemini.

Cambia el SDK

IA de Google

Vertex AI para Firebase

Cómo cambiar la inicialización

IA de Google

Vertex AI para Firebase

Nota: Es posible que también debas actualizar el nombre del modelo en el código de inicialización cuando migres a Vertex AI. Esto se debe a que Google AI y Vertex AI admiten modelos distintos y usan distintos formatos de nomenclatura. Para obtener más información sobre los modelos disponibles en Vertex AI, consulta Modelos de Gemini.

Paso 3: Borra las claves de API sin usar y, luego, inhabilita las APIs que no se usan

Si ya no necesitas usar la clave de API de Google AI, sigue las prácticas recomendadas de seguridad y bórrala. Puedes ver y borrar tus claves de API de Google AI en la sección Claves de API de Google AI Studio.

Además, si ya no usas la API de Gemini de Google AI, inhabilítala en tu proyecto. Puedes hacerlo en la consola de Google Cloud: generativelanguage.googleapis.com.

¿Qué más puedes hacer?

• Tanto Google AI como Vertex AI ofrecen una experiencia de “zona de pruebas” de la IU web llamada “AI Studio” para experimentar con instrucciones y parámetros de modelos. Descubre cómo migrar tus instrucciones de Google AI Studio a Vertex AI Studio en la documentación de Google Cloud.