Auf dieser Seite wird beschrieben, wie Sie Ergebnisse für die Benutzeroberfläche der Web-App konfigurieren. Über diese Oberfläche greifen Nutzer auf Ihre App zu.
Konzepte des Such-Widgets
Nachfolgend werden einige Konzepte beschrieben, die Ihnen dabei helfen, die Steuerelemente auf dem Tab Benutzeroberfläche zu verstehen und zu verwenden.
Snippet: Ein kurzer Textabschnitt, in der Regel ein Satz, unter dem Dokumenttitel. Für Websitedaten und unstrukturierte Daten wird für jedes Suchergebnis standardmäßig ein Snippet angezeigt.
Suche mit einer Antwort: Diese Funktion liefert einen Absatz mit Informationen (die Antwort), der aus den Top-Ergebnissen von Website- oder unstrukturierten Daten zusammengestellt wird. Sie können die Anzahl der Top-Ergebnisse anpassen, auf denen die Antwort basieren soll. Standardmäßig werden die fünf Top-Ergebnisse für die Antwort zusammengefasst. Die Suche mit einer Antwort kann nicht mit der Suche mit weiterführenden Fragen kombiniert werden.
Suche mit weiterführenden Fragen Mit dieser Funktion für Website- und unstrukturierte Daten können Sie weiterführende Fragen stellen, die den Kontext der ursprünglichen Suchanfrage beibehalten.
Automatische Vervollständigung: Schlägt Suchanfragen basierend auf den ersten Buchstaben vor, die Nutzer in die Suchleiste eingeben. Weitere Informationen finden Sie unter Automatische Vervollständigung konfigurieren.
Feedback: Bietet die Buttons thumb_up und thumb_down, damit Nutzer die Qualität der Suchergebnisse bewerten können. Diese Informationen werden nur an Google gesendet. Weitere Informationen finden Sie unter Feedback konfigurieren.
Metadaten: Wenn die Daten strukturiert sind oder Metadaten enthalten, können Sie konfigurieren, welche Metadatenfelder in den Suchergebnissen enthalten sein sollen. Sie können Felder auch den Anzeigenamen für Facetten zuordnen. Weitere Informationen finden Sie unter Facetten für die Benutzeroberfläche konfigurieren.
Vom Administrator konfigurierter Anzeigename für Quellen: Zeigt den vom Administrator konfigurierten Anzeigenamen für Datenquellen in der Web-App anstelle des Connector-Typs an. Weitere Informationen finden Sie unter Von Administratoren konfigurierte Anzeigenamen für Datenquellen anzeigen.
Suchergebnisse für unstrukturierte Daten oder Websitedaten konfigurieren
Die Benutzeroberfläche für unstrukturierte Daten und Websitedaten bietet die folgenden Anpassungsmöglichkeiten für Suchen:
- Suche (eine Runde)
- Suche mit einer Antwort (Suche mit einer Runde und Zusammenfassung)
- Suche mit weiterführenden Fragen (mehrere Runden)
So konfigurieren Sie, wie die Suchergebnisse für unstrukturierte Daten auf der Benutzeroberfläche angezeigt werden:
Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.
Klicken Sie auf den Namen der App, die Sie bearbeiten möchten.
Klicken Sie im Navigationsmenü auf Konfigurationen.
Klicken Sie auf den Tab Benutzeroberfläche.
Bearbeiten Sie die Felder auf dem Tab.
Verwenden Sie den Bereich Vorschau, um zu prüfen, ob Ihre Änderungen wie erwartet angezeigt werden.
Klicken Sie auf Speichern und veröffentlichen, um die Änderungen zu übernehmen.
Suchergebnisse für strukturierte Daten konfigurieren
Für strukturierte Daten werden auf der Benutzeroberfläche standardmäßig alle Name-Wert-Paare für jedes Element in den Suchergebnissen angezeigt. In der Google Cloud Console können Sie auf der Seite Konfigurationen anpassen, wie Suchergebnisse auf der Benutzeroberfläche angezeigt werden.
In der folgenden Liste sind die primären Felder für die Anzeige von Suchergebnissen aufgeführt:
- Titel: Ein Elementtitel, auf den ein Nutzer klicken kann, um das Element in einem Suchergebnis auszuwählen.
- Miniaturansicht: Die URL eines Bildes, das neben dem Elementtitel in einem Suchergebnis angezeigt werden soll.
- URL: Eine URL, zu der Nutzer weitergeleitet werden, wenn auf den Elementtitel geklickt wird.
Sie können in Ihren Suchergebnissen bis zu drei weitere Felder anzeigen und konfigurieren, wie diese dargestellt werden sollen.
Außerdem können Sie Facetten auswählen, nach denen Suchergebnisse gefiltert werden sollen, und deren Anzeigenamen festlegen. Weitere Informationen zum Konfigurieren von Facetten finden Sie unter Facetten für die Benutzeroberfläche konfigurieren.
So konfigurieren Sie, wie die Suchergebnisse für strukturierte Daten auf der Benutzeroberfläche angezeigt werden:
Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.
Klicken Sie auf den Namen der Suchanwendung, die Sie bearbeiten möchten.
Klicken Sie auf Konfigurationen.
Klicken Sie auf den Tab Benutzeroberfläche.
Wenn mehrere Datenspeicher mit Ihrer App verbunden sind, wählen Sie den Datenspeicher aus, für den Sie die Ergebnisse konfigurieren möchten.
Maximieren Sie den Bereich Felder in Ergebnissen konfigurieren.
Geben Sie im Bereich Vorschau eine Anfrage ein und drücken Sie die Eingabetaste, um zu sehen, wie die Suchergebnisse mit Ihren aktuellen Einstellungen angezeigt werden. Die Vorschau wird automatisch aktualisiert, wenn Sie neue Einstellungen festlegen.
Optional: Klicken Sie auf ein Gerätesymbol, um die Vorschau im Desktop- bzw. Mobilgeräteformat anzuzeigen.
So konfigurieren Sie die primären Felder (Titel, Miniaturansicht und URL) in Ihren Suchergebnissen:
Klicken Sie auf das Feld Titel und wählen Sie ein Feld für die Titel in Ihren Suchergebnissen aus. Sie können auch Keine auswählen, wenn in den Suchergebnissen keine Titel angezeigt werden sollen.
Klicken Sie auf das Feld Miniaturansicht und wählen Sie ein Feld für die Miniaturansichten in Ihren Suchergebnissen aus. Sie können auch Keine auswählen, wenn in den Suchergebnissen keine Miniaturansichten angezeigt werden sollen.
Klicken Sie auf das Feld URL und wählen Sie ein Feld für die Elemente aus, die geöffnet werden sollen, wenn Nutzer in den Suchergebnissen auf die Elementtitel klicken. Sie können auch Keine auswählen, wenn die Elementtitel in Ihren Suchergebnissen nicht mit Elementen verknüpft werden sollen.
So fügen Sie Ihren Suchergebnissen weitere Felder hinzu:
Klicken Sie auf das Feld Text 1 und wählen Sie ein Feld aus, das in den Suchergebnissen angezeigt werden soll. In den Suchergebnissen wird standardmäßig nur der Feldwert angezeigt.
Klicken Sie auf den Pfeil neben dem Feld Text 1, um das Feld Vorlage einzublenden. Das Feld {value} im Feld Vorlage steht für den Feldwert, der im Suchergebnis angezeigt werden soll. Fügen Sie vor und/oder nach dem Feld {value} Text hinzu, um dem Wert in den Suchergebnissen Kontext zu geben. Angenommen, Sie haben im Feld Text 1
priceausgewählt und der Preiswert für ein bestimmtes Element ist 42. Wenn Sie das Feld Vorlage auf"Total Price: {value} USD"ändern, wird in den Suchergebnissen für dieses Element „Gesamtpreis: 42 US-Dollar“ angezeigt.Wiederholen Sie diese Schritte für die Felder Text 2 und Text 3.
So konfigurieren Sie Facetteneinstellungen:
Maximieren Sie den Bereich Facetteneinstellungen.
Wählen Sie ein Feld aus, das als Facette verwendet werden soll, und geben Sie einen Anzeigenamen ein.
Klicken Sie auf Attribut hinzufügen, wenn Sie weitere Facetten hinzufügen möchten.
Prüfen Sie im Bereich Vorschau, ob Ihre Änderungen richtig angezeigt werden.
Klicken Sie auf Speichern und veröffentlichen, um die Änderungen zu übernehmen.
Vom Administrator konfigurierte Anzeigenamen für Datenquellen anzeigen
Standardmäßig wird in der Web-App der Connectortyp als Label für Datenquellen mit einer einzelnen Instanz angezeigt. Sie können die Einstellung Vom Administrator konfigurierten Anzeigenamen für Quellen verwenden aktivieren, damit in der Web-App der benutzerdefinierte Anzeigename angezeigt wird, den Sie für jede Datenquelle konfiguriert haben.
So aktivieren oder deaktivieren Sie vom Administrator konfigurierte Anzeigenamen für Datenquellen:
Console
Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.
Klicken Sie auf den Namen der App, die Sie bearbeiten möchten.
Klicken Sie im Navigationsmenü auf Konfigurationen.
Klicken Sie im Navigationsmenü auf Such-UI.
Aktivieren oder deaktivieren Sie im Bereich Allgemeine Konfigurationen die Ein/Aus-Schaltfläche Vom Administrator konfigurierten Anzeigenamen für Quellen verwenden.
Klicken Sie auf Speichern und veröffentlichen, um die Änderungen zu übernehmen.
REST
Aktualisieren Sie das Feld uiSettings.sourceAdminDisplayNameEnabled in der WidgetConfig-Ressource der App, indem Sie die Methode engines.widgetConfigs.patch aufrufen:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/collections/default_collection/engines/APP_ID/widgetConfigs/default_search_widget_config?updateMask=uiSettings.sourceAdminDisplayNameEnabled" \
-d '{
"uiSettings": {
"sourceAdminDisplayNameEnabled": SOURCE_ADMIN_DISPLAY_NAME_ENABLED
}
}'
Ersetzen Sie Folgendes:
ENDPOINT_LOCATION: die Multiregion für Ihre API-Anfrage. Geben Sie einen der folgenden Werte an:usfür die Multiregion „USA“eufür die Multiregion „EU“globalfür den Standort „Global“
PROJECT_ID: Die Nummer oder ID Ihres Google Cloud ProjektsLOCATION_ID: der geografische Standort Ihres Datenspeichers, z. B. global.
Weitere Informationen finden Sie unter Standorte.
APP_ID: die ID der App.SOURCE_ADMIN_DISPLAY_NAME_ENABLED: Ein boolescher Wert.
Geben Sie true an, um den vom Administrator konfigurierten Anzeigenamen für Datenquellen zu verwenden, oder false, um den Connector-Typ zu verwenden.