Cuando Claude responde preguntas basándose en documentos que proporcionas, los usuarios podrían asumir que simplemente está recurriendo a sus datos de entrenamiento. Pero, ¿qué pasaría si Claude pudiera mostrar exactamente dónde encontró información específica? Ahí es donde entran las citas: una potente función que permite a Claude hacer referencia a partes específicas de tus documentos fuente y mostrar a los usuarios exactamente de dónde proviene cada fragmento de información.
Por qué importan las citas
Imagina preguntarle a Claude cómo se formó la atmósfera de la Tierra y obtener una respuesta detallada. Sin citas, los usuarios no tienen forma de verificar la información ni de entender que Claude en realidad está haciendo referencia a un documento específico que tú proporcionaste. Las citas resuelven este problema de transparencia al crear un rastro claro desde la respuesta de Claude hasta tu material fuente.
Habilitar las citas
Para habilitar las citas, necesitas modificar la estructura de tu mensaje de documento. Agrega dos nuevos campos a tu bloque de documento:
{
"type": "document",
"source": {
"type": "base64",
"media_type": "application/pdf",
"data": file_bytes,
},
"title": "earth.pdf",
"citations": { "enabled": True }
}El campo title le da a tu documento un nombre legible, mientras que citations: {"enabled": True} le indica a Claude que rastree dónde encuentra la información.
Comprender la estructura de las citas
Cuando las citas están habilitadas, la respuesta de Claude se vuelve más compleja. En lugar de texto simple, obtienes datos estructurados que incluyen información de citas para cada afirmación.
Cada cita contiene varios elementos clave de información:
- cited_text - El texto exacto de tu documento que respalda la afirmación de Claude
- document_index - A qué documento hace referencia Claude (útil cuando proporcionas varios documentos)
- document_title - El título que asignaste al documento
- start_page_number - Dónde comienza el texto citado
- end_page_number - Dónde termina el texto citado
Crear interfaces de usuario con citas
El verdadero poder de las citas proviene de crear interfaces de usuario que hagan accesible esta información. Puedes crear elementos interactivos donde los usuarios pueden pasar el cursor sobre los marcadores de citas para ver exactamente de dónde proviene la información.
Esto crea una experiencia transparente en la que los usuarios pueden:
- Ver que las respuestas de Claude están fundamentadas en material fuente real
- Verificar la información consultando el documento original
- Comprender el contexto alrededor de cada fragmento de información citado
Citas con texto plano
Las citas no se limitan a documentos PDF. También puedes usarlas con fuentes de texto plano. Cuando trabajes con texto, modifica la estructura de tu documento de esta manera:
{
"type": "document",
"source": {
"type": "text",
"media_type": "text/plain",
"data": article_text,
},
"title": "earth_article",
"citations": { "enabled": True }
}Con fuentes de texto plano, en lugar de números de página, obtendrás posiciones de caracteres que señalan exactamente dónde en el texto Claude encontró cada fragmento de información.
Cuándo usar citas
Las citas son particularmente valiosas cuando:
- Los usuarios necesitan verificar la información para asegurar su precisión
- Estás trabajando con documentos autorizados a los que los usuarios deberían poder hacer referencia
- La transparencia sobre las fuentes de información es fundamental para tu aplicación
- Los usuarios podrían querer explorar el contexto más amplio alrededor de hechos específicos
Al implementar citas, transformas a Claude de una "caja negra" que proporciona respuestas en un asistente de investigación transparente que muestra su trabajo. Esto genera confianza en los usuarios y les permite profundizar en tus materiales fuente cuando sea necesario.