--- title: "Résoudre un problème" url: https://developers.dagio.ai/fr/troubleshooting/ --- # Résoudre un problème ## Partir de l’effet observé Un diagnostic utile indique l’objet concerné, l’opération, le motif et l’action possible. Il conserve le vocabulaire métier dans l’interface et permet d’ouvrir les détails techniques lorsque l’intervention l’exige. Si une Surface ne peut pas être ouverte, reprenez son ouverture depuis son Workspace. Un message d’indisponibilité ne permet pas de conclure à un retrait d’accès ni à l’échec d’une opération précédente. Quand la version demandée a changé, rouvrez la version actuelle avant de poursuivre; ne répétez pas une Action déjà acceptée pour résoudre un problème de lecture. Pour une sauvegarde, distinguez la préparation de la saisie, une réponse encore inconnue et une version déjà enregistrée. Si la saisie ne peut pas être conservée pour une autre vue, gardez l’éditeur ouvert et réessayez avant de quitter ou de recharger. Si la réponse manque, reprenez la même demande en attente. Si la version est enregistrée mais son affichage ne peut pas être actualisé, rouvrez la Surface sans répéter la sauvegarde. Un conflit demande d’examiner le brouillon et la version actuelle; Surface ne les fusionne pas automatiquement. Changer la langue de l’interface ne relance pas la sauvegarde et ne remplace pas votre saisie. Distinguez une connexion à l’application hôte indisponible, un hôte qui ne prend pas en charge le contexte Surface et une synchronisation du contexte non confirmée. Ce dernier message ne prouve pas que l’AI a reçu le contexte. Si une nouvelle tentative de synchronisation est proposée, demandez-la explicitement; elle ne relance ni sauvegarde ni autre Action et ne reconnecte pas automatiquement l’hôte. Si les mises à jour en direct sont interrompues, utilisez **Reconnecter** quand ce geste est proposé. **Actualiser** reprend une lecture différée pendant que vous terminez la saisie ou réglez une sauvegarde en attente. Ces gestes relisent le travail courant autorisé; ils ne répètent ni sauvegarde ni Action, ne confirment pas une opération incertaine et ne prouvent pas un retrait d’accès. Conservez votre brouillon et examinez tout conflit de version avant de remplacer le contenu affiché. | Symptôme | Vérification | Suite utile | | ----------------------------------- | ------------------------------------------- | ------------------------------------------- | | Field absent | Placement Surface, Paramètres et définition | Corriger la présentation du Model | | Création impossible | Valeurs requises et Form | Afficher ou fournir l’information manquante | | Client introuvable | Cible du lien, recherche et accès | Vérifier intégration et droits | | Tableau incomplet | Query, filtres et pagination | Examiner le périmètre effectif | | Action indisponible | Conditions, capacité et permissions | Corriger la cause affichée | | Flow en attente | Étape, décision ou connexion | Ouvrir la prochaine action | | Proposition AI différente | Sources, version et profil | Examiner le contexte utilisé | | Modification distante conflictuelle | Brouillon et version courante | Comparer avant d’appliquer | ## Exemple Atelier Nord n’apparaît pas dans le sélecteur d’une soumission. Vérifiez d’abord le Workspace Clients configuré comme cible, le type de fiche et les droits du membre. Ne créez pas une seconde fiche pour contourner une mauvaise cible ou un refus de lecture. ## Préparer une demande d’aide Si un résultat du chat ne peut pas être affiché, rouvrez Surface pour consulter le contenu ou l’état courant de l’opération. Ce refus d’affichage ne permet pas de conclure que l’opération a été acceptée, refusée ou annulée. Si son issue reste incertaine, reprenez la même opération en attente plutôt que d’en soumettre une nouvelle. Pour un appel d'outil AI trop volumineux ou trop complexe, vérifiez les [limites des requêtes MCP](https://developers.dagio.ai/fr/ai/#limites-des-requêtes-mcp). Distinguez le refus affiché d'une réponse perdue; changer d'offre ne supprime pas une limite technique d'appel. Conservez l’identité de l’opération, le contexte et le message utile. Écartez les secrets, clés et informations privées non nécessaires. Précisez le résultat attendu et le comportement observé. Une capture de l’écran ne remplace pas l’état de l’opération lorsqu’une réponse est incertaine. ## Vérifier la reprise Après correction, reprenez l’opération concernée et contrôlez son résultat. Pour un changement de Model, utilisez la validation et l’aperçu; pour une opération déjà acceptée, consultez son reçu avant de relancer. Le [guide des nouvelles tentatives](https://developers.dagio.ai/fr/retries/) explique comment éviter les effets répétés. ## Exemples appliqués : Retrouver la cause du blocage Vérifiez d’abord le Field requis, puis la référence fournie à la Query du client. ### Configuration Fragment à placer dans `rules[]`. [Propriétés et valeurs admises](https://developers.dagio.ai/fr/reference/workspace-model-foundation/). ```json { "contract": "WorkspaceRule@1", "key": "company-required", "label": "Entreprise renseignée", "expression": { "kind": "present", "field": { "definitionPath": "workspace/clients/surface/client", "fieldKey": "company" } } } ``` ### Variante et raccordement Fragment à placer dans `presentation.recordProfiles[].queryBindings[]`. [Propriétés et valeurs admises](https://developers.dagio.ai/fr/reference/workspace-record-query-binding/). ```json { "key": "client-quotes", "queryKey": "client-quotes", "parameters": { "clientId": { "kind": "entity-id", "definitionPath": "workspace/clients/surface/client" } } } ``` ### Exemple de disposition UI La disposition illustrative ci-dessous situe cette configuration dans l’app Clients/Soumissions. Chaque fragment s’insère à l’emplacement indiqué; ses références aux Fields, Queries et Actions correspondent aux déclarations du Model. 1. Objet concerné 2. Changement proposé 3. Vérifications 4. Confirmer