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:
| Modello | Attività o risultato documentato |
| Object detection | Rileva oggetti e ne restituisce la posizione con riquadri rettangolari. |
| Image labeling | Associa etichette alle immagini, organizzate per categoria. |
| Face detection | Può restituire poligoni di delimitazione, punti di riferimento del volto, angoli di orientamento e probabilità relative alle espressioni. |
| Explicit content detection | Restituisce valutazioni di probabilità relative a contenuti per adulti o violenti. |
| PDF classification | Assegna 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.