Dépannage par fonctionnalité

Résolvez les problèmes liés à des modes ou fonctions spécifiques dans Genie.

Preflight indisponible

Symptoms : le champ Preflight Questions est indisponible, ou un message indique qu’il n’est pas pris en charge par votre fournisseur de code actuel.
Cause : certains fournisseurs, par exemple Anthropic, ne prennent pas encore en charge le passage de planification Preflight (Stage A) en mode CODE.
Fix : ouvrez Settings et basculez votre Coding Provider vers un fournisseur qui prend preflight en charge, par exemple OpenAI ou Google.
Note : Preflight est toujours activé pour les modes QUERY et DATA et ne dispose pas de bouton utilisateur.

Symptoms : les journaux de l’IDE montrent invalid_http_request en HTTP streamable, un repli SSE Non-200 (400) ou des échecs répétés de connexion du client.
Cause : décalage sur l’endpoint/le chemin MCP, en-tête d’authentification bearer manquant, ou Local MCP Bridge désactivé.
Fix :
1. Dans les réglages de Genie, confirmez que Local MCP Bridge est activé et que son état est en cours d’exécution.
2. Vérifiez que la configuration de votre IDE utilise le chemin URL /mcp et non un endpoint à la racine.
3. Vérifiez que Authorization: Bearer <token> est présent.
4. Recréez la configuration via Copy IDE JSON dans Settings.
5. Assurez-vous que l’hôte et le port correspondent à ceux de Genie, 127.0.0.1 plus le port configuré.

Symptoms : le client MCP rejette ou filtre un outil à cause du format de son nom.
Cause : certains clients imposent une convention de nommage avec underscores uniquement.
Fix : utilisez fm_get_fields_on_layout dans les environnements stricts.
Note : Genie accepte aussi des appels alias, fm.get_fields_on_layout et fm-get_fields_on_layout, pour des raisons de compatibilité, mais la forme avec underscores reste la plus sûre par défaut.

Symptoms : une boîte de dialogue d’enregistrement apparaît, mais le fichier n’est pas écrit ou reste vide.
Cause : permissions d’écriture manquantes sur le dossier cible, ou erreur transitoire pendant la génération des données.
Fix:
1. Relancez une fois la requête ou la génération du graphique.
2. Assurez-vous de choisir un dossier local accessible en écriture, par exemple Documents ou Bureau.
3. Vérifiez que votre ordinateur dispose de suffisamment d’espace libre.

Symptoms : le chat affiche “No active migration plan,” ou cliquer sur une action de migration ne produit rien d’utile.
Cause : le plan précédent a été effacé, terminé ou remplacé par une nouvelle demande DATA.
Fix :
1. Lancez une nouvelle demande DATA avec une intention de migration claire.
2. Attendez le message “Migration plan ready (N steps)” avant d’utiliser les actions d’étape.
3. Évitez d’utiliser de vieux liens d’action issus de messages antérieurs après avoir démarré un nouveau plan.

Symptoms : le chat indique que l’étape de migration en cours est interrompue.
Cause : un échec de validation ou d’exécution a stoppé la progression pour protéger l’intégrité des données.
Fix :
1. Relisez le message d’échec affiché dans le chat.
2. Choisissez Retry Step si le SQL est toujours correct.
3. Choisissez Skip Step seulement si vous acceptez le risque d’incohérence dans la migration.
4. Choisissez Abort Plan si la séquence ne doit pas continuer.

Symptoms : le chat ne propose pas Execute All, ou l’action n’est pas disponible pour la réponse DATA courante.
Cause : l’opération en attente ne fait pas partie d’un plan de migration actif.
Fix :
1. Utilisez Confirm ou Cancel pour une exécution DATA en une seule instruction.
2. Si votre intention comporte plusieurs étapes, reformulez la demande comme une séquence de migration.
3. Relancez la génération et confirmez que Genie renvoie bien un plan de migration avant d’utiliser Execute All.

Symptoms : Genie rejette une tentative de confirmation et exige la formulation exacte pour une opération sur table complète.
Cause : les opérations destructrices ou touchant toute une table exigent une formulation de confirmation stricte.
Fix :
1. Relisez l’exigence de confirmation affichée dans le chat.
2. Utilisez le lien d’action fourni ou la formulation exacte demandée.
3. Si vous ne vouliez pas impacter toute la table, annulez puis régénérez un SQL limité au bon périmètre.

Symptoms : le chat affiche un blocage lié aux placeholders/paramètres et l’exécution ne démarre pas.
Cause : le nombre de placeholders SQL ne correspond pas aux paramètres fournis.
Fix :
1. Régénérez le SQL avec des valeurs littérales concrètes lorsque c’est approprié.
2. Ou régénérez avec une liste complète de paramètres correspondant exactement aux placeholders.
3. Ne réessayez l’exécution qu’une fois l’avertissement de désaccord effacé.

Symptoms : le chat affiche un blocage de politique DATA ou de validation pour CREATE INDEX.
Cause : Genie n’autorise pas CREATE INDEX en mode DATA, car FileMaker gère l’indexation via les réglages de champs et de stockage.
Fix :
1. Retirez la demande CREATE INDEX du workflow DATA.
2. Ouvrez dans FileMaker les réglages de la table ou du champ concerné afin d’y gérer l’indexation.
3. Relancez la demande DATA uniquement pour les changements de schéma ou de données encore pris en charge.