Auf Websites nach Bildern suchen

Mit der Agent Search können Sie mit einer App mit Websitedaten nach Bildern suchen. Sie geben eine Abfrage in Form eines Textstrings oder eines Bildes ein und die Methode default_config.search gibt Bilder für diese Abfrage zurück.

**Hinweis**: Die Bildersuche ist über die Google Cloud Console nicht verfügbar.

Hinweis

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

• Wenn Sie in Ihrer Suchanwendung für Websites mit einer Textabfrage suchen, müssen die folgenden Funktionen aktiviert sein: Enterprise-Version

• Wenn Sie in Ihrer Suchanwendung für Websites mit einer Bildabfrage suchen, müssen die folgenden Funktionen aktiviert sein:

  • Enterprise-Features

  • Erweiterte Websiteindexierung

Vorschau der Bildersuche

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

Hinweis: Sie können eine App mit der Methode engines.servingConfigs.search durchsuchen und einen Datenspeicher mit der Methode dataStores.servingConfigs.search. Für das folgende Verfahren empfiehlt Google die Suche mit der Methode engines.servingConfigs.search.

1. App-ID suchen. 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.

      Gehen Sie zu Apps

   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 engines.servingConfigs.search Methode auf und geben Sie 1 für search_type an. Wählen Sie die Methodensyntax je nachdem aus, ob Ihre Abfrage Text oder Bild-Byte enthält.

   Wichtiger Begriff: In der Agent Search kann der Begriff App im Zusammenhang mit APIs synonym mit dem Begriff Engine verwendet werden.

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

   Abfrage 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. Beispiel: „Autos mit runden Scheinwerfern“ oder „Zeig mir ein Kleid mit Streifen“.

   • IMAGE_BYTES: das Bild in Base64-codierten Byte. 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 Websitesuche 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 das 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 die Feldnamen und Beschreibungen:

   Feld	Beschreibung
   title	Der Titel der Webseite, die das Bild enthält, als Nur-Text
   htmlTitle	Der Titel der Webseite, die das Bild enthält, im HTML-Format
   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	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 Miniaturbildes in Pixeln
   image.thumbnailHeight	Die Höhe des Miniaturbildes in Pixeln
   image.thumbnailLink	Die URL des Miniaturbildes
   mime	Der MIME-Typ des Bildes
   fileFormat	Das Dateiformat des Bildes