Nach Bildern auf Websites suchen

Mit Vertex AI Search können Sie mit einer App mit Websitedaten nach Bildern suchen. Sie geben eine Suchanfrage in Form eines Textstrings oder eines Bildes an und die default_config.search-Methode gibt Bilder für diese Suchanfrage zurück.

Hinweise

Sie müssen die folgenden Voraussetzungen erfüllen. Die Anforderungen variieren je nachdem, ob Sie mit einer Textabfrage oder einer Bildabfrage suchen.

Wenn Sie über die Befehlszeile eine Vorschau der Bildergebnisse für eine Website anzeigen lassen möchten, verwenden Sie die Methode engines.servingConfigs.search:

  1. Suchen Sie Ihre App-ID. Wenn Sie bereits eine App-ID haben, fahren Sie mit dem nächsten Schritt fort.

    1. Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.

      Zu Apps wechseln

    2. Suchen Sie auf der Seite Apps nach dem Namen Ihrer App und sehen Sie sich die ID der App in der Spalte ID an.

  2. Rufen Sie die Methode engines.servingConfigs.search auf und geben Sie 1 für search_type an. Wählen Sie die Methodensyntax aus, je nachdem, ob Ihre Abfrage Text- oder Bildbytes enthält.

    Die Abfrage ist ein Textstring.

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

    Die Suchanfrage ist ein Bild

    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: Die ID Ihres Projekts.

    • APP_ID: Die ID Ihrer App.

    • QUERY: Der Suchanfragetext. Beispiel: „Autos mit runden Scheinwerfern“ oder „Zeig mir ein Kleid mit Streifen.“

    • IMAGE_BYTES: Das Bild in Base64-codierten Bytes. Unterstützte Formate sind JPEG, PNG und BMP.

    • PAGE_SIZE: Optional. Die Anzahl der Ergebnisse, die von der Suche zurückgegeben wurden. Der Standardwert für die Websitesuche ist 10.

      • Werte unter 0 führen zu einem Fehler.
      • Werte über 100 werden auf 100 gesetzt.

    • OFFSET: Optional. Der Startindex der Ergebnisse. Der Standardwert ist 0.

      Wenn der Offset beispielsweise 2 und die Seitengröße 10 ist, werden die Ergebnisse 2 bis 11 zurückgegeben.

  3. Prüfen Sie die Antwort. In der folgenden Tabelle finden Sie Feldbeschreibungen:

    Feld Beschreibung
    title Der Klartexttitel der Webseite, die das Bild enthält
    htmlTitle Der HTML-Titel der Webseite, auf der sich das Bild befindet
    displayLink Eine gekürzte Version der Ergebnis-URL dieser Suche, in der Regel der Domainname, z. B. www.example.com
    link Die URL des Bildes
    image.contextLink Kontextlink: Eine URL, die auf die Webseite verweist, die das Bild enthält
    image.byteSize Größe des Bilds in Byte
    image.width Die Breite des Bilds in Pixeln
    image.height Die Höhe des Bilds in Pixeln
    image.thumbnailWidth Die Breite des Thumbnail-Bilds in Pixeln
    image.thumbnailHeight Die Höhe des Thumbnails in Pixeln
    image.thumbnailLink Die URL des Thumbnail-Bilds
    mime Der MIME-Typ des Bilds
    fileFormat Das Dateiformat des Bilds