Chargement

Structurer avec des balises XML

Leçon 197 min
Chargement

Lorsque vous créez des requêtes qui incluent beaucoup de contenu, Claude peut parfois avoir du mal à comprendre quels éléments de texte vont ensemble ou ce que les différentes sections sont censées représenter. Les balises XML offrent un moyen simple d'ajouter de la structure et de la clarté à vos requêtes, en particulier lorsque vous interpolez de grandes quantités de données.

Pourquoi la structure est importante

Imaginez une requête où vous devez analyser 20 pages de relevés de ventes. Sans limites claires, Claude peut avoir du mal à distinguer vos instructions des données réelles que vous souhaitez faire analyser.

Une requête sans balises XML : elle demande un rapport de décision, interpole sales_records, puis énumère cinq étapes numérotées.

L'exemple ci-dessus montre à quel point des limites peu claires peuvent rendre difficile pour Claude de comprendre votre intention. En enveloppant différentes sections de contenu dans des balises XML, vous créez des délimiteurs clairs qui aident Claude à comprendre la structure de votre requête.

Utiliser les balises XML pour plus de clarté

Les balises XML agissent comme des conteneurs qui séparent des portions distinctes de votre requête. Vous pouvez créer des noms de balises personnalisés qui décrivent le contenu qu'elles contiennent :

Requête pour un rapport de décision d'une page sur une baisse de ventes de 30 %, avec les relevés dans des balises sales_records et cinq étapes d'analyse.

Dans ce cas, envelopper les données de ventes dans des balises <sales_records> rend immédiatement évident ce que représente ce contenu. Le nom de la balise lui-même fournit un contexte sur le type de données.

Un exemple pratique

Voici un exemple plus marquant qui montre pourquoi la structure est importante. À gauche, vous avez une demande de débogage avec du code et de la documentation mélangés :

La même requête de débogage deux fois : « Pas terrible » avec du code et de la documentation mêlés, et « Mieux » avec des balises my_code et docs.

Sans limites claires, Claude doit deviner quelles parties sont le code bogué et lesquelles sont la documentation. La version améliorée à droite utilise des balises XML pour séparer ces éléments :

<my_code>
from datavortex import Pipeline, DataSource

def process_data(input_file, output_file):
    pipeline = Pipeline()
    source = DataSource.from_csv(input_file)
</my_code>

<docs>
# Creating a data source from data vortex
csv_source = DataSource.from_csv("data.csv")
</docs>

Maintenant, Claude peut facilement identifier ce qui doit être débogué par rapport à ce qui sert de matériel de référence.

Appliquer la structure à vos requêtes

Même lorsque votre contenu interpolé n'est pas massif, les balises XML peuvent tout de même améliorer la clarté. Par exemple, lorsque vous générez des plans de repas, vous pourriez regrouper les informations sur l'athlète :

<athlete_information>
- Height: {prompt_inputs["height"]}
- Weight: {prompt_inputs["weight"]}
- Goal: {prompt_inputs["goal"]}
- Dietary restrictions: {prompt_inputs["restrictions"]}
</athlete_information>

Cela rend explicite que ces valeurs représentent une entrée externe concernant l'athlète, plutôt qu'une partie de vos instructions.

Avantages clés

  • Particulièrement utile lorsque vous incluez de grandes quantités de contexte ou de données
  • Servent de délimiteurs clairs permettant à Claude d'interpréter différents types de contenu
  • Améliorent la capacité de Claude à comprendre la relation entre les différentes parties de votre requête
  • Rendent vos requêtes plus maintenables et plus faciles à déboguer

Les balises XML sont particulièrement précieuses lorsque vous travaillez avec des requêtes complexes qui mélangent instructions, données, exemples et autres types de contenu. Plus vous pouvez rendre la structure claire, mieux Claude peut comprendre et répondre à vos besoins spécifiques.