Generación de platos con IA

La herramienta de generación de platos con IA lee tus cartas, fichas de receta o exportaciones de TPV y las convierte en platos y preparaciones dentro de haddock. Extrae el nombre del plato, su tipo, el precio, los ingredientes, cantidades y unidades y, cuando es posible, asocia cada ingrediente a un producto que ya tienes en tu cuenta.

Este artículo explica qué hace la herramienta, cómo funciona internamente y cómo utilizarla.

Qué hace

A partir de una sola subida, la herramienta genera platos en borrador que incluyen:

• Nombre del plato, tipo (plato, preparación, modificador o combo), sección/etiqueta y precio de venta cuando aparece en el documento.
• Lista de ingredientes con nombre, cantidad, unidad (g, kg, ml, l, uds) y un producto sugerido del catálogo de tu cuenta.
• Información de rendimiento (masa total y número de porciones) en las recetas.
• Subpreparaciones, ordenadas para que cualquier preparación referenciada por otra se cree primero.
• Slots de combo para platos combinados con opciones.
• Alérgenos, heredados de los productos asociados.
• Una imagen del plato generada automáticamente en segundo plano.
• Una puntuación de confianza (alta, media, baja) y la acción prevista (crear nuevo o actualizar existente) para cada borrador.

Formatos admitidos

Límites

• Tamaño máximo por archivo: 25 MB.
• Tamaño máximo agregado: 100 MB por trabajo de importación.
• Máximo de archivos por trabajo: 10.
• Idiomas: multilingüe. La extracción funciona de forma nativa en español, inglés, francés y otros idiomas.
• Tiempo de procesado: las cartas pequeñas (hasta ~25 platos) suelen estar listas en 2–4 minutos. Los archivos más grandes tardan aproximadamente 1 minuto por cada 10 platos: unos 100 platos rondan los 10–15 minutos, y varios cientos de platos pueden acercarse a una hora. El trabajo se ejecuta de forma asíncrona, así que puedes cerrar la pantalla y volver más tarde. Si tienes un Excel muy grande, dividirlo en lotes más pequeños facilita la revisión posterior.

Cómo funciona

1. Subida. Los archivos se envían en una única petición multipart y se validan contra los límites de formato y tamaño.
2. Extracción. Cada archivo se procesa en paralelo (hasta tres a la vez) con Google Gemini. Las imágenes y los PDF pasan por una pipeline de visión, las hojas de cálculo se analizan hoja por hoja y los documentos de Word se leen como texto. El modelo devuelve un borrador JSON estructurado por cada plato detectado.
3. Asociación de ingredientes. Para cada ingrediente extraído, el sistema realiza una búsqueda difusa contra los productos de tu cuenta y contra el catálogo global. Las coincidencias por encima del umbral de similitud se asocian automáticamente; las más débiles se ofrecen como sugerencia para que las confirmes.
4. Generación de imagen. Se genera una foto del plato en una tarea en segundo plano y se adjunta al borrador cuando está lista.
5. Revisión. Todos los borradores se presentan en una pantalla de revisión. Puedes editar cualquier campo, cambiar las asociaciones, eliminar borradores o aceptarlos tal cual.
6. Confirmación. Al confirmar, cada borrador se guarda aplicando la lógica de upsert que se describe a continuación.

Cómo funciona el guardado (upsert)

Los platos nunca se sobrescriben. Para cada borrador, haddock busca un plato existente con el mismo nombre (sin distinguir mayúsculas y eliminando espacios) y decide si crearlo o actualizarlo.

• Si no existe ningún plato con ese nombre, se crea uno nuevo con los ingredientes y los datos extraídos.
• Si ya existe un plato con ese nombre, se actualiza con la nueva información.

La actualización es puramente aditiva sobre los ingredientes:

• Los ingredientes nuevos detectados por la IA se añaden al plato existente.
• Si un ingrediente ya existente se detecta de nuevo con una cantidad o unidad distinta, ambos campos se actualizan.
• Si un ingrediente que ya estaba en el plato no aparece en la nueva extracción, se mantiene. Reimportar nunca elimina ingredientes.

Este comportamiento protege las ediciones manuales, los ingredientes personalizados y las cantidades que tu equipo haya configurado. Cualquier ingrediente que quieras eliminar debe borrarse explícitamente desde el plato.

Paso a paso

1. Abre la sección de Platos o Preparaciones. Desde el estado vacío, la barra de herramientas del listado o el checklist de activación, pulsa Importar con IA. Si hay un trabajo anterior en curso, el botón lo retoma.
2. En la pantalla del generador, arrastra los archivos a la zona de subida o usa Examinar o Hacer foto para añadirlos. Puedes mezclar imágenes, PDF y hojas de cálculo en el mismo trabajo.
3. Confirma la subida. El trabajo arranca y muestra el progreso por archivo. Puedes salir de la pantalla; la URL incluye un jobId al que puedes volver.
4. Cuando la extracción termina, la pantalla de revisión muestra cada plato en borrador con sus ingredientes, las sugerencias de asociación, la puntuación de confianza y la acción prevista (crear o actualizar).
5. Edita los campos que necesiten ajuste: nombre del plato, tipo, precio, cantidad o unidad de cada ingrediente, producto asociado, alérgenos.
6. Pulsa Confirmar para guardar los borradores seleccionados en tu cuenta. Los platos creados aparecen en el listado; los actualizados muestran el conjunto de ingredientes resultante de la fusión.

Resultados parciales y errores

• Si la extracción produce resultados parciales (por ejemplo, se reconocen tres de cinco platos), los borradores reconocidos se muestran junto a un aviso que indica qué se ha omitido y por qué.
• Si un archivo no se puede leer o su salida es inválida, se omite y se notifica en los avisos.
• Si el trabajo falla por completo, puedes volver a lanzar la importación; los borradores ya confirmados no se ven afectados.

Buenas prácticas

• Sube imágenes claras y en alta resolución. Las fotos frontales, con la carta completa visible y buena iluminación, dan los mejores resultados.
• Divide las cartas muy grandes en lotes de hasta diez archivos para respetar los límites del trabajo.
• Revisa la puntuación de confianza antes de confirmar. Los borradores de baja confianza merecen una segunda mirada.
• Para platos que ya tienes creados manualmente, la importación los actualizará en lugar de duplicarlos. Verifica los ingredientes fusionados después de la primera ejecución.

Actualizado el: 08/07/2026