Structurer avec les balises XML

Quand un prompt contient beaucoup de contenu, Claude peut avoir du mal à savoir quels morceaux de texte vont ensemble et à quoi sert chaque partie. Les balises XML règlent ce problème de frontières : elles délimitent les données, le code ou les documents insérés dans le prompt, et séparent clairement ce qui est à traiter de ce qui dit quoi en faire.

Un problème de frontières

Imaginez un prompt qui demande d’analyser vingt pages de relevés de ventes. Sans délimitation, rien ne distingue matériellement vos instructions des données à analyser. En entourant les relevés de <sales_records> et </sales_records>, vous tracez une frontière nette.

L’exemple le plus parlant du cours officiel est celui du débogage : demander à Claude de corriger un code à l’aide d’une documentation, en mélangeant les deux dans le même bloc, rend presque impossible de savoir ce qui est du code et ce qui est de la documentation. Avec <my_code> et <docs>, chaque contenu est à sa place.

Des noms de balises parlants

Il n’existe pas de balises « officielles » : inventez des noms qui décrivent le contenu. <sales_records> vaut mieux que <data> ; <athlete_information> dit clairement qu’il s’agit des données de l’athlète ; <my_code> et <docs> séparent deux natures de contenu. Plus le nom est précis, mieux Claude comprend le rôle de chaque section. Pas de schéma à déclarer : seule compte la paire ouvrante et fermante.

Quand les utiliser

• Pour insérer beaucoup de contexte ou de données.
• Pour mêler des contenus de natures différentes : code, documentation, données.
• Quand on veut être très explicite sur les limites d’un contenu.
• Dans les prompts complexes qui insèrent plusieurs variables.

Même pour un contenu court, une balise sert de délimiteur et rend la structure du prompt évidente.

Sur le fil rouge

<athlete_information>
- Taille : 188 cm
- Poids : 82 kg
- Objectif : prendre du muscle
- Restrictions alimentaires : végétarien
</athlete_information>

Génère un plan de repas à partir des informations de l'athlète ci-dessus.

Taille, poids, objectif et restrictions forment visiblement un tout, à considérer ensemble. Le cours officiel prévient : sur un prompt aussi court, le gain mesuré reste modeste ; les balises prennent toute leur valeur à mesure que le prompt grossit et mêle des contenus variés. La documentation ajoute un conseil d’ordre pour les documents longs : placez-les en tête du prompt, dans leurs balises, et la question ou la consigne à la fin.

Les balises servent aussi dans l’autre sens : demander la réponse entre balises (<plan>…</plan>) permet à votre code de récupérer exactement la partie utile. Pour un format exploitable par programme, les sorties structurées (leçon 9) restent la garantie la plus forte.

À vous de jouer

Baliser le fil rouge. Placez les entrées de l’athlète dans <athlete_information>, gardez la consigne claire et les six consignes de la leçon 18, et relancez l’évaluation. Le gain est-il mesurable sur votre jeu ?

Un prompt à contenus mêlés. Écrivez un prompt qui demande de corriger une fonction à partir d’un extrait de documentation, d’abord sans balises, puis avec <my_code> et <docs>. Lisez les deux réponses : laquelle confond le code et la documentation ?

Sources officielles : Structure with XML tags (Claude Academy) · Prompting best practices (documentation Claude : balises XML, ordre des documents longs)

Points clés à retenir

• Les balises XML tracent des frontières entre instructions, données, code et documents.
• Des noms descriptifs (<sales_records>, <athlete_information>) valent mieux que des noms génériques.
• Le gain grandit avec la taille et la variété du contenu ; il reste modeste sur un prompt court.
• Documents longs en tête, consigne à la fin ; réponse balisée pour l’extraire, sorties structurées pour la garantir.