Cargando
Cargando

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 en realidad está citando fuentes específicas? La función de citas te permite mostrar a los usuarios exactamente dónde encontró Claude su información, generando confianza y transparencia en tus aplicaciones de IA.

Por qué importan las citas

Sin citas, los usuarios ven las respuestas de Claude como si vinieran 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 al mostrar a los usuarios el material de origen exacto que Claude usó para generar cada parte de su respuesta.

Habilitar las citas

Para habilitar las citas, agrega dos campos a tu mensaje de documento:

python
{
  "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 registre 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:

Valores de ejemplo para los cinco campos de citas que se muestran a continuación: una oración de texto citado, índice 0, "earth.pdf", páginas 4 y 5.

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

Creación de interfaces de citas

El verdadero poder de las citas proviene de crear interfaces de usuario que las muestren. Puedes crear referencias numeradas en el texto que enlacen a información detallada de las citas:

Artefacto de Claude sobre cómo se formó la atmósfera terrestre, con referencias numeradas del 1 al 7 y una oración citada resaltada.

Cuando los usuarios pasan el cursor sobre los números de cita o hacen clic en ellos, 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 están limitadas a PDFs. También puedes usarlas con documentos de texto plano:

python
{
  "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 te permite resaltar las oraciones o párrafos exactos que Claude referenció.

Cuándo usar las 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 de origen 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.