Prácticas recomendadas y consideraciones para las plantillas


En esta página, se describen algunas prácticas recomendadas y consideraciones para las plantillas de instrucciones del servidor, incluidas las funciones que aún no son compatibles. Ten en cuenta que muchas de estas funciones solo están disponibles en la versión inicial de las plantillas de instrucciones del servidor, así que consulta las notas de la versión para obtener actualizaciones.

Prácticas recomendadas

Muchas de estas prácticas recomendadas también se detallan en Administra tus plantillas.

Crea una versión de tus plantillas

Protege tu plantilla

  • Bloquea tu plantilla antes de pasar a producción. Evita editar las plantillas que se usan en producción.

    • Bloquear una plantilla actúa como protección contra la edición no intencional, pero el bloqueo no impide por completo la edición. Un miembro del proyecto con los permisos adecuados siempre puede desbloquear una plantilla para editarla.

    • Te recomendamos que bloquees las plantillas que el código usa de forma activa, en especial el código de producción.

  • Escribe una validación de entrada sólida para tus variables de entrada, lo que puede ayudar con lo siguiente:

    • Puede ayudar a proteger contra la inyección de instrucciones.
    • Puede ayudar a garantizar que las solicitudes se realicen correctamente y que las respuestas sean las esperadas.

Funciones que aún no son compatibles

Muchas de estas funciones que aún no son compatibles solo están disponibles en la versión inicial, así que consulta las notas de la versión para obtener actualizaciones.

Capacidades de Firebase AI Logic que aún no son compatibles

Las plantillas de instrucciones del servidor aún no admiten las siguientes capacidades de Firebase AI Logic. Varias de estas capacidades estarán disponibles próximamente.

  • Chat
  • Llamada a función
  • Edición iterativa de imágenes (chat) con Gemini modelos (requiere chat)
  • Transmisión bidireccional (Gemini Live API)
  • Inferencia híbrida o integrada en el dispositivo
  • Restringir el resultado a una lista de enumeraciones

Ten en cuenta también que, si usas la supervisión de IA en la Firebase consola, el ID de la plantilla aún no se propaga en ningún registro.

Elementos comunes de Dotprompt que aún no son compatibles

Es probable que pronto las plantillas de instrucciones del servidor admitan los siguientes elementos comunes de Dotprompt:

  • Usa la especificación del esquema JSON para los esquemas de entrada y salida en tu frontmatter.

  • Declara una definición de campo comodín con *.

  • Usa @key o itera de forma general sobre los campos de una entrada de objeto (que es el caso en el que @key es relevante).

  • Usa @root, que te permite hacer referencia al contexto de la variable raíz, independientemente del this actual.

Es probable que no las plantillas de instrucciones del servidor admitan los siguientes elementos comunes de Dotprompt:

  • Usa parciales, que son fragmentos de plantillas reutilizables que se pueden incluir en otras plantillas.

Otras consideraciones

  • De forma predeterminada, cuando usas la IU guiada en la consola Firebase, aprovisionamos la plantilla en todas las regiones disponibles para Firebase AI Logic. Si usas la Vertex AI Gemini API y tu caso de uso requiere restricciones basadas en la ubicación, puedes especificar la ubicación de tu plantilla con la API de REST.

  • Si quieres proporcionar una plantilla de instrucciones del servidor como un archivo (en lugar de usar la IU guiada de la consola Firebase), puedes usar la API de REST. Ten en cuenta que las plantillas de instrucciones del servidor no admiten el esquema definido en el código de la app y que se pasa a la plantilla.

  • Aunque la plantilla está en el servidor, no puede interactuar directamente con los otros recursos del servidor de tu proyecto de Firebase (como una base de datos) excepto con las URLs Cloud Storage for Firebase (que se pueden proporcionar como variables de entrada ).