Citas en Claude API: cómo llegar al pasaje que respalda una respuesta

Imagen destacada: ilustración editorial generada con IA; la escena es conceptual, no una captura de Claude ni una prueba de uso.

Una respuesta puede mostrar una cita y, aun así, necesitar comprobación. El valor de la cita está en permitir que quien lee vuelva al documento y contraste el pasaje con la afirmación. No certifica que el documento sea fiable ni que la conclusión esté bien razonada.

Esta guía se refiere a la función de citas de la Messages API de Claude: una aplicación envía documentos junto con la pregunta y recibe bloques de respuesta con localizadores. No describe una función universal de todas las herramientas de inteligencia artificial ni una opción de la interfaz de claude.ai. Anthropic explica el flujo en su documentación oficial de citas.

Qué añade la función de citas

Cuando se habilitan las citas en los documentos de una solicitud, la respuesta puede venir dividida en varios bloques de texto. Un bloque que contiene una afirmación puede incluir una lista de referencias al documento y al lugar del que procede el pasaje. La aplicación puede presentar esa referencia al lector y permitirle revisar el origen.

Esto es más estructurado que pedirle al modelo, mediante una instrucción, que escriba una referencia textual por su cuenta: la API devuelve campos de ubicación y el fragmento citado. La documentación de Anthropic describe la función como una forma de fundamentar respuestas en documentos proporcionados. La palabra «fundamentar» no debe confundirse con certificar la verdad: la cita apunta a una fuente recibida por la solicitud; la evaluación de su calidad y de lo que realmente demuestra sigue correspondiendo a la aplicación y a quien la revisa.

Cómo habilitar citas en un documento

La documentación admite documentos PDF, texto plano y contenido personalizado. Se pueden incluir en la solicitud o referenciar mediante file_id tras cargarlos en la API de Archivos. La opción se establece en cada bloque de documento:

{
  "type": "document",
  "source": {
    "type": "text",
    "media_type": "text/plain",
    "data": "Texto del documento que se quiere consultar."
  },
  "title": "Manual de ejemplo, revisión 3",
  "citations": { "enabled": true }
}

El título identifica el documento en la respuesta, pero la documentación indica que el contenido citable está en source; los campos title y context no se citan como pasaje. Si una petición contiene varios documentos, Anthropic exige que las citas estén habilitadas en todos o en ninguno. La documentación presenta esa opción como una regla de todo o nada.

Los documentos de texto plano y PDF se dividen automáticamente en oraciones para definir la granularidad mínima de cita. En contenido personalizado no se aplica otra fragmentación: los límites de los bloques que envía la aplicación determinan qué fragmento se podrá referenciar. Por eso, en listas, transcripciones o fragmentos recuperados por un sistema RAG, conviene decidir explícitamente qué unidad debe poder señalarse. La guía de citas de Anthropic detalla estos tipos y su formato.

Cómo leer el localizador de una cita

La respuesta no siempre usa la misma unidad. Primero mira el campo type; después interpreta los índices que le corresponden. En todos los casos, document_index identifica el documento dentro de la lista de documentos de la solicitud y empieza en cero.

Un ejemplo de cita de texto plano puede tener esta forma. Los valores de la muestra son ilustrativos; no representan una respuesta real:

{
  "type": "char_location",
  "document_index": 0,
  "document_title": "Documento de ejemplo",
  "cited_text": "[pasaje citado]",
  "start_char_index": 10,
  "end_char_index": 34
}

En el ejemplo, el intervalo empieza en el carácter 10 y termina antes del 34. No uses el índice final como si señalara un carácter incluido. Para un PDF, el equivalente es un rango de páginas; para contenido personalizado, un rango de bloques. La API también devuelve cited_text, que ayuda a encontrar el pasaje, pero la referencia más segura es abrir el mismo documento y revisar el contexto completo.

Comprobación práctica: del bloque de respuesta al documento

1. Conserva el orden de entrada. Guarda la relación entre cada índice de documento y el archivo que enviaste. document_index se cuenta desde cero en la lista de todos los bloques de documento de la solicitud, incluso si aparecen en mensajes distintos: el primer bloque documental es 0, el siguiente 1.
2. Lee el tipo y el rango. Distingue entre caracteres, páginas y bloques antes de intentar abrir una ubicación. Un índice de caracteres no es un número de página.
3. Abre la versión exacta. Comprueba el archivo o texto que se envió a esa solicitud, no otra edición con título parecido. Si el documento cambió, el localizador puede referirse al contenido anterior.
4. Contrasta el pasaje, no solo la etiqueta. Verifica que el fragmento citado existe y que respalda la afirmación concreta del bloque de texto. Revisa también las frases anteriores y posteriores: una cita literal puede ser auténtica y, aun así, no justificar una conclusión más amplia.
5. Separa la atribución de la conclusión. Si Claude infiere algo a partir de varias frases, la aplicación debe dejar claro que la conclusión es una síntesis. La presencia de referencias no sustituye una revisión humana o una regla de validación del producto.

Una interfaz útil conserva juntas la afirmación y sus citas, presenta el título del documento y ofrece una forma de abrir el original. Si la respuesta se transmite por streaming, la documentación indica que las citas llegan en eventos citations_delta; el cliente debe incorporarlas al bloque de texto correspondiente en vez de esperar que aparezcan como una cadena final independiente.

Texto, PDF y resultados de búsqueda: no son lo mismo

En texto plano, Anthropic muestra localizadores de caracteres con índices desde cero. En PDF, las citas de texto apuntan a páginas, numeradas desde uno. En contenido personalizado, las referencias apuntan a los bloques que entregó la aplicación. Si quieres que un fragmento recuperado por RAG sea citable como unidad propia, puedes enviarlo como documento de texto o diseñar bloques personalizados; la elección cambia la granularidad y el tipo de localizador.

Los resultados de búsqueda son una estructura relacionada, pero distinta. En una aplicación RAG, la aplicación puede proporcionar bloques search_result con una fuente o URL, un título y contenido de texto, y habilitar las citas para atribuir el resultado. Anthropic documenta que estos bloques pueden proceder de herramientas de búsqueda propias o entregarse directamente en el mensaje. En una misma solicitud, todos los resultados deben compartir la misma configuración de citas. Consulta la documentación de resultados de búsqueda para Claude antes de diseñar esa parte del flujo.

Esto no convierte la función de citas de documentos en búsqueda web automática. La recuperación, selección de fuentes y construcción de los bloques siguen siendo responsabilidad de la aplicación. Si estás preparando respuestas en JSON, ten en cuenta que las citas y las salidas estructuradas con output_config.format son incompatibles y la API devuelve un error 400. Para separar ambos conceptos, puedes leer nuestra guía de respuestas de IA en JSON y contrastarla con la documentación de salidas estructuradas de Anthropic.

Límites que conviene explicar al usuario

• Una referencia válida no demuestra que el contenido sea verdadero. Solo permite localizar material de los documentos proporcionados; la aplicación debe comprobar que el origen sea fiable y que el pasaje respalde la respuesta.
• Las citas son de texto. Anthropic indica que todavía no se pueden citar imágenes. Su soporte de PDF puede procesar elementos visuales, pero el mecanismo de citas descrito no devuelve una ubicación citable para una imagen o gráfico. Los PDF escaneados sin texto extraíble no se pueden citar con esta función. Revisa por separado cualquier dato que dependa de un gráfico.
• El formato personalizado no se fragmenta automáticamente. Si cada bloque mezcla varias ideas, la referencia resultará menos precisa. Diseña los bloques con una unidad que se pueda revisar.
• Las citas no fuerzan un JSON con esquema. Si se habilitan citas en documentos o resultados de búsqueda junto con output_config.format, la API responde con error 400. Es una incompatibilidad documentada, no un problema de sintaxis del JSON generado.
• La respuesta puede intercalar texto y referencias. No supongas que todo el contenido de content es un único bloque. Si tu aplicación procesa la salida, recorre sus bloques y conserva cada lista de citas junto a la afirmación correspondiente.

Antes de mostrar una respuesta, una comprobación mínima consiste en confirmar el documento, abrir el pasaje, cotejar el contexto, registrar qué afirmación respalda y señalar explícitamente cualquier salto inferencial. Para una aplicación que procesa cientos de documentos, guarda además la versión o identificador del origen y conserva la relación con el índice de documento de esa solicitud.

Lista rápida para revisar una respuesta citada

• ¿La cita está habilitada en todos los documentos de la solicitud?
• ¿El índice de documento lleva al archivo correcto?
• ¿El tipo de localizador coincide con PDF, texto plano o contenido personalizado?
• ¿El fragmento aparece en la versión original que recibió la API?
• ¿El contexto respalda la afirmación completa, no solo una frase aislada?
• ¿La respuesta distingue una cita textual de una inferencia?
• ¿El usuario puede abrir la fuente y entender por qué se enlaza?

La función facilita la trazabilidad; la calidad de la respuesta depende también de la calidad del documento, de la recuperación y de las comprobaciones de la aplicación. Si el lector no puede abrir el mismo original y cotejar el pasaje, una referencia técnica aporta menos valor del que aparenta.

Fuentes y agradecimientos

Esta guía se apoya en la documentación de citas de Claude, los bloques de resultados de búsqueda, la página de compatibilidad con PDF y la referencia de salidas estructuradas de Anthropic, consultadas el 30 de octubre de 2026. Gracias a Anthropic por publicar estos detalles técnicos y ejemplos que permiten explicar cómo interpretar las referencias y dónde están sus límites. Esta mención reconoce la documentación consultada; no implica colaboración ni aval.