Analizza le immagini trovate dalla ricerca web
In questa pagina
Vai oltre il testo con l’analisi delle immagini
La ricerca web non si limita al testo. Quando abiliti il parametro enable_image_understanding, il modello Grok può analizzare le immagini trovate durante le sue ricerche. Questo apre nuove possibilità: interpretare grafici, leggere infografiche, comprendere screenshot o analizzare foto di attualità.
Questa capacità è particolarmente utile per casi d’uso in cui le informazioni visive integrano o sostituiscono il testo, come l’analisi di tendenze da grafici azionari, la comprensione di diagrammi tecnici o l’estrazione di dati da tabelle pubblicate come immagini.
Abilita la comprensione delle immagini
Abiliti questa funzione tramite il parametro enable_image_understanding nella configurazione dello strumento web_search:
response = client.responses.create(
model="grok-4.5",
input="Show me the evolution of Tesla's stock price this week",
tools=[{
"type": "web_search",
"enable_image_understanding": True
}]
)
Quando questo parametro è attivo, il modello ha accesso a uno strumento interno aggiuntivo chiamato view_image. Può invocare questo strumento per esaminare le immagini incontrate durante la ricerca ed estrarre informazioni rilevanti.
Come funziona
Il processo si svolge in diverse fasi:
- Il modello esegue una ricerca web standard
- Tra i risultati, identifica le immagini potenzialmente rilevanti
- Utilizza lo strumento
view_imageper analizzare queste immagini - Integra le informazioni visive nella sua risposta finale
Non devi gestire alcuna interazione aggiuntiva. Il modello orchestra tutto in autonomia.
Combina filtraggio per dominio e analisi delle immagini
Puoi abilitare l’analisi delle immagini contemporaneamente al filtraggio per dominio:
response = client.responses.create(
model="grok-4.5",
input="Visual summary of the latest publications on arxiv in computer vision",
tools=[{
"type": "web_search",
"allowed_domains": ["arxiv.org"],
"enable_image_understanding": True
}]
)
| Parameter | Type | Default value | Description |
|---|---|---|---|
| allowed_domains | array | [] | Allowed domains (max 5) |
| excluded_domains | array | [] | Excluded domains (max 5) |
| enable_image_understanding | boolean | false | Enables analysis of found images |
Casi d’uso rilevanti
Monitoraggio visivo del brand
Monitora come il tuo brand appare visivamente online: loghi utilizzati, screenshot del tuo prodotto, infografiche che menzionano la tua azienda.
response = client.responses.create(
model="grok-4.5",
input="How is the Corsen AI brand represented visually online?",
tools=[{
"type": "web_search",
"enable_image_understanding": True
}]
)
Analisi visiva dei dati
Interpreta grafici e tabelle pubblicati nei report online senza doverli scaricare manualmente:
response = client.responses.create(
model="grok-4.5",
input="Analyze the European AI market growth charts published recently",
tools=[{
"type": "web_search",
"allowed_domains": ["statista.com", "mckinsey.com"],
"enable_image_understanding": True
}]
)
Limitazioni da conoscere
L’analisi delle immagini aumenta il tempo di risposta perché il modello deve elaborare dati visivi oltre al testo. Consuma anche più token in output. Abilitala solo quando le informazioni visive aggiungono un reale valore alla risposta.
La qualità dell’analisi dipende anche dalla risoluzione e dalla chiarezza delle immagini trovate. I grafici ad alta risoluzione con etichette leggibili producono risultati migliori rispetto alle immagini sfocate o confuse.
Esercitazione pratica
Crea uno script che chieda a Grok di analizzare le tendenze visive in un settore (ad esempio, grafici delle prestazioni per un indice azionario o infografiche da un report di settore). Confronta la ricchezza della risposta ottenuta con e senza enable_image_understanding.
Punti chiave
- Il parametro
enable_image_understandingconsente al modello di analizzare le immagini dai risultati web - Il modello utilizza internamente lo strumento
view_imageper esaminare gli elementi visivi rilevanti - Questo parametro può essere combinato con
allowed_domainsoexcluded_domains - L’analisi delle immagini aumenta il tempo di elaborazione e il consumo di token
- Questa funzione è ideale per il monitoraggio visivo, l’analisi di grafici e l’estrazione di dati da infografiche