États IA
Concevez les moments qu'une fonctionnalité IA montre en dehors de celui où elle fonctionne.
Les équipes conçoivent la démo : l'utilisateur demande, l'IA répond, tout le monde applaudit. Puis de vraies personnes l'utilisent. Elles demandent quelque chose qu'elle ne peut pas faire, ça prend quatorze secondes, elle répond avec une confiance totale et se trompe, la connexion se coupe en plein milieu d'une phrase, et le produit affiche un spinner et « Une erreur s'est produite ». Maintenant que l'IA agit aussi – elle envoie, réserve, édite et continue de travailler sans que personne ne regarde – les moments non conçus sont pires : elle a fait quelque chose, et l'utilisateur ne peut pas dire quoi.
Donc le travail n'est pas « concevoir le chat ». C'est : à chaque instant, l'utilisateur sait ce que l'IA fait, sur quoi elle se base, et ce qu'il peut faire ensuite – et, quand elle agit pour lui, ce qu'elle a fait et comment l'annuler.
Le but est une confiance calibrée : les utilisateurs comptent sur la fonctionnalité autant qu'elle le mérite, cas par cas. Les deux manières de manquer sont des échecs – accepter sans regarder, et tout refaire à la main.
Ce que toute fonctionnalité IA doit bien faire
Vérifiez d'abord ceux-ci. Ce sont ceux qu'un utilisateur remarque quand ils manquent.
- Jamais de spinner nu. Après environ deux secondes, l'utilisateur a besoin de savoir ce qui se passe, et après dix, comment l'arrêter ou partir.
- Quatre « non » différents. Ne sait pas (aucune information), ne peut pas (pas quelque chose qu'elle fait), ne veut pas (pas autorisé) et est cassée (panne système) ont des causes différentes et des prochaines étapes différentes. Une erreur générique pour les quatre pousse les utilisateurs à réessayer des choses qui ne fonctionneront jamais.
- Ne pas savoir est un état conçu, pas une erreur. « Je n'ai pas trouvé cela dans vos documents » est une bonne réponse. C'est ce qui rend les autres réponses crédibles.
- Rien ne semble complet quand il ne l'est pas. Un résultat partiel qui a l'air complet est l'état le plus dangereux qui soit, car personne ne le vérifie.
- Les limites sont dites dès le début. L'utilisateur apprend ce qu'elle peut et ne peut pas faire dès le premier écran, pas en échouant.
- Chaque impasse a une issue, et rien de ce que l'utilisateur lui a donné n'est perdu : ce qu'il a tapé, attaché ou sélectionné, et le résultat précédent, sont toujours là après tout échec.
- Vérifier coûte moins que refaire. Les réponses montrent sur quoi elles s'appuient, proportionnellement aux enjeux – la source à côté de l'affirmation, les pages couvertes, la date de mise à jour. Si vérifier signifie refaire le travail, la fonctionnalité ne fait gagner rien.
- Avant d'agir, elle montre ; après avoir agi, elle peut être annulée. Tout ce qui envoie, supprime, paie ou modifie quelque chose reçoit un aperçu, et une confirmation quand cela ne peut pas être annulé. Confirmez ce qui compte, pas tout : les invites constantes entraînent les gens à approuver sans lire.
- Le travail effectué sans surveillance revient sous forme de rapport, pas de célébration : ce qui a été fait, ce qui ne l'a pas été, ce qui n'a pas été vérifié, et par où commencer à regarder.
- Elle dit seulement ce que le système peut savoir. Pas d'étiquette de confiance que le modèle ne peut pas soutenir, pas de « j'ai vérifié » quand rien n'a été vérifié, pas de « je me souviendrai » quand rien n'est stocké.
Comment travailler
-
Comprenez la fonctionnalité avant de dessiner quoi que ce soit. Vous avez besoin : de ce que l'IA fait et pour qui ; la surface (lisez
references/surfaces.md, y compris si le chat est la bonne) ; ce qu'elle lit et ce qu'elle peut modifier ; ce que le système peut réellement détecter et exposer – streaming, sources, un signal de refus, un score de récupération, des types d'erreur, des événements d'étape ; si un recours humain existe ; la langue et le registre. Lisez ce que l'utilisateur vous a donné, puis demandez ce qui manque en une seule fois. Si vous ne pouvez pas demander (un run non interactif, ou l'utilisateur est absent), supposez la réponse la plus probable, marquez chaque déclencheur qui en dépend à confirmer, et listez les hypothèses. N'inventez pas de capacités : un état que le système ne peut pas détecter ne peut pas être construit. C'est différent d'un signal que l'équipe doit construire : si un état dont la fonctionnalité a besoin dépend de quelque chose que le système n'expose pas encore (un type d'erreur, un indicateur de refus), concevez l'état et listez le signal comme à construire dans le tableau des signaux – ce tableau est souvent la chose la plus utile que l'ingénierie reçoit de vous. -
Établissez les enjeux. Ils décident de combien chaque état a besoin.
Enjeux Exemples Ce qui change Faibles brainstorming, réécrire une phrase, questions informelles Touche légère : régénérer et éditer sont le filet de sécurité Moyens résumés sur lesquels les gens agissent, réponses sur le propre compte ou les données de l'entreprise de l'utilisateur Sources, périmètre visible, un « non trouvé » clair Élevés argent, santé, droit, sécurité, tout ce qui est envoyé à d'autres ou irréversible Confirmation avant d'agir, preuve dans le chemin, une voie humaine, une piste d'audit Les enjeux viennent de ce que les gens font avec la sortie, pas du fait que l'IA agisse : un résumé en lecture seule d'un contrat sur lequel des avocats s'appuient est à enjeux élevés. Pour une fonctionnalité à enjeux élevés qui ne prend aucune action, « élevé » signifie preuve dans le chemin, couverture visible et une voie humaine – il n'y a rien à confirmer.
-
Passez en revue les façons dont elle échoue (
references/failure-modes.md). La plupart sont silencieuses : une réponse erronée fluide, une omission, un agent en faisant plus que demandé, une instruction plantée dans un document. Pour chacune qui peut se produire ici, nommez l'état ou le motif qui s'en défend. -
Construisez la carte des états. Parcourez chaque état dans
references/states.mdet marquez-le :- S'applique – oui, non (avec la raison), ou seulement si un signal existe que vous n'avez pas pu confirmer.
- Aujourd'hui (en révisant quelque chose qui existe) – conçu, incomplet (il existe mais manque quelque chose que les enjeux exigent – dites quoi), générique (un fourre-tout le gère) ou manquant.
Un état seulement si reçoit un bloc de spécification et une ligne dans la carte, compte comme « à confirmer » dans la bande de couverture plutôt que dans le total, et reçoit une carte seulement quand il est suffisamment probable pour valoir la peine d'être dessiné.
Si l'IA exécute plusieurs étapes, utilise des outils par elle-même ou travaille pendant que l'utilisateur est absent, faites de même avec les états de délégation dans
references/delegation.md, et remplissez le niveau d'autonomie et le tableau des permissions pour chaque type d'action. Un chat qui prend une action après que l'utilisateur l'ait confirmée n'est pas un agent : l'état 5 (avec son écran « après confirmation » et l'annulation) le couvre, plus un tableau des permissions sur trois colonnes. Ne forcez pas D1-D12 dessus. Ne sautez pas la carte même lorsque l'utilisateur a demandé un seul état : dites-lui de quels autres la fonctionnalité a besoin. -
Spécifiez chaque état qui s'applique dans le format ci-dessous.
-
Dessinez le tableau. Commencez par
assets/template.html: une carte par état, montrant le vrai composant dans cet état avec la copie finale. Une liste d'états en prose reçoit un hochement de tête ; un tableau où les lacunes sont visiblement manquantes est corrigé. Utilisez l'apparence du produit si elle vous a été donnée (couleurs, composants, captures d'écran) ; sinon gardez le style neutre du modèle et dites-le. Dessinez la vraie surface de la fonctionnalité : une fonctionnalité à bouton et panneau reçoit des panneaux, pas des bulles de chat. Un état qui nécessite plusieurs écrans (avant et après confirmation) reste une carte avec ces écrans. Pour une nouvelle conception, supprimez le bloc de résultats du modèle et la colonne Aujourd'hui de la carte, et laissez la ligne de couverture dire combien d'états s'appliquent, combien ne s'appliquent pas, et combien attendent un signal. -
Rédigez les textes en suivant
references/copy.md, dans la langue et le registre du produit. -
Rédigez le script de test et les mesures (
references/measure.md) : une entrée qui provoque chaque état, et ce qu'il faut journaliser pour cela. -
Révisez par rapport à
references/checklist.mdetreferences/anti-patterns.md, en regardant le tableau rendu, pas la source.python scripts/screenshot.py board.html board.pngle rend en une image que vous pouvez ouvrir (les navigateurs intégrés refusent souvent les fichiers locaux) ; ajoutez--tile 1400pour l'obtenir en tranches lisibles quand le tableau est long. Si vous modifiez le tableau après avoir regardé, rendez à nouveau. -
Livrez le tableau, la spécification, et une courte liste de ce que vous avez supposé et de ce dont vous avez besoin de réponse. Dites ce que vous avez vérifié et ce que vous n'avez pas vérifié.
Que lire. Toujours : states.md, copy.md, checklist.md, et la section de surfaces.md pour cette surface. Pour une révision, aussi failure-modes.md et anti-patterns.md. Uniquement pour les agents (plusieurs étapes, outils, travail sans surveillance) : delegation.md. measure.md quand vous rédigez le script de test.
Les états
Quatorze états de réponse en cinq moments. Chacun est détaillé dans references/states.md avec ce dont l'utilisateur a besoin, le motif, l'anti-motif et le texte.
| Moment | État | L'utilisateur demande |
|---|---|---|
| Avant | 1. Première utilisation | Qu'est-ce que c'est et que puis-je demander ? |
| 2. Composition | Qu'est-ce que ça va utiliser ? Ma saisie est-elle correcte ? | |
| Pendant | 3. Travail en cours | Est-ce que ça fait quelque chose ? Combien de temps ? Puis-je l'arrêter ? |
| 4. Besoin d'une clarification | De quoi a-t-il besoin de ma part ? | |
| 5. Besoin de mon feu vert | Qu'est-ce que ça va exactement faire ? | |
| Réponse | 6. Réponse | Sur quoi ça se base ? Que puis-je en faire ? |
| 7. Réponse partielle | Quelle partie est faite et laquelle ne l'est pas ? | |
| 8. Incertain | À quel point puis-je m'y fier ? | |
| Non | 9. Ne sait pas | Y a-t-il une réponse, ou n'a-t-il pas regardé au bon endroit ? |
| 10. Ne peut pas faire ça | Qui ou quoi peut le faire ? | |
| 11. Ne veut pas faire ça | Est-ce moi, ou la règle ? Que puis-je demander à la place ? | |
| 12. Cassé | Ai-je perdu mon travail ? Dois-je réessayer ? | |
| Après | 13. Corrigé | A-t-il pris ma correction ? Cela se reproduira-t-il ? |
| 14. Transféré à un humain | Qui l'a maintenant, que savent-ils, et quand ? |
Douze états de délégation, pour l'IA qui agit. Détaillés dans references/delegation.md.
| État | L'utilisateur demande |
|---|---|
| D1. Brief | A-t-il compris la tâche, et ses limites ? |
| D2. Plan | Comment va-t-il s'y prendre, et puis-je modifier cela ? |
| D3. Permission | Qu'est-ce que je le laisse exactement toucher, et pour combien de temps ? |
| D4. Travail sans surveillance | Est-il toujours sur la bonne voie ? Dois-je surveiller ? |
| D5. A besoin de vous | Qu'attend-il, et que se passe-t-il si je ne réponds pas ? |
| D6. Redirigé | A-t-il pris la nouvelle instruction ? |
| D7. Compte rendu | Qu'a-t-il fait, qu'a-t-il ne fait pas, et par où dois-je regarder d'abord ? |
| D8. Révision à grande échelle | Lesquelles de ces 140 modifications dois-je vraiment examiner ? |
| D9. Annulation et réparation | Puis-je annuler – tout, ou juste ceci ? |
| D10. A mal tourné en son absence | À quel point est-ce grave, et où s'est-il arrêté ? |
| D11. Apprentissage | Que suppose-t-il maintenant à mon sujet ? |
| D12. Agit envers les autres | Que voient les autres – et savent-ils que c'était l'IA ? |
Pour un agent qui travaille en arrière-plan sans conversation, plusieurs états de réponse sont remplacés par leur équivalent de délégation plutôt que dessinés deux fois : Composition par D1 Brief, Travail en cours par D4, Besoin d'une clarification par D5. Marquez l'état de réponse « non – voir D4 » dans la carte. Un travail récurrent (chaque nuit, chaque lundi) a un brief et un plan permanents : D1 et D2 sont les paramètres que l'utilisateur révise une fois et peut voir avant chaque exécution. Sur un tel tableau, vous pouvez ordonner les cartes par temps (avant, pendant qu'il travaille, quand il rend compte) au lieu des cinq moments, si cela se lit mieux ; gardez les numéros d'état.
Une action que le produit lui-même rejette pour une raison métier (solde insuffisant, date déjà prise) n'est aucun des quatre « non » concernant l'IA : montrez-la comme un écran de l'état 5, avec la raison du système et ce que l'utilisateur peut modifier.
Quatre choses traversent tous ces états et vont sur le tableau en tant que notes : interruption, mémoire, proactivité (l'IA parle la première) et coût (crédits, quotas, dépenses). Voir la fin de references/states.md.
Si vous ne pouvez en concevoir que cinq : Travail en cours, Ne sait pas, Cassé, Réponse partielle, et Besoin de mon feu vert quand il agit (Compte rendu quand il travaille sans surveillance). Ce sont ceux où la confiance se perd le plus vite.
Format de spécification
Un bloc par état, dans cet ordre. Les développeurs construisent à partir du déclencheur ; sans lui, l'état est un vœu.
### 9. Ne sait pas
- **Déclencheur :** la récupération ne renvoie aucun passage au-dessus du seuil. (à confirmer : la valeur du seuil)
- **Affiche :** la bulle de réponse, style neutre (pas le style d'erreur).
- **Texte :** « Je n'ai pas trouvé d'informations sur les congés pour déménagement dans les politiques RH. »
- **Actions :** Reformuler · Voir les politiques · Demander aux RH
- **Conserve :** la question, modifiable.
- **Va vers :** 2 Composition, ou 14 Transféré à un humain.
- **Test :** « Y a-t-il un congé pour déménagement ? »
- **Mesure :** `answer_not_found` avec la requête ; surveillez le taux par sujet.
- **Question ouverte :** le système peut-il distinguer « pas de documents » de « les documents existent mais l'utilisateur n'y a pas accès » ?
Traduisez les étiquettes (Déclencheur, Affiche, Texte…) lorsque l'équipe travaille dans une autre langue : Déclencheur, Affiche, Texte, Actions, Conserve, Va vers, Test, Mesure, Question ouverte.
Conserve est tout ce que l'utilisateur perdrait : texte tapé, pièces jointes, la sélection, le résultat précédent, le travail qu'un agent avait déjà fait.
Langue et registre
Écrivez dans la langue que l'utilisateur demande ; s'il ne le dit pas, utilisez la langue de sa demande et du produit. Le registre est le choix du produit, pas une valeur par défaut : découvrez comment le produit s'exprime déjà (vous, tu ; formel ou chaleureux) et gardez-le dans chaque état. L'état d'erreur est celui où les équipes dérapent vers une autre voix – un « Une erreur s'est produite » formel à l'intérieur d'un produit qui dit « C'est fait ! » partout ailleurs donne l'impression d'une autre entreprise.
Deux langues peuvent être en jeu. Les textes – tout ce qui est à l'intérieur des écrans dessinés – sont dans la langue et le registre du produit. Le tableau et la spécification autour – noms d'état, titres, les étiquettes de la spécification, vos notes – sont dans la langue dans laquelle l'équipe travaille, qui est la langue dans laquelle l'utilisateur vous a écrit. Ne laissez pas les titres anglais du modèle sur un tableau pour une équipe francophone. Les exemples dans les fichiers de référence sont en français formel et en anglais ; ils montrent le motif, donc réécrivez-les dans le registre du produit plutôt que de les copier.
La voix de l'IA elle-même : si le produit fait parler l'IA à la première personne, gardez le « je » pour ce qu'elle a fait (« Je n'ai pas trouvé… », « J'ai utilisé les trois fichiers »), pas pour des sentiments qu'elle n'a pas (« J'adorerais vous aider »). Si la fonctionnalité n'a pas de persona – un bouton, un panneau – écrivez avec la voix impersonnelle du produit (« Impossible de lire le fichier »).
Ce que produire
board.html– le tableau autonome, prêt à ouvrir dans un navigateur.board.png– une capture d'écran de ce tableau (exécutezpython scripts/screenshot.py board.html board.png).- Cahier des charges – une spécification d'états marquée (les mêmes informations que la carte, mais triées par état et prêtes pour les développeurs).
- Script de test – une entrée pour chaque état, avec le comportement attendu.
- Métriques – ce qu'il faut journaliser par état.
- Liste d'hypothèses – ce que vous avez supposé et ce qui nécessite une réponse.
Fichiers de référence
| Fichier | Contenu | Quand lire |
|---|---|---|
references/states.md | Les 14 états de réponse – chaque état avec son motif, anti-motif et besoins de copie | Toujours |
references/delegation.md | Les 12 états de délégation pour les agents | Agents seulement |
references/surfaces.md | Types de surface : chat, bouton, panneau, résumé, recherche | Toujours |
references/copy.md | Règles pour la copie IA : honnête, concise, non anthropomorphique | Toujours |
references/measure.md | Télémétrie et métriques par état | Quand vous rédigez le script de test |
references/failure-modes.md | Modes de défaillance : halucination, omission, jailbreak | Révision |
references/anti-patterns.md | Anti-motifs : trop de confirmations, sur-promesse, ambiguïté | Révision |
references/checklist.md | Liste de contrôle : tous les états, signaux, enjeux, copie | Révision |
assets/template.html | Modèle de tableau de bord avec une carte de démonstration, barre de couverture et bloc de résultats | Toujours (point de départ) |
Travailler avec des runs non interactifs
Si vous ne pouvez pas poser de questions, définissez des hypothèses par défaut : supposant une surface de chat, enjeux moyens, aucun signal personnalisé sauf ce qui est standard (streaming, confiance, un détecteur d'erreur). Pour chaque état, ajoutez « à confirmer » aux déclencheurs qui dépendent de signaux que vous ne pouvez pas confirmer. Listez toutes les hypothèses dans la livraison. Si vous avez déjà un cahier des charges pour la fonctionnalité, travaillez avec les surfaces qu'il définit.