Cuando Claude responde preguntas basándose en documentos que proporcionas, los usuarios podrían asumir que simplemente está extrayendo información de sus datos de entrenamiento. Pero ¿qué pasa si Claude realmente está citando fuentes específicas? La función de citas te permite mostrar a los usuarios exactamente dónde encontró Claude su información, construyendo confianza y transparencia en tus aplicaciones de IA.
Por qué importan las citas
Sin citas, los usuarios ven las respuestas de Claude como si provinieran de la memoria. No tienen forma de verificar la información ni de entender que se basa en documentos específicos que proporcionaste. Las citas resuelven esto mostrando a los usuarios el material fuente exacto que Claude usó para generar cada parte de su respuesta.
Habilitar citas
Para habilitar las citas, agrega dos campos a tu mensaje 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 que aparece en las citas. El campo citations con enabled: True le indica a Claude que rastree dónde encuentra la información.
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 contenido estructurado con información de citas:
Cada cita contiene:
- cited_text - El texto exacto que Claude está referenciando de tu documento
- document_index - Qué documento (si proporcionaste varios)
- 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
Construcción de interfaces de citas
El verdadero poder de las citas proviene de construir interfaces de usuario que las muestren. Puedes crear referencias numeradas en el texto que enlacen a información detallada de las citas:
Cuando los usuarios pasan el cursor sobre o hacen clic en los números de cita, ven exactamente qué documento y páginas referenció Claude. Esta transparencia ayuda a los usuarios a verificar la información y genera confianza en las respuestas de Claude.
Citas con texto plano
Las citas no se limitan a PDFs. También puedes usarlas con documentos de texto plano:
{
"type": "document",
"source": {
"type": "text",
"media_type": "text/plain",
"data": article_text,
},
"title": "earth article",
"citations": { "enabled": True }
}Con texto plano, obtienes objetos CitationCharLocation en lugar de ubicaciones de página. Estos proporcionan posiciones de caracteres dentro del texto, lo que permite resaltar las oraciones o párrafos exactos que Claude referenció.
Cuándo usar citas
Las citas son esenciales cuando:
- Los usuarios necesitan verificar la precisión de la información
- Estás trabajando con documentos sensibles o importantes
- La transparencia sobre las fuentes genera confianza en tu aplicación
- Los usuarios podrían querer leer el material fuente original
Al implementar citas, transformas a Claude de una "caja negra" que da respuestas en un sistema transparente que muestra su trabajo, haciendo que tus aplicaciones de IA sean más confiables y verificables.