Cargando
Cargando

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 función potente 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 pieza de información.

Por qué importan las citas

Imagina que le preguntas a Claude cómo se formó la atmósfera de la Tierra y obtienes una respuesta detallada. Sin citas, los usuarios no tienen forma de verificar la información ni de entender que Claude está en realidad haciendo referencia a un documento específico que proporcionaste. Las citas resuelven este problema de transparencia al crear un rastro claro desde la respuesta de Claude hasta tu material fuente.

El documento fuente earth.pdf, página 1 de 4, mostrando el artículo de Wikipedia sobre la Tierra, abierto sobre el código del notebook.

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:

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 legible, mientras que citations: {"enabled": True} le indica a Claude que rastree dónde encuentra la información.

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

Valores de ejemplo de una cita: una oración cited_text sobre la atmósfera de la Tierra, document_index 0, title earth.pdf, páginas 4 a 5.

Cada cita contiene varias piezas 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

Valores de ejemplo para los campos de cita anteriores: una oración sobre actividad volcánica, document index 0, earth.pdf, páginas 4 a 5.

Construir interfaces de usuario con citas

El verdadero poder de las citas proviene de construir 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 provino la información.

Una página de texto sobre cómo se formaron la atmósfera y los océanos de la Tierra, con marcadores de citas azules numerados del 1 al 7 después de las afirmaciones.

Esto crea una experiencia transparente donde 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 pieza de información citada

Citas con texto plano

Las citas no están limitadas a documentos PDF. También puedes usarlas con fuentes de texto plano. Al trabajar con texto, modifica tu estructura de documento de esta manera:

python
{
    "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 pieza de información.

Cuándo usar las citas

Las citas son particularmente valiosas cuando:

  • Los usuarios necesitan verificar la información para comprobar su exactitud
  • Estás trabajando con documentos autorizados que los usuarios deberían poder consultar
  • La transparencia sobre las fuentes de información es crítica para tu aplicación
  • Los usuarios podrían querer explorar el contexto más amplio alrededor de datos específicos

Al implementar las 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.