Cercare immagini sui siti web

Con la Ricerca di agenti, puoi cercare immagini utilizzando un'app con dati di siti web. Fornisci una query sotto forma di stringa di testo o immagine e il metodo default_config.search restituisce le immagini per quella query.

Prima di iniziare

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

Per utilizzare la riga di comando per visualizzare l'anteprima dei risultati delle 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 Google Cloud console, vai alla pagina AI Applications.

      Vai ad App

    2. Nella pagina App, trova il nome dell'app e recupera l'ID dell'app dalla colonna ID.

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

    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}
}'

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID progetto.

    • APP_ID: l'ID app.

    • QUERY: il testo della query di ricerca. Ad esempio, "Auto con fari rotondi" o "Mostrami un vestito a righe".

    • IMAGE_BYTES: l'immagine in byte codificati in 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 di siti web.

      • I valori inferiori a 0 causano un errore.
      • I valori superiori a 100 vengono impostati 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. Consulta la seguente tabella per le descrizioni dei campi:

    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 che contiene l'immagine
    image.byteSize Le dimensioni dell'immagine, 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 file dell'immagine