Chargement
Chargement

Lorsque vous avez besoin que Claude génère des données structurées comme du JSON, du code Python ou des listes à puces, vous rencontrez souvent un problème courant : Claude veut être utile et ajoute du texte explicatif, des en-têtes ou une mise en forme markdown autour de votre contenu. Ces commentaires supplémentaires nuisent à l'expérience utilisateur lorsque vous avez seulement besoin des données brutes.

Application de génération de règles EventBridge : saisie « Rule to monitor EC2 instances », un bouton Generate, et un JSON propre avec un bouton de copie.

Imaginez que vous construisez une application web qui génère des règles AWS EventBridge. Les utilisateurs saisissent une description, cliquent sur generate, et s'attendent à voir un JSON propre qu'ils peuvent immédiatement copier et utiliser. Si Claude renvoie le JSON enveloppé dans des blocs de code markdown accompagnés de texte explicatif, les utilisateurs ne peuvent pas simplement copier l'ensemble de la réponse : ils doivent sélectionner manuellement uniquement la partie JSON.

Le problème des réponses par défaut

Par défaut, Claude a tendance à formater la sortie structurée de cette manière :

markdown
# EventBridge Rule
```json
{
  "source": ["aws.ec2"],
  "detail-type": ["EC2 Instance State-change Notification"],
  "detail": {"state": ["running"]}
}
```
This rule captures EC2 instance state changes when instances start running or stop.

Bien que cela soit excellent pour la documentation, cela pose problème lorsque vous avez besoin uniquement du JSON pour un usage programmatique.

La solution : préremplissage du message de l'assistant + séquences d'arrêt

Vous pouvez combiner le préremplissage du message de l'assistant avec des séquences d'arrêt pour obtenir exactement le contenu souhaité. Voici comment cela fonctionne :

python
messages = []
add_user_message(messages, "Generate a very short event bridge rule as json")
add_assistant_message(messages, "```json")

text = chat(messages, stop_sequences=["```"])

Cette technique fonctionne de la manière suivante :

  • Préremplir le message de l'assistant avec le délimiteur markdown d'ouverture
  • Définir une séquence d'arrêt pour interrompre la génération lorsque Claude tente de fermer le bloc de code
  • Ne capturer que le contenu situé entre ces délimiteurs

Une séquence d'arrêt et un message d'assistant prérempli qui ouvre un bloc json amènent Claude à n'écrire que le JSON, sans description.

Fonctionnement en coulisses

Lorsque Claude reçoit votre requête, il voit le message de l'assistant prérempli et suppose qu'il a déjà commencé à écrire le bloc de code JSON. Au lieu d'ajouter son propre en-tête et son délimiteur d'ouverture, Claude passe directement à la génération du contenu JSON proprement dit.

Lorsque Claude a terminé le JSON et souhaite naturellement fermer le bloc de code markdown avec ```, la séquence d'arrêt interrompt immédiatement la génération et renvoie la réponse. Vous obtenez uniquement le contenu JSON, sans mise en forme superflue.

Traitement des résultats

Le texte renvoyé peut contenir quelques caractères de retour à la ligne, mais vous pouvez facilement les nettoyer :

python
import json

# Analyser en tant que JSON pour valider et formater
parsed_data = json.loads(text.strip())

# Ou simplement supprimer les espaces pour les autres types de données
clean_text = text.strip()

Au-delà du JSON

Cette technique ne se limite pas à la génération de JSON. Vous pouvez l'utiliser pour tout type de données structurées où vous souhaitez obtenir uniquement le contenu, sans la tendance naturelle de Claude à ajouter du texte explicatif :

  • Extraits de code Python
  • Listes à puces
  • Données CSV
  • Fichiers de configuration
  • Tout format où une sortie propre et copiable est importante

L'essentiel est d'identifier quels délimiteurs Claude utiliserait naturellement autour de votre type de contenu, puis de préremplir le délimiteur d'ouverture et de s'arrêter au délimiteur de fermeture. Cela vous donne un contrôle précis sur le format de sortie tout en tirant parti des réflexes naturels de formatage de Claude.