Lista de tareas de producción para usar Firebase AI Logic

Cuando todo esté listo para lanzar tu app y que los usuarios finales reales interactúen con sus funciones potenciadas por IA, asegúrate de revisar esta lista de tareas con prácticas recomendadas y consideraciones importantes.

General

Revisa la lista de tareas general para el lanzamiento

Revisa la lista de tareas para el lanzamiento de Firebase y conoce las prácticas recomendadas importantes antes de lanzar cualquier app de Firebase a producción.

Sigue las prácticas recomendadas para los proyectos de Firebase

Usa proyectos de Firebase independientes para el desarrollo, las pruebas y la producción. Revisa más prácticas recomendadas para administrar tus proyectos.

Acceso y seguridad

Revisa las listas de tareas de seguridad

Revisa la lista de tareas de seguridad de Firebase y la lista de tareas de seguridad dedicada para Firebase AI Logic para conocer las prácticas recomendadas importantes sobre el acceso y la seguridad.

Aplicar Firebase App Check

Aplica Firebase App Check para ayudar a proteger Gemini API de abusos cuando se lo llama directamente desde tu app. Cuando se aplica App Check, se verifica que las solicitudes entrantes provengan de tu app auténtica o de un dispositivo no alterado.

App Check admite proveedores de certificación para plataformas de Apple (DeviceCheck, App Attest o reCAPTCHA Enterprise), Android (Play Integrity o reCAPTCHA Enterprise) y Web (reCAPTCHA Enterprise). También admite todos estos proveedores para apps de Flutter y Unity.

Además, considera aplicar la protección contra repetición, lo que significa que los tokens son de un solo uso. Esta opción ofrece una protección mejorada que va más allá de la protección de referencia y te permite establecer un nivel de protección adecuado para tu app y tus casos de uso.

Configura restricciones para tus claves de API de Firebase

Las claves de API de Firebase identifican tu proyecto de Firebase y app cuando se realizan solicitudes. Para evitar el uso no autorizado de tus claves de API, haz lo siguiente:

  • Establece "Restricciones de aplicaciones" en la consola de Google Cloud para limitar el uso de la clave solo a las solicitudes del ID del paquete específico de tu app (Apple), el nombre del paquete y la huella digital SHA-1 (Android) o la URL de referencia HTTP (Web).

  • Revisa la lista de entidades permitidas de las "restricciones de API" de cada clave:

    • Asegúrate de que la API de Firebase AI Logic (firebasevertexai.googleapis.com) esté en la lista de entidades permitidas.
    • Asegúrate de que las únicas otras APIs de la lista de entidades permitidas sean los servicios de Firebase específicos que requiere tu app. Consulta la lista de APIs obligatorias para las claves de Firebase restringidas.

Ten en cuenta que las APIs relacionadas con Firebase usan claves de API solo para identificar el proyecto o la app de Firebase, no para la autorización de llamar a la API.

Restringir las solicitudes solo a los usuarios autenticados

Considera aplicar el modo de usuarios autenticados para que todas las solicitudes a través de Firebase AI Logic incluyan credenciales válidas de Firebase Authentication. Si una solicitud proviene de un usuario final no autenticado, se rechaza con un error 401: unauthenticated.

Supervisión, límites y facturación

Configura la supervisión de la IA en la consola de Firebase

Configura la Supervisión de la IA en la consola de Firebase para obtener visibilidad de las métricas de rendimiento clave, como los recuentos de solicitudes, la latencia, el uso de tokens y las tasas de error. También puedes inspeccionar seguimientos individuales en la consola deGoogle Cloud.

Establece límites de frecuencia y administra cuotas

Protege tu proyecto de aumentos repentinos de uso inesperados y ataques de denegación de billetera:

Evita facturas sorpresa con alertas y límites de inversión

Si tu proyecto de Firebase tiene el plan de precios Blaze de pago por uso, haz lo siguiente:

Administración de configuraciones

Usa una versión de modelo estable en tu app de producción

En tu app de producción, solo usa versiones de modelos estables (como gemini-3.8-flash). No uses una versión preliminar o experimental ni un alias -latest.

Usa Firebase Remote Config o plantillas de instrucciones del servidor

Cuando usas Remote Config o plantillas de instrucciones del servidor, puedes controlar parámetros de configuración importantes para las funciones potenciadas por IA de tu app en la nube (del lado del servidor) en lugar de codificar valores de forma fija en tu código. Esto significa que puedes actualizar tus parámetros de configuración sin lanzar una nueva versión de la app.

  • (Se recomienda enfáticamente) Realiza cambios a pedido en el nombre del modelo que se usa para tu función potenciada por IA a medida que se lanzan modelos nuevos o se cierran otros. Consulta los detalles para usar Remote Config o plantillas de instrucciones del servidor.

  • (Opcional) Controla de forma dinámica y condicional otros parámetros para tu función potenciada por IA, por ejemplo, la configuración del modelo (como los tokens de salida máximos), la configuración de seguridad, las instrucciones del sistema y los datos de instrucciones. Consulta los detalles para usar Remote Config o plantillas de instrucciones del servidor.

  • (Opcional) Establece un parámetro minimum_version en Remote Config para comparar la versión actual de la app con la versión más reciente definida en Remote Config, de modo que se muestre una notificación de actualización a los usuarios o se los obligue a actualizar.

Establece la ubicación para acceder al modelo

Solo está disponible cuando usas Agent Platform Gemini API (formerly Vertex AI) como tu proveedor de API.

Establece una ubicación para acceder al modelo y ayudar a optimizar la cuota y evitar la latencia para tus usuarios.

Si no especificas una ubicación, el valor predeterminado es global (cuando se usa la nueva sintaxis de inicialización de "Agent Platform"). Puedes establecer esta ubicación durante la inicialización o, de manera opcional, usar Firebase Remote Config para cambiarla de forma dinámica según la ubicación de cada usuario.