Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Citazioni e fonti automatiche

Lezione 6 di 16 Aggiornata il 30 luglio 2026 Sviluppatore
In questa pagina
  1. Tracciabilità delle informazioni
  2. Come funzionano le citazioni
  3. Utilizzo delle citazioni nella tua applicazione
  4. Casi d’uso per le citazioni
  5. Combinazione di citazioni e filtraggio per dominio
  6. Limitazioni da conoscere
  7. Punti chiave

Tracciabilità delle informazioni

Uno dei vantaggi principali della Ricerca Web rispetto alla semplice generazione di testo è la tracciabilità. Quando il modello utilizza informazioni provenienti da una ricerca sul web, l’API restituisce automaticamente le citazioni con gli URL delle fonti consultate. Questo ti permette di verificare le informazioni e presentarle con i relativi riferimenti nella tua applicazione.

Come funzionano le citazioni

L’API genera le citazioni automaticamente, senza che tu debba configurare nulla. Una volta attivata la Ricerca Web e quando il modello utilizza i risultati della ricerca nella sua risposta, le fonti vengono incluse nell’oggetto di risposta.

Puoi accedere alle citazioni tramite il campo citations nella risposta. Ogni citazione contiene l’URL della fonte e il contesto in cui è stata utilizzata.

Utilizzo delle citazioni nella tua applicazione

Visualizzazione delle fonti

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What are the latest advancements in quantum computing?",
    tools=[{"type": "web_search"}]
)

# Display the response
print(response.output_text)

# Display the citations
if hasattr(response, 'citations') and response.citations:
    print("\nSources:")
    for citation in response.citations:
        print(f"  - {citation.url}")

Integrazione delle fonti in un’interfaccia utente

In un’applicazione web, puoi trasformare le citazioni in link cliccabili. Questo rafforza la credibilità della tua applicazione e consente all’utente finale di verificare le informazioni.

def format_response_with_sources(response):
    output = response.output_text

    if hasattr(response, 'citations') and response.citations:
        output += "\n\n---\n**Sources:**\n"
        for i, citation in enumerate(response.citations, 1):
            output += f"{i}. [{citation.url}]({citation.url})\n"

    return output

Casi d’uso per le citazioni

Chatbot aziendali

Per un assistente AI costruito per i tuoi clienti, le citazioni aggiungono trasparenza. L’utente può verificare che le informazioni provengano da una fonte affidabile, il che costruisce fiducia nelle risposte.

Applicazioni di monitoraggio

In uno strumento di monitoraggio automatizzato, le citazioni sono essenziali per tracciare l’origine delle informazioni. Ti permettono di collegare ogni insight alla sua fonte e facilitano analisi approfondite.

Generazione di report

Se utilizzi l’API per generare report automatizzati, le citazioni fungono da bibliografia. Documentano le fonti utilizzate e aggiungono rigore al report.

Combinazione di citazioni e filtraggio per dominio

Combinando allowed_domains con le citazioni, ottieni un sistema di ricerca controllato e tracciabile:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Current state of AI regulation in Europe",
    tools=[{
        "type": "web_search",
        "allowed_domains": [
            "ec.europa.eu",
            "eur-lex.europa.eu",
            "legifrance.gouv.fr"
        ]
    }]
)

Le citazioni confermeranno che le informazioni provengono esclusivamente da fonti autorizzate.

Limitazioni da conoscere

  • Le citazioni non sono sempre presenti: se il modello risponde senza utilizzare risultati di ricerca, non viene generata alcuna citazione
  • Il formato esatto delle citazioni può variare a seconda dell’SDK utilizzato
  • Le citazioni fanno riferimento alle pagine consultate, non necessariamente ai passaggi esatti utilizzati
  • Il numero di citazioni dipende dal numero di fonti che il modello ha effettivamente utilizzato

Punti chiave

  • Le citazioni sono automatiche: nessuna configurazione richiesta
  • Sono accessibili tramite il campo citations nella risposta
  • Le citazioni apportano tracciabilità e credibilità alla tua applicazione
  • Si combinano con il filtraggio per dominio per un controllo totale
  • Integrarle nella tua interfaccia per consentire la verifica delle fonti