Claude es capaz de proporcionar citas detalladas al responder preguntas sobre documentos, ayudándote a rastrear y verificar las fuentes de información en las respuestas.

La función de citas está actualmente disponible en Claude Opus 4, Claude Sonnet 4, Claude Sonnet 3.7, Claude Sonnet 3.5 (nuevo) y Haiku 3.5.

Citas con Claude Sonnet 3.7

Claude Sonnet 3.7 puede ser menos propenso a hacer citas en comparación con otros modelos Claude sin instrucciones más explícitas del usuario. Al usar citas con Claude Sonnet 3.7, recomendamos incluir instrucciones adicionales en el turno del user, como "Usa citas para respaldar tu respuesta." por ejemplo.

También hemos observado que cuando se le pide al modelo que estructure su respuesta, es poco probable que use citas a menos que se le diga explícitamente que use citas dentro de ese formato. Por ejemplo, si se le pide al modelo que use etiquetas en su respuesta, deberías agregar algo como “Siempre usa citas en tu respuesta, incluso dentro de .”

Por favor comparte tus comentarios y sugerencias sobre la función de citas usando este formulario.

Aquí tienes un ejemplo de cómo usar citas con la API de Messages:

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "document",
            "source": {
              "type": "text",
              "media_type": "text/plain",
              "data": "The grass is green. The sky is blue."
            },
            "title": "My Document",
            "context": "This is a trustworthy document.",
            "citations": {"enabled": true}
          },
          {
            "type": "text",
            "text": "What color is the grass and sky?"
          }
        ]
      }
    ]
  }'

Comparación con enfoques basados en prompts

En comparación con las soluciones de citas basadas en prompts, la función de citas tiene las siguientes ventajas:

  • Ahorro de costos: Si tu enfoque basado en prompts le pide a Claude que produzca citas directas, puedes ver ahorros de costos debido al hecho de que cited_text no cuenta hacia tus tokens de salida.
  • Mejor confiabilidad de citas: Porque analizamos las citas en los formatos de respuesta respectivos mencionados anteriormente y extraemos cited_text, las citas están garantizadas de contener punteros válidos a los documentos proporcionados.
  • Calidad mejorada de citas: En nuestras evaluaciones, encontramos que la función de citas es significativamente más propensa a citar las citas más relevantes de los documentos en comparación con enfoques puramente basados en prompts.

​
Cómo funcionan las citas

Integra las citas con Claude en estos pasos:

1

Proporciona documento(s) y habilita las citas

  • Incluye documentos en cualquiera de los formatos soportados: PDFs, texto plano, o documentos de contenido personalizado
  • Establece citations.enabled=true en cada uno de tus documentos. Actualmente, las citas deben estar habilitadas en todos o ninguno de los documentos dentro de una solicitud.
  • Ten en cuenta que solo las citas de texto están actualmente soportadas y las citas de imágenes aún no son posibles.
2

Los documentos se procesan

  • Los contenidos de los documentos se “fragmentan” para definir la granularidad mínima de las posibles citas. Por ejemplo, la fragmentación por oraciones permitiría a Claude citar una sola oración o encadenar múltiples oraciones consecutivas para citar un párrafo (¡o más largo)!
    • Para PDFs: El texto se extrae como se describe en Soporte de PDF y el contenido se fragmenta en oraciones. Citar imágenes de PDFs no está actualmente soportado.
    • Para documentos de texto plano: El contenido se fragmenta en oraciones que pueden ser citadas.
    • Para documentos de contenido personalizado: Tus bloques de contenido proporcionados se usan tal como están y no se hace fragmentación adicional.
3

Claude proporciona respuesta citada

  • Las respuestas ahora pueden incluir múltiples bloques de texto donde cada bloque de texto puede contener una afirmación que Claude está haciendo y una lista de citas que respaldan la afirmación.
  • Las citas referencian ubicaciones específicas en los documentos fuente. El formato de estas citas depende del tipo de documento del que se está citando.
    • Para PDFs: las citas incluirán el rango de números de página (indexado desde 1).
    • Para documentos de texto plano: Las citas incluirán el rango de índices de caracteres (indexado desde 0).
    • Para documentos de contenido personalizado: Las citas incluirán el rango de índices de bloques de contenido (indexado desde 0) correspondiente a la lista de contenido original proporcionada.
  • Los índices de documentos se proporcionan para indicar la fuente de referencia y están indexados desde 0 según la lista de todos los documentos en tu solicitud original.

Fragmentación automática vs contenido personalizado

Por defecto, los documentos de texto plano y PDF se fragmentan automáticamente en oraciones. Si necesitas más control sobre la granularidad de las citas (por ejemplo, para viñetas o transcripciones), usa documentos de contenido personalizado en su lugar. Ve Tipos de Documentos para más detalles.

Por ejemplo, si quieres que Claude pueda citar oraciones específicas de tus fragmentos RAG, deberías poner cada fragmento RAG en un documento de texto plano. De lo contrario, si no quieres que se haga fragmentación adicional, o si quieres personalizar cualquier fragmentación adicional, puedes poner fragmentos RAG en documento(s) de contenido personalizado.

​
Contenido citable vs no citable

  • El texto encontrado dentro del contenido source de un documento puede ser citado.
  • title y context son campos opcionales que se pasarán al modelo pero no se usarán hacia el contenido citado.
  • title está limitado en longitud, por lo que puedes encontrar que el campo context es útil para almacenar cualquier metadato del documento como texto o json stringificado.

​
Índices de citas

  • Los índices de documentos están indexados desde 0 de la lista de todos los bloques de contenido de documentos en la solicitud (abarcando todos los mensajes).
  • Los índices de caracteres están indexados desde 0 con índices finales exclusivos.
  • Los números de página están indexados desde 1 con números de página finales exclusivos.
  • Los índices de bloques de contenido están indexados desde 0 con índices finales exclusivos de la lista content proporcionada en el documento de contenido personalizado.

​
Costos de tokens

  • Habilitar las citas incurre en un ligero aumento en los tokens de entrada debido a las adiciones del prompt del sistema y la fragmentación de documentos.
  • Sin embargo, la función de citas es muy eficiente con los tokens de salida. Bajo el capó, el modelo está produciendo citas en un formato estandarizado que luego se analizan en texto citado e índices de ubicación de documentos. El campo cited_text se proporciona por conveniencia y no cuenta hacia los tokens de salida.
  • Cuando se pasa de vuelta en turnos de conversación subsecuentes, cited_text tampoco se cuenta hacia los tokens de entrada.

​
Compatibilidad de funciones

Las citas funcionan en conjunto con otras funciones de la API incluyendo caché de prompts, conteo de tokens y procesamiento por lotes.

​
Usando Caché de Prompts con Citas

Las citas y el caché de prompts pueden usarse juntos efectivamente.

Los bloques de citas generados en las respuestas no pueden ser cacheados directamente, pero los documentos fuente que referencian sí pueden ser cacheados. Para optimizar el rendimiento, aplica cache_control a tus bloques de contenido de documentos de nivel superior.

import anthropic

client = anthropic.Anthropic()

# Contenido de documento largo (ej., documentación técnica)
long_document = "Este es un documento muy largo con miles de palabras..." + " ... " * 1000  # Longitud mínima cacheable

response = client.messages.create(
    model="claude-opus-4-20250514",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "document",
                    "source": {
                        "type": "text",
                        "media_type": "text/plain",
                        "data": long_document
                    },
                    "citations": {"enabled": True},
                    "cache_control": {"type": "ephemeral"}  # Cachear el contenido del documento
                },
                {
                    "type": "text",
                    "text": "¿Qué dice este documento sobre las funciones de la API?"
                }
            ]
        }
    ]
)

En este ejemplo:

  • El contenido del documento se cachea usando cache_control en el bloque del documento
  • Las citas están habilitadas en el documento
  • Claude puede generar respuestas con citas mientras se beneficia del contenido del documento cacheado
  • Las solicitudes subsecuentes usando el mismo documento se beneficiarán del contenido cacheado

​
Tipos de Documentos

​
Eligiendo un tipo de documento

Soportamos tres tipos de documentos para citas. Los documentos pueden proporcionarse directamente en el mensaje (base64, texto, o URL) o subirse a través de la API de Files y referenciarse por file_id:

TipoMejor paraFragmentaciónFormato de cita
Texto planoDocumentos de texto simples, prosaOraciónÍndices de caracteres (indexado desde 0)
PDFArchivos PDF con contenido de textoOraciónNúmeros de página (indexado desde 1)
Contenido personalizadoListas, transcripciones, formato especial, citas más granularesSin fragmentación adicionalÍndices de bloques (indexado desde 0)

Los archivos .csv, .xlsx, .docx, .md, y .txt no están soportados como bloques de documentos. Convierte estos a texto plano e incluye directamente en el contenido del mensaje. Ve Trabajando con otros formatos de archivo.

​
Documentos de texto plano

Los documentos de texto plano se fragmentan automáticamente en oraciones. Puedes proporcionarlos en línea o por referencia con su file_id:

{
    "type": "document",
    "source": {
        "type": "text",
        "media_type": "text/plain",
        "data": "Contenido de texto plano..."
    },
    "title": "Título del Documento", # opcional
    "context": "Contexto sobre el documento del que no se citará", # opcional
    "citations": {"enabled": True}
}

​
Documentos PDF

Los documentos PDF pueden proporcionarse como datos codificados en base64 o por file_id. El texto del PDF se extrae y se fragmenta en oraciones. Como las citas de imágenes aún no están soportadas, los PDFs que son escaneos de documentos y no contienen texto extraíble no serán citables.

{
    "type": "document",
    "source": {
        "type": "base64",
        "media_type": "application/pdf",
        "data": base64_encoded_pdf_data
    },
    "title": "Título del Documento", # opcional
    "context": "Contexto sobre el documento del que no se citará", # opcional
    "citations": {"enabled": True}
}

​
Documentos de contenido personalizado

Los documentos de contenido personalizado te dan control sobre la granularidad de las citas. No se hace fragmentación adicional y los fragmentos se proporcionan al modelo según los bloques de contenido proporcionados.

{
    "type": "document",
    "source": {
        "type": "content",
        "content": [
            {"type": "text", "text": "Primer fragmento"},
            {"type": "text", "text": "Segundo fragmento"}
        ]
    },
    "title": "Título del Documento", # opcional
    "context": "Contexto sobre el documento del que no se citará", # opcional
    "citations": {"enabled": True}
}

​
Estructura de Respuesta

Cuando las citas están habilitadas, las respuestas incluyen múltiples bloques de texto con citas:

{
    "content": [
        {
            "type": "text",
            "text": "Según el documento, "
        },
        {
            "type": "text",
            "text": "la hierba es verde",
            "citations": [{
                "type": "char_location",
                "cited_text": "La hierba es verde.",
                "document_index": 0,
                "document_title": "Documento de Ejemplo",
                "start_char_index": 0,
                "end_char_index": 20
            }]
        },
        {
            "type": "text",
            "text": " y "
        },
        {
            "type": "text",
            "text": "el cielo es azul",
            "citations": [{
                "type": "char_location",
                "cited_text": "El cielo es azul.",
                "document_index": 0,
                "document_title": "Documento de Ejemplo",
                "start_char_index": 20,
                "end_char_index": 36
            }]
        },
        {
            "type": "text",
            "text": ". La información de la página 5 establece que ",
        },
        {
            "type": "text",
            "text": "el agua es esencial",
            "citations": [{
                "type": "page_location",
                "cited_text": "El agua es esencial para la vida.",
                "document_index": 1,
                "document_title": "Documento PDF",
                "start_page_number": 5,
                "end_page_number": 6
            }]
        },
        {
            "type": "text",
            "text": ". El documento personalizado menciona ",
        },
        {
            "type": "text",
            "text": "hallazgos importantes",
            "citations": [{
                
                "type": "content_block_location",
                "cited_text": "Estos son hallazgos importantes.",
                "document_index": 2,
                "document_title": "Documento de Contenido Personalizado",
                "start_block_index": 0,
                "end_block_index": 1
            }]
        }
    ]
}

​
Soporte de Streaming

Para respuestas de streaming, hemos agregado un tipo citations_delta que contiene una sola cita para ser agregada a la lista citations en el bloque de contenido text actual.