Migra para usar la versión de DG de Vertex AI en Firebase


Vertex AI in Firebase se lanzó a la disponibilidad general (DG) el 21 de octubre de 2024.

Si usaste la versión beta de la biblioteca Vertex AI in Firebase (firebase-vertexai:16.0.0-betaXX), debes realizar los siguientes cambios para actualizar y usar la versión GA de la biblioteca (firebase-vertexai:16.0.0 o una versión posterior).

Esta es una lista de alto nivel de los cambios necesarios para migrar:

Habilita la nueva API obligatoria en tu proyecto de Firebase (obligatorio para todos)

Debes habilitar la API de Vertex AI in Firebase en tu proyecto de Firebase y agregarla a la lista de entidades permitidas de tu clave de API de Firebase. Esta es una API nueva que se requiere para usar la versión de GA de Vertex AI in Firebase.

  1. En la consola de Firebase, ve a la página Crear con Gemini.

  2. En la tarjeta Vertex AI in Firebase, haz clic en Comenzar para iniciar un flujo de trabajo que te ayude a habilitar esta API y agregarla a la lista de entidades permitidas de tu clave de API de Firebase.

  3. Puedes omitir el resto del flujo de trabajo en la consola.

Actualiza a la versión GA de la biblioteca (obligatorio para todos)

Sigue estas instrucciones para actualizar tus dependencias y usar la versión más reciente de Firebase Android BoM. No es obligatorio usar la BoM, pero te recomendamos que lo hagas, ya que ayuda a garantizar que tu app use versiones compatibles de cada biblioteca de Firebase.

  1. En el archivo de Gradle del módulo (nivel de app) (generalmente <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle)), reemplaza la dependencia de Vertex AI in Firebase por lo siguiente:

    // BEFORE
dependencies {
  implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
}

// AFTER
dependencies {
  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:33.10.0"))

  // Add the dependency for the Vertex AI in Firebase library
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-vertexai")
}

  2. Sincroniza tu proyecto de Android con archivos Gradle.

Ten en cuenta que, si decides no usar Firebase BoM, solo debes aceptar la versión más reciente de firebase-vertexai que sugiere Android Studio.

Cambios adicionales (obligatorios según las funciones que uses)

Se implementaron varios cambios para las versiones GA de los SDKs. Revisa las siguientes listas para ver si debes realizar algún cambio en tu código para admitir la versión GA del SDK en tu app.

  • Llamadas a funciones
    Si implementaste esta función antes de la versión GA, deberás actualizar la manera en que defines tu esquema. Te recomendamos que revises la guía actualizada de llamadas a función para aprender a escribir las declaraciones de tus funciones.

  • Cómo generar un resultado estructurado (como JSON) con responseSchema
    Si implementaste esta función antes de la DG, deberás actualizar la forma en que defines tu esquema. Te recomendamos que revises la nueva guía de salida estructurada para aprender a escribir esquemas JSON.

  • Tiempo de espera

    • Se cambió el tiempo de espera predeterminado de las solicitudes a 180 segundos.

  • Enumeraciones

    • Se reemplazaron las clases enum y sealed por clases normales. Este cambio permite más flexibilidad para evolucionar la API de forma retrocompatible.

    • Se cambió el nombre de la enumeración BlockThreshold a HarmBlockThreshold.

    • Se quitaron los valores de las siguientes enumeraciones: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason y FinishReason.

  • Métodos de BLOB

    • Se cambió el nombre de todos los métodos que incluían Blob como parte de su nombre para usar InlineData en su lugar.

  • Configuración de seguridad

    • Se cambió el campo method para que sea nulo.

  • Clase de duración

    • Se quitaron todos los usos de la clase Duration de Kotlin y se reemplazó por long. Este cambio proporciona una mejor interoperabilidad con Java.

  • Metadatos de citas

    • Se unió todos los campos declarados anteriormente en CitationMetadata en una clase nueva llamada Citation. Las citas se pueden encontrar en la lista llamada citations en CitationMetadata. Este cambio permite una mejor alineación de los tipos en todas las plataformas.

  • Cómo contar tokens

    • Se cambió el campo totalBillableCharacters para que sea nulo.

  • Total de caracteres facturables

    • Se cambió la propiedad totalBillableCharacters en CountTokensResponse para que sea opcional y refleje situaciones en las que no se envían caracteres.

  • Cómo crear una instancia de un modelo

    • Se movió el parámetro requestOptions al final de la lista de parámetros para alinearse con otras plataformas.

Posibles errores relacionados con la migración

Cuando realices la migración para usar la versión GA de Vertex AI in Firebase, es posible que encuentres errores si no completaste todos los cambios necesarios, como se describe en esta guía de migración.

Error 403: Requests to this API firebasevertexai.googleapis.com ... are blocked.

Si recibes un error 403 que dice Requests to this API firebasevertexai.googleapis.com ... are blocked., por lo general, significa que la clave de API en tu objeto o archivo de configuración de Firebase no tiene una API requerida en su lista de entidades permitidas para el producto que intentas usar.

Asegúrate de que la clave de API que usa tu app tenga todas las APIs requeridas incluidas en la lista de entidades permitidas de "restricciones de API". En el caso de Vertex AI in Firebase, tu clave de API debe tener, como mínimo, la API de Vertex AI in Firebase en su lista de entidades permitidas. Esta API debería haberse agregado automáticamente a la lista de entidades permitidas de tu clave de API cuando habilitaste la API nueva a través de la consola de Firebase.

Puedes ver todas tus claves de API en el panel APIs y servicios > Credenciales de la consola de Google Cloud.