Cargando

Datos estructurados

Lección 99 min
Cargando

Cuando necesitas que Claude genere datos estructurados como JSON, código Python o listas con viñetas, a menudo te encontrarás con un problema común: Claude quiere ser útil y añade texto explicativo alrededor de tu contenido. Si bien esto suele ser genial, a veces solo necesitas los datos sin procesar y nada más.

App generadora de reglas de EventBridge: entrada "Rule to monitor EC2 instances", un botón Generate y JSON limpio con un botón de copiar.

Imagina que estás construyendo una aplicación web que genera reglas de AWS EventBridge. Los usuarios introducen una descripción, hacen clic en generar, y esperan ver un JSON limpio que puedan copiar y usar de inmediato. Si Claude devuelve el JSON envuelto en bloques de código markdown con encabezados y pies de página explicativos, los usuarios no pueden simplemente pulsar "copiar todo"; tendrían que seleccionar manualmente solo la parte del JSON.

A Claude se le pide un perfil de usuario como JSON, una lista de tareas con viñetas y Python para análisis de datos, y devuelve solo eso.

Este patrón aparece siempre que generas datos estructurados. Claude naturalmente quiere explicar su trabajo, pero en muchos casos, solo quieres el contenido que estás pidiendo y nada más.

A Claude se le pide un perfil de usuario como JSON, una lista de tareas con viñetas y Python para análisis de datos, y devuelve solo eso.

Combinar secuencias de parada con el prellenado de mensajes del asistente

La solución combina dos técnicas que ya hemos visto: las secuencias de parada y el prellenado de mensajes del asistente. Así es como funciona en la práctica:

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=["```"])

Cuando ejecutas este código, obtienes de vuelta solo el contenido JSON, sin formato markdown ni comentarios adicionales.

Cómo funciona detrás de escena

Una secuencia de parada y un mensaje de asistente prellenado que abre un bloque json hacen que Claude escriba solo el JSON, no una descripción.

Esto es lo que sucede cuando Claude procesa tu solicitud:

  1. Claude lee tu mensaje de usuario y piensa "necesito escribir una regla completa y probablemente describirla"
  2. Ve el mensaje de asistente prellenado y asume que ya comenzó a escribir el bloque de markdown del JSON
  3. Claude piensa "ah, ya he empezado la parte del JSON, así que solo necesito escribir el contenido JSON real"
  4. Genera el contenido JSON
  5. Cuando Claude intenta cerrar el bloque de markdown con ```, alcanza la secuencia de parada y la generación se detiene de inmediato

El resultado es que obtienes todo lo que hay entre el inicio prellenado y la secuencia de parada, exactamente el contenido que querías.

Limpiar la salida

El texto devuelto podría tener algunas líneas en blanco adicionales, pero puedes limpiarlo fácilmente:

python
import json

# Analizar como JSON para validar y formatear
parsed_json = json.loads(text.strip())

Esta técnica funciona para cualquier formato de datos estructurados, no solo JSON. Ya sea que estés generando código Python, listas con viñetas o cualquier otro formato de contenido específico, puedes usar el prellenado de mensajes del asistente para iniciar la respuesta y las secuencias de parada para terminarla exactamente donde quieres.

Este enfoque te da un control preciso sobre el formato de salida de Claude, asegurando que tus aplicaciones obtengan datos limpios y utilizables sin formato o comentarios adicionales que puedan interferir con el procesamiento posterior.