Puedes aplicar el modo solo para plantillas en tu proyecto de Firebase para que todas las solicitudes de Gemini API a través de Firebase AI Logic deban usar plantillas de instrucciones del servidor.
Cuando se bloquea una solicitud, la respuesta será un error 403: unauthorized.
Consideraciones importantes
Ten en cuenta las siguientes consideraciones importantes para el modo solo de plantilla.
Cuándo se aplica el modo de solo plantilla
Cuando se aplica el modo de solo plantilla, ten en cuenta lo siguiente:
Este parámetro de configuración es para todo el proyecto en Firebase AI Logic.
- Se aplica a todas las apps registradas en el proyecto.
- Solo se aplica al proyecto en el que se aplica.
Este parámetro de configuración se aplica a todas las solicitudes a través de Firebase AI Logic tanto a Gemini Developer API como a Vertex AI Gemini API.
Este parámetro de configuración bloquea cualquier solicitud a través de Firebase AI Logic que no use plantillas de instrucciones del servidor. Esto incluye bloquear las solicitudes de tu app que usen capacidades aún no admitidas para las plantillas de instrucciones del servidor.
Este parámetro de configuración no bloquea las solicitudes de Gemini API en tu proyecto que no se realicen a través de Firebase AI Logic.
Si usas la API de REST de Firebase AI Logic, haz lo siguiente:
- Este parámetro de configuración no bloquea las solicitudes de inferencia que usan plantillas de instrucciones del servidor (como
templateGenerateContentotemplateStreamGenerateContent). - Este parámetro de configuración no bloquea las solicitudes del plano de control (como las que se usan para administrar plantillas y configuraciones).
- Este parámetro de configuración no bloquea las solicitudes de inferencia que usan plantillas de instrucciones del servidor (como
Este parámetro de configuración no bloquea las solicitudes a
countTokens(la API de Count Tokens).
Antes de aplicar el modo de solo plantilla
Ten en cuenta lo siguiente antes de aplicar el modo de solo plantilla:
Si tienes versiones existentes de tu app que no usan plantillas de instrucciones del servidor, haz lo siguiente:
- Este parámetro de configuración bloqueará las solicitudes a través de Firebase AI Logic de esas versiones existentes de la app.
- Asegúrate de que todos los clientes activos se actualicen para usar plantillas de instrucciones del servidor antes de aplicar el modo de solo plantilla.
Si tu app usa capacidades aún no compatibles con las plantillas de instrucciones del servidor, haz lo siguiente:
- Este parámetro de configuración bloqueará las solicitudes a través de Firebase AI Logic para estas capacidades aún no admitidas porque no usan (y no pueden usar) plantillas de instrucciones del servidor.
- Asegúrate de que tu app (incluida cualquier versión anterior) no use de forma activa ninguna de esas capacidades que aún no se admiten antes de aplicar el modo solo de plantillas.
Administra el parámetro de configuración del modo de solo plantilla
Puedes administrar el parámetro de configuración del modo de solo plantilla en la consola de Firebase.
Roles y permisos de IAM obligatorios
Para administrar el parámetro de configuración del modo solo de plantilla, se requiere el permiso firebasevertexai.configs.update, que se incluye de forma predeterminada en los siguientes roles de IAM: propietario, editor, administrador de Firebase y administrador de lógica de IA de Firebase.
Aplicar el modo de solo plantilla
Sigue estos pasos para aplicar el modo de solo plantilla en tu proyecto de Firebase:
Si aún no lo hiciste, revisa las consideraciones importantes para el modo solo de plantilla que se mencionaron anteriormente en esta guía.
En la consola de Firebase, ve a la pestaña Configuración de Servicios de IA > Lógica de IA.
En Modo de plantilla, desliza el botón de activación de Aplicar el modo de solo plantilla a Aplicado.
Revisa el diálogo de confirmación y, luego, haz clic en Confirmar.
Detener la aplicación del modo de solo plantilla
Si detienes la aplicación del modo de solo plantilla, ten en cuenta lo siguiente:
- Se permitirán las solicitudes a través de Firebase AI Logic que no usen plantillas de instrucciones del servidor.
- Este es un parámetro de configuración para todo el proyecto de Firebase AI Logic.
Sigue estos pasos para detener la aplicación del modo solo para plantillas en tu proyecto de Firebase:
En la consola de Firebase, ve a la pestaña Configuración de Servicios de IA > Lógica de IA.
En Modo de plantilla, desactiva Aplicar el modo de solo plantilla.
Revisa el diálogo de confirmación y, luego, haz clic en Confirmar.