Solución de problemas específicos de funciones

Soluciona problemas relacionados con modos o funciones concretas dentro de Genie.

Preflight no disponible

• Síntomas: el campo Preflight Questions no está disponible, o aparece un mensaje indicando que tu proveedor actual no lo admite.
• Causa: algunos proveedores, por ejemplo Anthropic, no admiten actualmente el paso de planificación de Preflight (Stage A) en modo CODE.
• Solución: abre Settings y cambia tu Coding Provider a uno que admita preflight, por ejemplo OpenAI o Google.
• Nota: preflight está siempre activado para los modos QUERY y DATA y no tiene un interruptor de usuario.

Local MCP Bridge: fallo de conexión 400 / SSE fallback

• Síntomas: los logs del IDE muestran invalid_http_request en streamable HTTP, Non-200 (400) en SSE fallback o fallos repetidos de conexión del cliente.
• Causa: desajuste de endpoint o ruta MCP, falta de cabecera bearer auth o Local MCP Bridge desactivado.
• Solución:
  1. En Genie Settings, confirma que Local MCP Bridge esté activado y que el estado sea running.
  2. Verifica que la configuración de tu IDE use la ruta /mcp (no solo el endpoint raíz).
  3. Verifica que esté presente Authorization: Bearer <token>.
  4. Vuelve a copiar la configuración con Copy IDE JSON en Settings.
  5. Asegúrate de que host y puerto coincidan con Genie (127.0.0.1 + el puerto configurado).

Local MCP Bridge: clientes estrictos rechazan el nombre de la herramienta

• Síntomas: el cliente MCP rechaza o filtra una herramienta por el formato de su nombre.
• Causa: algunos clientes imponen un esquema de nombres solo con guiones bajos.
• Solución: usa fm_get_fields_on_layout en entornos estrictos.
• Nota: Genie también acepta llamadas con alias (fm.get_fields_on_layout, fm-get_fields_on_layout) por compatibilidad, pero la forma con guiones bajos es la opción más segura por defecto.

Fallos de exportación (CSV/PNG)

• Síntomas: aparece un diálogo de guardado de archivo, pero el archivo no se escribe o queda vacío.
• Causa: faltan permisos de escritura para la carpeta de destino o hay un error transitorio en la generación de datos.
• Solución:
  1. Vuelve a ejecutar la consulta o la generación del gráfico una vez.
  2. Asegúrate de elegir un directorio local con permisos de escritura, por ejemplo Documents o Desktop.
  3. Verifica que el equipo tenga suficiente espacio libre.

Migración DATA: no hay plan activo o se pulsó una acción antigua

• Síntomas: el chat muestra “No active migration plan”, o pulsar una acción de migración no hace nada útil.
• Causa: el plan anterior se borró, se completó o fue sustituido por una nueva solicitud DATA.
• Solución:
  1. Inicia una nueva solicitud DATA con una intención de migración clara.
  2. Espera a ver “Migration plan ready (N steps)” antes de usar las acciones de los pasos.
  3. Evita usar enlaces de acción antiguos de mensajes anteriores después de iniciar un plan nuevo.

Migración DATA: un paso quedó detenido tras un fallo

• Síntomas: el chat indica que el paso actual de la migración está detenido.
• Causa: un fallo de validación o de ejecución detuvo el avance para proteger la integridad de los datos.
• Solución:
  1. Revisa el mensaje de fallo mostrado en el chat.
  2. Elige Retry Step si el SQL sigue siendo correcto.
  3. Elige Skip Step solo si aceptas el riesgo de inconsistencia en la migración.
  4. Elige Abort Plan si la secuencia no debe continuar.

Migración DATA: Execute All no está disponible

• Síntomas: el chat no ofrece Execute All, o la acción no está disponible para la respuesta DATA actual.
• Causa: la operación pendiente actual no forma parte de un plan de migración activo.
• Solución:
  1. Usa Confirm o Cancel para la ejecución DATA de una sola sentencia.
  2. Si tu intención es de varios pasos, reformula la solicitud como una secuencia de migración.
  3. Regenera y confirma que Genie devuelva un migration plan antes de usar Execute All.

Migración DATA: no coincide el texto de confirmación de toda la tabla

• Síntomas: Genie rechaza un intento de confirmación y pide la redacción exacta para toda la tabla.
• Causa: las operaciones de toda la tabla o destructivas requieren un lenguaje de confirmación estricto.
• Solución:
  1. Vuelve a leer el requisito de confirmación mostrado en el chat.
  2. Usa el enlace de acción proporcionado o la redacción exacta requerida.
  3. Si no se pretendía un impacto sobre toda la tabla, cancela y regenera SQL acotado.

Migración DATA: bloqueo por desajuste de placeholders

• Síntomas: el chat muestra un bloqueo por desajuste de placeholders/parámetros y la ejecución no comienza.
• Causa: el número de placeholders SQL no coincide con los parámetros suministrados.
• Solución:
  1. Regenera el SQL con valores literales concretos cuando corresponda.
  2. O regenera con una lista completa de parámetros que coincida exactamente con los placeholders.
  3. Reintenta la ejecución solo después de que desaparezca la advertencia de desajuste.

Migración DATA: CREATE INDEX está bloqueado

• Síntomas: el chat muestra un bloqueo de política o validación de DATA para CREATE INDEX.
• Causa: Genie no permite CREATE INDEX en modo DATA porque FileMaker gestiona la indexación mediante la configuración de campos y almacenamiento.
• Solución:
  1. Elimina la solicitud CREATE INDEX del flujo DATA.
  2. Abre en FileMaker la configuración de la tabla o del campo correspondiente para gestionar allí la indexación.
  3. Vuelve a ejecutar la solicitud DATA solo para los cambios de esquema o datos que sigan admitidos.

Páginas relacionadas

• Mode Behavior Matrix
• Settings Guide
• Troubleshooting Overview