Nach Bildern auf Websites suchen

Mit Vertex AI Search können Sie mit einer Anwendung mit Websitedaten nach Bildern suchen. Sie stellen eine Anfrage in Form eines Textstrings oder eines Bildes bereit und die Methode default_config.search gibt Bilder für diese Anfrage zurück.

Hinweise

Prüfen Sie, ob die folgenden Voraussetzungen erfüllt sind. Die Anforderungen variieren je nachdem, ob Sie mit einer Text- oder Bildanfrage suchen.

Wenn Sie die Befehlszeile verwenden möchten, um eine Vorschau der Bildergebnisse für eine Website zu sehen, verwenden Sie die Methode engines.servingConfigs.search:

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

    1. Rufen Sie in der Google Cloud Console die Seite KI-Anwendungen auf.

      Zu Apps wechseln

    2. Suchen Sie auf der Seite Apps nach dem Namen Ihrer App und entnehmen Sie die App-ID der Spalte ID.

  2. Rufen Sie die Methode engines.servingConfigs.search auf und geben Sie 1 für search_type an. Wählen Sie die Methodensyntax je nachdem aus, ob Ihre Anfrage Text oder Bild-Bytes 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 Anfrage 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}
}'

    Ersetzen Sie Folgendes:

    • PROJECT_ID: die Projekt-ID.

    • APP_ID: Die ID Ihrer App.

    • QUERY: Der Text der Suchanfrage. Beispiele: „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 von der Suche zurückgegebenen Ergebnisse. Der Standardwert für die Website-Suche ist 10.

      • Werte unter 0 führen zu einem Fehler.
      • Bei Werten über 100 wird der Wert auf 100 festgelegt.

    • 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. Feldbeschreibungen finden Sie in der folgenden Tabelle:

    Feld Beschreibung
    title Der Klartexttitel der Webseite, die das Bild enthält
    htmlTitle Der Titel der Webseite, die das Bild enthält, in HTML
    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 mit dem Bild verweist
    image.byteSize Die Größe des Bildes in Byte
    image.width Die Breite des Bildes in Pixeln
    image.height Die Höhe des Bildes in Pixeln
    image.thumbnailWidth Die Breite des Vorschaubilds in Pixeln
    image.thumbnailHeight Die Höhe des Vorschaubilds in Pixeln
    image.thumbnailLink Die URL des Bildes für die Miniaturansicht
    mime Der MIME-Typ des Bildes
    fileFormat Das Dateiformat des Bildes