Claude Platform Docs
  • Messaggi
  • Agenti gestiti
  • Amministrazione

Search...
⌘K
Primi passi
Introduzione a ClaudeGuida rapida
Sviluppare con Claude
Panoramica delle funzionalitàUtilizzo dell'API MessagesMotivi di interruzione e fallbackRifiuti e fallbackCredito di fallback
Capacità del modello
Pensiero estesoPensiero adattivoEffortBudget delle attività (beta)Modalità veloce (anteprima di ricerca)Output strutturatiCitazioniStreaming dei messaggiElaborazione batchRisultati di ricercaStreaming dei rifiutiSupporto multilingueEmbedding
Strumenti
PanoramicaCome funziona l'uso degli strumentiTutorial: Creare un agente che usa strumentiDefinire gli strumentiGestire le chiamate agli strumentiUso degli strumenti in paralleloTool Runner (SDK)Uso degli strumenti rigorosoStrumenti serverStrumento di ricerca webStrumento di recupero webStrumento di esecuzione codiceStrumento advisorStrumento di ricerca strumentiStrumento di memoriaStrumento BashStrumento editor di testoStrumento di uso del computerRisoluzione dei problemi
Infrastruttura degli strumenti
Riferimento strumentiGestire il contesto degli strumentiCombinazioni di strumentiUso degli strumenti con cache dei promptChiamata programmatica degli strumentiStreaming granulare degli strumenti
Gestione del contesto
Finestre di contestoCompattazioneModifica del contestoCache dei promptMessaggi di sistema a metà conversazioneCreare una modalità di orchestrazioneDiagnostica della cache (beta)Conteggio dei token
Lavorare con i file
API FilesSupporto PDF
Skill
PanoramicaGuida rapidaBest practiceSkill per le aziendeSkill nell'API
MCP
Server MCP remotiConnettore MCP
Claude su piattaforme cloud
Amazon BedrockAmazon Bedrock (legacy)Claude Platform su AWSGoogle CloudMicrosoft Foundry

Log in
Citazioni
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Claude Platform Docs

Solutions

  • AI agents
  • Code modernization
  • Coding
  • Customer support
  • Education
  • Financial services
  • Government
  • Life sciences

Partners

  • Claude on AWS
  • Claude on Google Cloud

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Company

  • Anthropic
  • Careers
  • Economic Futures
  • Research
  • News
  • Responsible Scaling Policy
  • Security and compliance
  • Transparency

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Help and security

  • Availability
  • Status
  • Support
  • Discord

Terms and policies

  • Privacy policy
  • Responsible disclosure policy
  • Terms of service: Commercial
  • Terms of service: Consumer
  • Usage policy
Messaggi/Capacità del modello

Citazioni

Ancora le risposte di Claude ai tuoi documenti sorgente. Le citazioni restituiscono i passaggi esatti che supportano ogni affermazione, così puoi verificare le risposte e mostrare le fonti ai tuoi utenti.


Questa funzionalità è idonea per la Zero Data Retention (ZDR). Quando la tua organizzazione dispone di un accordo ZDR, i dati inviati tramite questa funzionalità non vengono conservati dopo che la risposta dell'API è stata restituita.

Claude può fornire citazioni dettagliate quando risponde a domande sui documenti, aiutandoti a tracciare e verificare le fonti alla base di ogni risposta.

Tutti i modelli attivi supportano le citazioni, ad eccezione di Claude Haiku 3.



Condividi il tuo feedback e i tuoi suggerimenti sulla funzionalità delle citazioni utilizzando il modulo di feedback sulle citazioni.

L'esempio seguente mostra come abilitare le citazioni su un documento di testo semplice con la Messages API:

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-8",
    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?"},
            ],
        }
    ],
)
print(response)


Confronto con gli approcci basati su prompt

Rispetto al chiedere a Claude tramite prompt di citare le fonti, la funzionalità delle citazioni offre i seguenti vantaggi:

  • Risparmio sui costi: Se il tuo approccio basato su prompt chiede a Claude di produrre citazioni dirette, potresti notare un risparmio sui costi perché cited_text non viene conteggiato nei tuoi token di output.
  • Migliore affidabilità delle citazioni: Poiché l'API analizza le citazioni nei formati di risposta descritti nelle sezioni seguenti ed estrae cited_text direttamente, è garantito che le citazioni contengano puntatori validi ai documenti forniti.
  • Migliore qualità delle citazioni: Nelle valutazioni di Anthropic, la funzionalità delle citazioni ha una probabilità significativamente maggiore di citare i passaggi più rilevanti dai documenti rispetto agli approcci puramente basati su prompt.

Come funzionano le citazioni

Integra le citazioni con Claude seguendo questi passaggi:

  1. 1

    Fornisci i documenti e abilita le citazioni

    • Includi i documenti in uno qualsiasi dei formati supportati: PDF, testo semplice o documenti con contenuto personalizzato.
    • Imposta citations.enabled=true su ciascuno dei tuoi documenti. Attualmente, le citazioni devono essere abilitate su tutti o su nessuno dei documenti all'interno di una richiesta.
    • Al momento sono supportate solo le citazioni di testo. Le citazioni di immagini non sono ancora possibili.
  2. 2

    I documenti vengono elaborati

    • I contenuti dei documenti vengono suddivisi in "chunk" (segmenti) per definire la granularità minima delle possibili citazioni. Ad esempio, la suddivisione in frasi consente a Claude di citare una singola frase o concatenare più frasi consecutive per citare un paragrafo o un passaggio più lungo.
      • Per i PDF: Il testo viene estratto come descritto in Supporto PDF e il contenuto viene suddiviso in frasi. La citazione di immagini dai PDF non è attualmente supportata.
      • Per i documenti di testo semplice: Il contenuto viene suddiviso in frasi che possono essere citate.
      • Per i documenti con contenuto personalizzato: I blocchi di contenuto che fornisci vengono utilizzati così come sono e non viene eseguita alcuna ulteriore suddivisione.
  3. 3

    Claude fornisce una risposta con citazioni

    • Le risposte possono ora includere più blocchi di testo in cui ogni blocco di testo può contenere un'affermazione fatta da Claude e un elenco di citazioni che supportano tale affermazione.
    • Le citazioni fanno riferimento a posizioni specifiche nei documenti sorgente. Il formato di queste citazioni dipende dal tipo di documento da cui si sta citando.
      • Per i PDF: Le citazioni includono l'intervallo di numeri di pagina (indicizzato a partire da 1).
      • Per i documenti di testo semplice: Le citazioni includono l'intervallo di indici di carattere (indicizzato a partire da 0).
      • Per i documenti con contenuto personalizzato: Le citazioni includono l'intervallo di indici dei blocchi di contenuto (indicizzato a partire da 0) corrispondente all'elenco di contenuti originale fornito.
    • Gli indici dei documenti vengono forniti per indicare la fonte di riferimento e sono indicizzati a partire da 0 in base all'elenco di tutti i documenti nella tua richiesta originale.


Suddivisione automatica vs contenuto personalizzato

Per impostazione predefinita, i documenti di testo semplice e PDF vengono automaticamente suddivisi in frasi. Se hai bisogno di maggiore controllo sulla granularità delle citazioni (ad esempio, per elenchi puntati o trascrizioni), usa invece i documenti con contenuto personalizzato. Consulta Tipi di documento per maggiori dettagli.

Ad esempio, se vuoi che Claude sia in grado di citare frasi specifiche dai tuoi chunk RAG, dovresti inserire ogni chunk RAG in un documento di testo semplice. Altrimenti, se non vuoi che venga eseguita alcuna ulteriore suddivisione, o se vuoi personalizzare qualsiasi suddivisione aggiuntiva, puoi inserire i chunk RAG in documenti con contenuto personalizzato.

Contenuto citabile vs non citabile

  • Il testo presente all'interno del contenuto source di un documento può essere citato.
  • title e context sono campi opzionali che vengono passati al modello ma non utilizzati per il contenuto citato.
  • title ha una lunghezza limitata, quindi il campo context è utile per memorizzare i metadati del documento come testo o JSON serializzato in stringa.

Indici delle citazioni

  • Gli indici dei documenti sono indicizzati a partire da 0 dall'elenco di tutti i blocchi di contenuto di tipo documento nella richiesta (attraverso tutti i messaggi).
  • Gli indici di carattere sono indicizzati a partire da 0 con indici finali esclusivi.
  • I numeri di pagina sono indicizzati a partire da 1 con numeri di pagina finali esclusivi.
  • Gli indici dei blocchi di contenuto sono indicizzati a partire da 0 con indici finali esclusivi dall'elenco content fornito nel documento con contenuto personalizzato.

Costi in token

  • L'abilitazione delle citazioni comporta un leggero aumento dei token di input a causa delle aggiunte al prompt di sistema e della suddivisione dei documenti.
  • Tuttavia, la funzionalità delle citazioni è molto efficiente con i token di output. Internamente, il modello produce le citazioni in un formato standardizzato che viene poi analizzato in testo citato e indici di posizione nel documento. Il campo cited_text viene fornito per comodità e non viene conteggiato nei token di output.
  • Quando viene ripassato nei turni di conversazione successivi, cited_text non viene conteggiato nemmeno nei token di input.

Compatibilità con altre funzionalità

Le citazioni funzionano in combinazione con altre funzionalità dell'API, tra cui la cache dei prompt, il conteggio dei token e l'elaborazione batch.



Le citazioni e gli output strutturati sono incompatibili

Le citazioni non possono essere utilizzate insieme agli output strutturati. Se abiliti le citazioni su qualsiasi documento fornito dall'utente (blocchi document o blocchi search_result) e includi anche il parametro output_config.format (o il parametro deprecato output_format), l'API restituisce un errore 400.

Questo perché le citazioni richiedono l'intercalazione di blocchi di citazione con l'output di testo, il che è incompatibile con i rigidi vincoli dello schema JSON degli output strutturati.

Utilizzo della cache dei prompt con le citazioni

Le citazioni e la cache dei prompt possono essere utilizzate insieme in modo efficace.

I blocchi di citazione generati nelle risposte non possono essere memorizzati direttamente nella cache, ma i documenti sorgente a cui fanno riferimento possono esserlo. Per ottimizzare le prestazioni, applica cache_control ai tuoi blocchi di contenuto di tipo documento di livello superiore.

client = anthropic.Anthropic()

# Contenuto di un documento lungo (ad esempio, documentazione tecnica)
long_document = (
    "This is a very long document with thousands of words..." + " ... " * 1000
)  # Minimum cacheable length

response = client.messages.create(
    model="claude-opus-4-8",
    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"
                    },  # Cache the document content
                },
                {
                    "type": "text",
                    "text": "What does this document say about API features?",
                },
            ],
        }
    ],
)
print(response)

In questo esempio:

  • Il contenuto del documento viene memorizzato nella cache utilizzando cache_control sul blocco del documento.
  • Le citazioni sono abilitate sul documento.
  • Claude può generare risposte con citazioni beneficiando al contempo del contenuto del documento memorizzato nella cache.
  • Le richieste successive che utilizzano lo stesso documento beneficiano del contenuto memorizzato nella cache.

Tipi di documento

Scelta del tipo di documento

Sono supportati tre tipi di documento per le citazioni. I documenti possono essere forniti direttamente nel messaggio (base64, testo o URL) oppure caricati tramite la Files API e referenziati tramite file_id:

TipoIdeale perSuddivisioneFormato della citazione
Testo sempliceDocumenti di testo semplici, prosaFraseIndici di carattere (indicizzati a partire da 0)
PDFFile PDF con contenuto testualeFraseNumeri di pagina (indicizzati a partire da 1)
Contenuto personalizzatoElenchi, trascrizioni, formattazione speciale, citazioni più granulariNessuna suddivisione aggiuntivaIndici di blocco (indicizzati a partire da 0)


I file .csv, .xlsx, .docx, .md e .txt non sono supportati come blocchi di documento. Converti questi file in testo semplice e includili direttamente nel contenuto del messaggio. Consulta Lavorare con altri formati di file.

Documenti di testo semplice

I documenti di testo semplice vengono automaticamente suddivisi in frasi. Puoi fornirli inline o tramite riferimento con il loro file_id:

Documenti PDF

I documenti PDF possono essere forniti come dati codificati in base64, un URL o tramite file_id. Il testo del PDF viene estratto e suddiviso in frasi. Poiché le citazioni di immagini non sono ancora supportate, i PDF che sono scansioni di documenti e non contengono testo estraibile non saranno citabili.

Documenti con contenuto personalizzato

I documenti con contenuto personalizzato ti danno il controllo sulla granularità delle citazioni. Non viene eseguita alcuna suddivisione aggiuntiva e i chunk vengono forniti al modello in base ai blocchi di contenuto forniti.

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "document",
                    "source": {
                        "type": "content",
                        "content": [
                            {"type": "text", "text": "First chunk"},
                            {"type": "text", "text": "Second chunk"},
                        ],
                    },
                    "title": "Document Title",
                    "context": "Context about the document that will not be cited from",
                    "citations": {"enabled": True},
                },
                {"type": "text", "text": "Summarize this document."},
            ],
        }
    ],
)
print(response)


Struttura della risposta

Quando le citazioni sono abilitate, le risposte includono più blocchi di testo con citazioni:

{
    "content": [
        {"type": "text", "text": "According to the document, "},
        {
            "type": "text",
            "text": "the grass is green",
            "citations": [
                {
                    "type": "char_location",
                    "cited_text": "The grass is green.",
                    "document_index": 0,
                    "document_title": "Example Document",
                    "start_char_index": 0,
                    "end_char_index": 20,
                }
            ],
        },
        {"type": "text", "text": " and "},
        {
            "type": "text",
            "text": "the sky is blue",
            "citations": [
                {
                    "type": "char_location",
                    "cited_text": "The sky is blue.",
                    "document_index": 0,
                    "document_title": "Example Document",
                    "start_char_index": 20,
                    "end_char_index": 36,
                }
            ],
        },
        {
            "type": "text",
            "text": ". Information from page 5 states that ",
        },
        {
            "type": "text",
            "text": "water is essential",
            "citations": [
                {
                    "type": "page_location",
                    "cited_text": "Water is essential for life.",
                    "document_index": 1,
                    "document_title": "PDF Document",
                    "start_page_number": 5,
                    "end_page_number": 6,
                }
            ],
        },
        {
            "type": "text",
            "text": ". The custom document mentions ",
        },
        {
            "type": "text",
            "text": "important findings",
            "citations": [
                {
                    "type": "content_block_location",
                    "cited_text": "These are important findings.",
                    "document_index": 2,
                    "document_title": "Custom Content Document",
                    "start_block_index": 0,
                    "end_block_index": 1,
                }
            ],
        },
    ]
}

Supporto per lo streaming

Per le risposte in streaming, le citazioni arrivano come tipo di delta citations_delta all'interno degli eventi content_block_delta. Ogni delta contiene una singola citazione da aggiungere all'elenco citations sul blocco di contenuto text corrente.

Passaggi successivi

Messaggi in streaming

Gestisci il tipo di delta citations_delta insieme ai delta di testo per visualizzare le risposte citate mentre vengono trasmesse in streaming.

Risultati di ricerca

Passa i risultati di ricerca dalla tua pipeline RAG come blocchi di contenuto di prima classe con supporto integrato per le citazioni.


Supporto PDF

Scopri come Claude estrae il testo dai PDF e come le citazioni basate sulle pagine si ricollegano ai tuoi file sorgente.

Files API

Carica i documenti una sola volta e referenziali tramite file_id in più richieste di citazione.

Was this page helpful?

  • Come funzionano le citazioni
  • Contenuto citabile vs non citabile
  • Indici delle citazioni
  • Costi in token
  • Compatibilità con altre funzionalità
  • Tipi di documento
  • Scelta del tipo di documento
  • Documenti di testo semplice
  • Documenti PDF
  • Documenti con contenuto personalizzato
  • Struttura della risposta
  • Supporto per lo streaming
  • Passaggi successivi