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. 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 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.

{
  "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.

{
  "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

SurfaceClients / Atelier NordExemple

Résoudre un problèmeRetrouver la cause du blocage

Clients

AN

Atelier NordSoumission S-1042

À revoir

Changement proposé

Vérifiez d’abord le Field requis, puis la référence fournie à la Query du client.

Données et références

Client · Besoin · Tarifs

RevenirExaminer puis confirmer