O Object Enrichments, em prévia no Cloud Storage, processa imagens e PDFs elegíveis de forma assíncrona: os modelos geram metadados estruturados, que ficam associados ao objeto como object context. O recurso pode ser acessado pelo console ou pela API, e os resultados também podem seguir para análise no BigQuery por meio de conjuntos de dados do Storage Insights. Visão geral oficial do Object Enrichments · Anúncio do Google Cloud

Antes de configurar o processamento, escolha o modelo pela tarefa necessária e confira se o arquivo e o bucket atendem aos requisitos.

Cinco modelos para tarefas diferentes

A prévia lista cinco modelos. Cada um atende a uma tarefa específica e produz um tipo de resultado diferente, conforme a documentação do Google Cloud.

ModeloResultado documentado
Object detectionIdentifica objetos e registra suas posições com limites retangulares.
Image labelingAtribui rótulos a categorias da imagem.
Face detectionPode retornar polígonos delimitadores, marcos faciais, ângulos de orientação e probabilidades de expressões.
Explicit content detectionRetorna classificações de probabilidade para conteúdo adulto ou violento.
PDF classificationAtribui categorias a documentos PDF.

A distinção ajuda a direcionar cada arquivo à tarefa apropriada: detectar objetos, por exemplo, gera posições delimitadas; classificar um PDF produz categorias de documento. Os resultados são metadados associados ao arquivo, não uma substituição do conteúdo original.

Onde ficam os resultados

O Cloud Storage anexa os resultados ao objeto em um contexto personalizado. O Google descreve controles de IAM para gerenciar o acesso a esses dados e indica o caminho do Storage Insights para exportá-los a conjuntos de dados e analisá-los no BigQuery. O contexto JSON de cada objeto pode ter até 128 KiB, segundo o anúncio do Google Cloud.

Como o processamento é assíncrono, a análise não precisa acontecer no mesmo momento em que o arquivo é armazenado. Depois, os metadados podem servir de base para consultas e análises sobre os objetos.

Requisitos para arquivos e buckets

Imagens e PDFs precisam ter até 20 MiB e um cabeçalho Content-Type válido e compatível. Os formatos de imagem listados são BMP, GIF, ICO, JPEG, PNG, TIFF e WEBP; para documentos, o tipo aceito é PDF (application/pdf). A documentação também lista três grupos de locais de processamento: us, eu e asia. Configurar o mesmo bucket e modelo em mais de um local repete o processamento e gera uma cobrança por execução. Requisitos oficiais

Buckets Rapid e buckets com namespace hierárquico ativado não são compatíveis; objetos criptografados com chaves fornecidas pelo cliente também ficam fora do suporte. As configurações usam nomes exatos de buckets, sem curingas ou expressões regulares. A movimentação de um bucket é incompatível com o recurso, e buckets criados ou recriados depois da configuração não são adicionados automaticamente a ela. Se o inventário de buckets mudar, a configuração precisa levar essa mudança em conta.

Gemini nativo ainda não faz parte da prévia

O anúncio do Google Cloud descreve o enriquecimento nativo com Gemini como uma funcionalidade futura, fora do escopo da prévia atual. O recurso em prévia se concentra nos cinco modelos listados para imagens e PDFs elegíveis.