Claude ya no necesita inventarse la cita: así se activa Citations para que señale la frase exacta de tu documento

El problema que resuelve no es que Claude mienta, sino que cita de memoria

Cuando se le pide a Claude que responda una pregunta basándose en un documento y que cite la fuente, la forma más habitual de conseguirlo es un prompt del tipo «responde citando textualmente la frase del documento en la que te basas». Funciona razonablemente bien, pero tiene dos problemas prácticos: cada cita literal que Claude reproduce cuenta como tokens de salida, lo que encarece la respuesta cuanto más se cita, y no hay ninguna garantía técnica de que esa cita corresponda de verdad, palabra por palabra, al documento original, más allá de la fiabilidad general del modelo. La función Citations de la API de Claude ataca ambos problemas desde la raíz: en lugar de confiar en que el modelo reproduzca el texto de memoria, la propia API localiza y devuelve la cita como un dato estructurado y verificado, apuntando exactamente al fragmento del documento de origen.

Cómo funciona el mecanismo por dentro

El proceso, según la documentación oficial de Anthropic, tiene tres pasos. Primero, se incluyen uno o varios documentos en la solicitud —en PDF, texto plano o un formato de contenido personalizado— y se activa la marca citations.enabled en true para cada uno de ellos; esto es todo o nada, no se puede activar solo en algunos documentos de una misma solicitud. Segundo, el contenido de cada documento se divide en fragmentos citables: en un documento de texto plano o un PDF, esa división se hace automáticamente por frases, de modo que Claude puede citar una sola frase o encadenar varias frases consecutivas para citar un párrafo entero, pero nunca una fracción de frase más pequeña. Tercero, la respuesta final llega acompañada de datos estructurados para cada cita, indicando de qué documento y de qué parte exacta procede, sin que ese texto citado cuente como tokens de salida facturables.

Un ejemplo real, y el control fino que casi nadie usa

Un caso de uso habitual, documentado por el propio Anthropic, es un bot de atención al cliente que responde preguntas apoyándose en artículos de un centro de ayuda: ante una pregunta como «acabo de hacer el pedido, ¿dónde está mi número de seguimiento?», Claude puede responder señalando exactamente qué frase del artículo de ayuda correspondiente explica el plazo habitual de generación del número de seguimiento, en lugar de inventar una respuesta plausible sin respaldo verificable en el documento. Ese ejemplo usa la opción por defecto de fragmentación por frases, pero hay una segunda vía —documentos de contenido personalizado— que da control total sobre la granularidad de la cita: en lugar de dejar que el sistema trocee el texto frase a frase, se puede definir cada fragmento citable de antemano, por ejemplo tratando cada artículo completo del centro de ayuda como un único bloque citable. La diferencia práctica es notable: con fragmentación automática, una cita señala una frase concreta dentro de un artículo; con contenido personalizado, la cita puede señalar el artículo entero como unidad, lo que resulta más útil cuando lo que importa no es la frase exacta sino saber de qué documento completo procede la respuesta.

Incompatibilidades y límites que conviene conocer antes de integrarla

Citations no se lleva bien con todo. Es incompatible con Structured Outputs: como la función necesita intercalar bloques de cita con el texto de la respuesta, entra en conflicto directo con las restricciones de una salida JSON estricta, y combinar ambas devuelve un error. Por ahora, solo soporta citas de texto: no es posible citar una imagen o un gráfico dentro de un PDF, aunque sí es posible enviar el PDF completo para que Claude razone sobre su contenido visual. Casi todos los modelos activos de Claude soportan esta función, con la excepción de Haiku 3, que se ha quedado fuera de esta capacidad por ser una versión más antigua. Un matiz que conviene aclarar frente a la creencia de que citar automáticamente elimina cualquier riesgo de error: la función garantiza que la cita apunta a un lugar real del documento proporcionado, pero no garantiza que la interpretación que Claude hace de esa cita, o la conclusión que construye a partir de ella, sea necesariamente correcta; sigue siendo responsabilidad de quien revisa la respuesta comprobar que el razonamiento alrededor de la cita tiene sentido, no solo que la cita en sí exista.

Por qué importa hoy

Para cualquier aplicación que responda preguntas apoyándose en documentos propios —un bot de soporte, un asistente legal, una herramienta de análisis de contratos o informes—, sustituir el prompt manual de «cita textualmente» por la función Citations reduce el coste de las respuestas con cita literal y da una garantía técnica de que esa cita corresponde de verdad al documento de origen, en lugar de depender únicamente de la fiabilidad general del modelo. El primer paso práctico para probarla es tomar un flujo ya existente que pida citas mediante prompt, activar citations.enabled en los documentos que ya se están enviando, y comparar directamente la fiabilidad y el coste de las citas antes y después del cambio.

Merece la pena añadir un matiz sobre cuándo NO conviene usar Citations, porque no siempre es la opción correcta frente a un prompt manual bien diseñado. Si la aplicación necesita que la respuesta llegue como un objeto JSON estricto para procesarla automáticamente, Citations queda descartada de entrada por su incompatibilidad con Structured Outputs, y en ese caso la alternativa razonable es pedir a Claude, dentro del propio esquema JSON, un campo de tipo texto donde describa con sus propias palabras en qué parte del documento se basa, aceptando que esa referencia no tendrá la misma garantía técnica de exactitud que ofrece la función nativa. Del mismo modo, para documentos con contenido mayoritariamente visual —gráficos, tablas complejas, diagramas—, donde lo relevante no es una frase de texto sino una imagen concreta, Citations no puede señalar esa parte visual como fuente, así que conviene combinarla con una descripción textual del elemento visual relevante si la cita necesita cubrir también ese tipo de contenido.