Google Cloud Object Enrichments è una funzione in preview per Cloud Storage che applica modelli selezionati a immagini e PDF idonei, poi associa i risultati agli oggetti come contesto strutturato. L’elaborazione è asincrona: i file possono quindi essere arricchiti senza inserire l’inferenza nel flusso immediato di caricamento. La funzione è accessibile dalla console Cloud Storage e tramite API.

Quali attività coprono i cinque modelli

La documentazione di Google Cloud elenca cinque modelli, ciascuno dedicato a un compito distinto. Per scegliere quello adatto, conviene partire dal tipo di risultato che serve al flusso di lavoro:

ModelloAttività o risultato documentato
Object detectionRileva oggetti e ne restituisce la posizione con riquadri rettangolari.
Image labelingAssocia etichette alle immagini, organizzate per categoria.
Face detectionPuò restituire poligoni di delimitazione, punti di riferimento del volto, angoli di orientamento e probabilità relative alle espressioni.
Explicit content detectionRestituisce valutazioni di probabilità relative a contenuti per adulti o violenti.
PDF classificationAssegna categorie ai documenti PDF.

La distinzione è pratica: il rilevamento di oggetti e il rilevamento di contenuti espliciti sono attività separate, così come l’analisi dei volti e l’assegnazione di etichette generali alle immagini. La panoramica ufficiale di Object Enrichments descrive i compiti e i relativi risultati.

Seleziona il modello in base al risultato che vuoi ottenere: le cinque attività non producono tutte lo stesso tipo di metadato.

Dove finiscono i risultati

Object Enrichments aggiunge i risultati agli oggetti Cloud Storage come object context, cioè metadati strutturati associati al file. La documentazione colloca questi valori in contexts.custom. I controlli IAM di Cloud Storage possono regolare l’accesso agli oggetti e ai relativi contesti.

Per analizzare i dati a valle, i dataset Storage Insights possono esportare i metadati in BigQuery. In questo modo, un’attività come la classificazione dei PDF può alimentare analisi successive senza confondere il risultato del modello con il contenuto del file stesso. Google descrive il flusso e l’uso dei dataset nella documentazione su Object Enrichments.

Requisiti per file e bucket

Gli oggetti devono essere immagini o PDF di dimensione non superiore a 20 MiB e avere un Content-Type supportato. I formati immagine indicati sono BMP, GIF, ICO, JPEG, PNG, TIFF e WEBP; per i documenti è supportato PDF con il tipo application/pdf.

La funzione offre le località di elaborazione us, eu e asia. Configurare lo stesso bucket e modello in più località ripete l’elaborazione e comporta un addebito per ciascuna esecuzione. Non sono supportati i bucket Rapid, quelli con spazio dei nomi gerarchico attivo e gli oggetti cifrati con chiavi fornite dal cliente.

La configurazione usa nomi esatti di bucket, non caratteri jolly o espressioni regolari. Inoltre, spostare un bucket è incompatibile con la funzione; i bucket creati o ricreati successivamente non vengono aggiunti automaticamente alle configurazioni esistenti. Sono condizioni da considerare quando cambia l’inventario dei bucket o si pianifica una migrazione. La documentazione tecnica di Google Cloud riporta questi vincoli operativi.

Gemini non fa parte della preview

Google ha descritto l’arricchimento nativo con Gemini come una funzionalità futura, non inclusa nella preview di Object Enrichments. La versione attuale si basa sui cinque compiti elencati sopra; l’annuncio di Google Cloud presenta l’integrazione con Gemini come uno sviluppo successivo.