Cercare immagini sui siti web

Con Vertex AI Search puoi cercare immagini utilizzando un'app con i dati del sito web. Fornisci una query sotto forma di stringa di testo o immagine e il metodo default_config.search restituisce le immagini corrispondenti alla query.

Prima di iniziare

Assicurati di soddisfare i seguenti prerequisiti. I requisiti variano a seconda che la ricerca venga eseguita utilizzando una query di testo o una query di immagini.

Per utilizzare la riga di comando per visualizzare l'anteprima dei risultati di ricerca di immagini per un sito web, utilizza il metodo engines.servingConfigs.search:

  1. Trova l'ID app. Se hai già l'ID app, vai al passaggio successivo.

    1. Nella console Google Cloud, vai alla pagina Agent Builder.

      Vai ad App

    2. Nella pagina App, trova il nome della tua app e recupera l'ID dall'app la colonna ID.

  2. Chiama il metodo engines.servingConfigs.search specificando 1 per search_type. Scegli la sintassi del metodo a seconda che la query sia in byte di testo o di immagine.

    La query è una stringa di testo

    curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_config:search" \
-d '{
"servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search",
"query": "QUERY",
"pageSize": "PAGE_SIZE",
"offset": "OFFSET",
"params": {"search_type": 1}
}'

    La query è un'immagine

    curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \
-d '{
"servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search",
"imageQuery": {"imageBytes":"IMAGE_BYTES"},
"pageSize": "PAGE_SIZE",
"offset": "OFFSET",
"params": {"search_type": 1}
}'

    • PROJECT_ID: l'ID del progetto.

    • APP_ID: l'ID della tua app.

    • QUERY: il testo della query di ricerca. Ad esempio, "auto con fari anteriori rotondi" o "fammi vedere un vestito a righe".

    • IMAGE_BYTES: l'immagine in byte codificati Base64. I formati supportati sono JPEG, PNG e BMP.

    • PAGE_SIZE: facoltativo. Il numero di risultati restituiti dalla ricerca. Il valore predefinito è 10 per la ricerca sul sito web.

      • I valori inferiori a 0 causano un errore.
      • I valori superiori a 100 determinano l'impostazione del valore su 100.

    • OFFSET: facoltativo. L'indice iniziale dei risultati. Il valore predefinito è 0.

      Ad esempio, se l'offset è 2 e la dimensione della pagina è 10, vengono restituiti i risultati da 2 a 11.

  3. Esamina la risposta. Per le descrizioni dei campi, consulta la tabella seguente:

    Campo Descrizione
    title Il titolo in testo normale della pagina web che contiene l'immagine
    htmlTitle Il titolo, in HTML, della pagina web che contiene l'immagine
    displayLink Una versione abbreviata dell'URL del risultato di questa ricerca, in genere il nome di dominio, ad esempio www.example.com
    link L'URL dell'immagine
    image.contextLink Link di contesto: un URL che rimanda alla pagina web contenente l'immagine
    image.byteSize Le dimensioni dell'immagine, espresse in byte
    image.width La larghezza dell'immagine, in pixel
    image.height L'altezza dell'immagine, in pixel
    image.thumbnailWidth La larghezza dell'immagine in miniatura, in pixel
    image.thumbnailHeight L'altezza dell'immagine in miniatura, in pixel
    image.thumbnailLink L'URL dell'immagine in miniatura
    mime Il tipo MIME dell'immagine
    fileFormat Il formato del file dell'immagine