Article

Écrire pour les humains et les agents : un seul texte, plus facile à comprendre

Expliquer une idée, situer un chiffre, rendre les sources accessibles : comment écrire un texte agréable à lire et plus facile à reprendre sans le déformer.

Un article peut être lu du début à la fin, parcouru en diagonale ou repris par un assistant qui n’en reçoit que quelques passages. Pour rester clair dans ces trois situations, privilégiez une explication suivie, puis vérifiez que ses résultats importants gardent leur sens quand ils sont cités seuls. Rendre un résultat compréhensible hors de son paragraphe ne demande pas de transformer toutes les sections en fiches indépendantes. Un même brouillon fictif, sur le coût d’un agent, sert d’exemple de son ouverture à sa relecture.

Commencer par le problème que le lecteur reconnaît

Imaginons un article sur le coût des agents IA. Le lecteur veut savoir pourquoi une tâche simple peut coûter cher et ce qu’il peut changer. Une introduction qui définit cinq termes avant de poser ce problème lui demande un effort sans lui en montrer l’intérêt. Le brouillon part donc de la situation : « Votre agent reçoit la même documentation à chaque appel. Vous voulez réduire le coût de cette répétition sans lui retirer les informations nécessaires à sa tâche. »

Ce début donne une question à l’explication. Le lecteur n’a pas encore besoin de connaître tous les mécanismes de facturation ni toutes les façons de fournir des outils à un agent. Il lui faut d’abord comprendre ce qui est répété, puis ce que les solutions changent. L’exemple de cet article est fictif : il sert à travailler la rédaction, sans annoncer une économie réellement mesurée.

Montrer le mécanisme avant de donner le conseil

Un brouillon pourrait se contenter de « Réduisez le contexte pour réduire le coût ». Le contexte désigne ici les informations transmises au modèle pour un appel. Dans l’exemple, il contient la description des outils, les fonctions que l’agent peut demander au programme d’exécuter, comme lire un fichier ou lancer une recherche. C’est cette documentation qui revient à chaque appel. Mais la phrase ne permet pas de décider quoi retirer : les descriptions d’outils, la question de l’utilisateur et les documents utiles sont tous du texte, sans avoir le même rôle.

Le paragraphe peut développer un choix précis. Ici, la tâche demande de lire un document ; l’agent reçoit aussi la documentation d’outils sans rapport avec cette lecture. Le logiciel pourrait sélectionner les descriptions utiles à la tâche avant l’appel. La quantité transmise serait alors plus faible. Si la sélection retire un outil nécessaire, elle peut toutefois compromettre le travail ou provoquer des tentatives supplémentaires. Le conseil devient une hypothèse à tester sur le travail complet, avec sa condition de validité.

Cette limite arrive après le mécanisme qu’elle borne. Placée avant l’explication de la sélection, elle demanderait au lecteur de retenir la limite d’un mécanisme qu’il ne connaît pas encore. Une idée, un exemple et une limite forment ici une progression utile ; évitez d’en faire un moule imposé à chaque paragraphe. Une liste convient pour énumérer les options à tester, tandis que la prose explique pourquoi chacun est nécessaire.

Donner au résultat les précisions nécessaires pour être repris

Si le risque de retirer une information nécessaire paraît trop grand, le brouillon peut garder la documentation et examiner un cache. Dans le mécanisme documenté par Anthropic, la documentation reste envoyée à chaque appel. Si un début de requête strictement identique est encore en cache, le fournisseur réutilise son traitement. Le gain éventuel porte sur le coût du traitement répété, sans supprimer les informations de la requête. Pour mesurer cet effet, il faut un essai distinct. Supposons, uniquement pour l’exemple, que cet essai ait produit la phrase : « Cela réduit le coût de 30 %. »

Isolée, cette phrase ne dit ni ce qui a changé, ni quel coût a baissé, ni par rapport à quoi. Réécrite, elle pourrait devenir : « Dans cet essai de 100 requêtes, la mise en cache a réduit de 30 % le coût des jetons d’entrée, par rapport aux mêmes requêtes sans cache. » Les jetons sont les unités de contenu traitées par le modèle ; les jetons d’entrée correspondent ici au contenu qu’il reçoit. Les chiffres de 100 requêtes et de 30 % restent fictifs. Une mesure réelle devrait aussi donner la date, le modèle, les tarifs utilisés et le protocole permettant de comparer les deux conditions.

Le résultat ainsi formulé ne promet pas que toute facture baissera de 30 %. Il porte sur un poste de coût et sur un essai défini. Le lecteur qui le rencontre dans un extrait peut donc comprendre sa portée ; celui qui lit l’article entier retrouve le détail dans le passage qui décrit l’essai. La précision aide à vérifier l’affirmation, mais ne prouve pas qu’elle est vraie : vérifier la source et vérifier la formulation restent deux travaux distincts. Une opinion peut aussi être ferme, à condition d’être présentée comme un jugement et d’expliquer sur quoi elle repose.

Cet effort est à réserver aux définitions, résultats et recommandations importants. Une phrase de transition peut parfaitement dépendre de celle qui précède. Les pronoms et les rappels évitent de répéter tout le dossier ; leur suppression systématique rendrait la lecture plus lourde sans rendre chaque extrait pertinent.

Placer l’idée assez tôt sans promettre une citation

Dans l’article fictif, annoncer le problème de répétition dès le début aide à comprendre le rôle de l’exemple. Une fois la comparaison construite, une phrase peut en donner le résultat avec ses conditions. Ce sont deux gestes différents : orienter le lecteur avant l’explication, puis formuler ce que l’explication permet de conclure. Chaque section n’a pas besoin de répéter sa conclusion à ses deux extrémités.

Les travaux Lost in the Middle et Context Rot étudient l’exploitation des informations dans des contextes longs par des modèles. Ils donnent des raisons de tester l’ordre et la quantité des informations transmises à un modèle. Ils ne démontrent pas qu’une phrase placée en tête de section sera davantage citée sur le web. Cette orientation se justifie par la compréhension du lecteur ; elle ne garantit ni l’indexation ni la citation par un produit particulier.

Garder le même résultat dans les différentes versions

La précaution s’applique aussi au résumé que le site propose aux lecteurs ou aux logiciels. Si le résumé de l’article fictif annonce « 30 % d’économie sur les agents IA », il transforme un résultat fictif et limité en promesse générale. Il doit conserver le statut de l’exemple, ou ne pas en reprendre le chiffre. Dans un article rapportant un essai réel, il garderait le poste mesuré et les conditions nécessaires, avec un accès au détail.

Un résumé, un flux ou une représentation structurée peuvent présenter l’information autrement sans en changer la portée. Le lecteur qui suit une citation doit retrouver sur la page de référence ce qui lui a été annoncé. La même exigence s’applique à l’accès d’un agent à une API, une interface par laquelle un logiciel demande des données : une autre présentation ne justifie pas une autre affirmation.

Les règles de Google nomment cloaking le fait de présenter des contenus différents aux moteurs et aux utilisateurs dans l’intention de manipuler le classement et de tromper ces derniers. Toute différence de format ne constitue donc pas, en elle-même, du cloaking. La fidélité des représentations sert ici le lecteur, indépendamment de cette règle de référencement.

Relire le parcours, puis les passages importants

La première relecture suit l’article entier. Pour le brouillon sur les coûts, elle doit permettre d’expliquer la répétition documentaire, la sélection, le cache et les limites du résultat sans aller chercher ailleurs les prérequis. La seconde isole les résultats importants : le passage sur les 30 % conserve-t-il son statut fictif, son poste de coût et sa comparaison ? Le résumé les respecte-t-il également ?

Ces deux lectures ne se remplacent pas. Une suite de phrases précises peut manquer de raisonnement ; un raisonnement agréable peut contenir une mesure invérifiable. Le terme slop, employé notamment par l’American Dialect Society pour des contenus de faible qualité produits en grande quantité, le plus souvent par l’IA générative, ne fournit pas un critère de relecture suffisant. Qu’un brouillon soit humain ou automatique, le critère reste ce qu’il permet de comprendre et de vérifier.

L’article sur les coûts peut ainsi conserver une progression pour le lecteur qui découvre le sujet et des résultats précisément formulés pour celui qui arrive par un extrait. Le parcours explique le choix ; le passage repris garde les conditions du résultat.

Sources

Explorer

Sur le même sujet

Choisis dans l’index d’après les étiquettes de cet article — les plus proches d’abord, hors de sa série. Rien n’est écrit à la main : un article publié demain avec les mêmes étiquettes y prendra place.

Laisser un commentaire

Elle n'est jamais affichée ni publiée. Elle sert à regrouper vos commentaires et, si vous vous inscrivez un jour avec elle, à vous les rendre.

Votre commentaire sera relu avant d'être publié.