Cargando

Estructura con etiquetas XML

Lección 199 min
Cargando

Cuando construyes indicaciones que incluyen mucho contenido, Claude a veces puede tener dificultades para entender qué fragmentos de texto van juntos o qué representan las diferentes secciones. Las etiquetas XML ofrecen una forma sencilla de añadir estructura y claridad a tus indicaciones, especialmente cuando estás interpolando grandes cantidades de datos.

Por qué importa la estructura

Considera una indicación en la que necesitas analizar 20 páginas de registros de ventas. Sin límites claros, Claude podría tener problemas para distinguir entre tus instrucciones y los datos reales que quieres que analice.

Una indicación sin etiquetas XML: pide un informe de decisión, interpola sales_records y luego enumera cinco pasos numerados.

El ejemplo anterior muestra cómo unos límites poco claros pueden dificultar que Claude interprete tu intención. Al envolver los registros de ventas en etiquetas XML, creas una separación clara entre las diferentes partes de tu indicación.

Usar etiquetas XML para mayor claridad

Las etiquetas XML actúan como delimitadores que ayudan a Claude a entender la estructura de tu indicación. Puedes crear nombres de etiquetas personalizados que describan el contenido que contienen:

<sales_records>
{sales_records}
</sales_records>

Los nombres de las etiquetas no necesitan seguir ninguna especificación oficial de XML: eres libre de crear nombres descriptivos como sales_records, data o records. Los nombres más específicos generalmente funcionan mejor que los genéricos.

Un ejemplo práctico

Aquí tienes un ejemplo claro de por qué las etiquetas XML marcan la diferencia. En la versión "No tan buena", no está claro qué contenido representa el código con errores frente a la documentación:

La misma indicación de depuración dos veces: "No tan buena" con el código y la documentación mezclados, y "Mejor" con etiquetas my_code y docs.

La versión mejorada usa etiquetas XML para separar claramente los diferentes tipos de contenido:

<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>

Ahora Claude puede distinguir fácilmente entre el código que necesita depuración y la documentación que debería guiar el proceso de depuración.

Aplicar estructura a tus indicaciones

Incluso cuando el contenido interpolado no es masivo, las etiquetas XML pueden seguir mejorando la claridad. Por ejemplo, al generar planes de comidas, puedes agrupar la información del atleta en un solo bloque:

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

Esto deja muy claro para Claude que este bloque contiene información externa sobre el atleta que debería orientar la generación del plan de comidas.

Cuándo usar etiquetas XML

Las etiquetas XML son más útiles cuando:

  • Estás incluyendo grandes cantidades de contexto o datos
  • Tu indicación contiene varios tipos distintos de contenido
  • Quieres que los límites entre las diferentes secciones sean evidentes
  • Estás interpolando contenido que podría confundirse con tus instrucciones

Aunque es posible que no veas mejoras drásticas con indicaciones sencillas, las etiquetas XML funcionan como delimitadores que ayudan a Claude a comprender mejor tu intención, lo que conduce a respuestas más consistentes y precisas.