Feldeinstellungen konfigurieren

Auf dieser Seite erfahren Sie, wie Sie die Schemafelder konfigurieren, um eine App für strukturierte Daten, für unstrukturierte Daten mit Metadaten oder für Websitedaten mit benutzerdefinierten, strukturierten Attributen einzurichten.

Mit den Feldeinstellungen wird festgelegt, wie Agent Search die Felder in den Ergebnissen verwendet. In der Google Cloud Console können Sie auf dem Tab Schema die Feldeinstellungen konfigurieren.

Die Feldeinstellungen können nur für Apps mit Datenspeichern, die strukturierte Daten oder unstrukturierte Daten mit Metadaten enthalten, konfiguriert werden.

Feldeinstellungen

Die folgenden Feldeinstellungen sind für viele Feldtypen in Ihren Such- oder Empfehlungsdaten verfügbar, aber nicht für alle Datentypen. Ein Schema enthält mehrere Feldeinstellungen für einzelne Felder. Die nächste Tabelle enthält Einstellungen, die auf ein Feld in einem Schema angewendet werden können. Die Verwendung strukturierter Daten wird für diese Feldeinstellungen dringend empfohlen:

Einstellung Definition Zweck Beispiel für einen Anwendungsfall
Indexierbar

Wenn Sie Felder als indexierbar festlegen können Sie Vorgänge wie Filtern, Boosting und Facettierung auf strukturierte Felder in einem Dokument anwenden.

Felder vom Typ Object können nicht auf Indexable festgelegt werden.

Wenn Sie ein Feld als Indexable kennzeichnen, können Sie schneller suchen.

Beachten Sie, dass die Kennzeichnung eines Felds als Indexable die Größe des Suchindex erhöht und die Indexierung verlangsamen kann.

 In einem Datenspeicher für Hotels können Sie ein Feld, wie hotel_chain, als indexierbar festlegen. So können Sie Ranking-, Filter- und Boosting-Vorgänge auf hotel_chain anwenden. Sie können beispielsweise einen Filter anwenden, damit die Suche nur Suchergebnisse mit der gefilterten Hotelkette liefert.
Suchbar

Felder, die am wahrscheinlichsten mit Suchanfragen in Verbindung stehen, werden als Searchable gekennzeichnet. Ein Feld kann suchbar sein, ohne indexierbar oder abrufbar zu sein.

Nur Felder mit Textwerten können als suchbar gekennzeichnet werden. Ein numerisches Preisfeld kann indexierbar sein (zum Filtern oder Facettieren), aber nicht als Volltext durchsucht werden.

Wenn Sie ein Feld auf Suchbar festlegen, wird der Recall-Wert für dieses Feld in Suchanfragen verbessert. So können Nutzer Inhalte wie Web seiten finden, indem sie den Text in diesen Feldern abfragen. Wenn Sie ein Feld als suchbar kennzeichnen, kann Ranking angewendet werden. Wenn Sie jedoch zu viele Felder als suchbar kennzeichnen, kann sich dies negativ auf die Suchgenauigkeit auswirken, da der Ranking-Algorithmus überlastet wird und zu viele Ergebnisse zurückgegeben werden. Das kann zu irrelevanten Suchergebnissen führen.

Sie können suchbaren Feldern eine relative Gewichtung zuweisen. Aufgrund der robusten Standardeinstellungen ist dies jedoch selten erforderlich. Weitere Informationen finden Sie unten unter Suchbare Felder gewichten.

Im Support-Ticketsystem eines Internetanbieters wird jedes Ticket als strukturiertes Dokument gespeichert. Wenn diese Dokumente suchbare Textfelder wie issue_description oder resolution_notes enthalten, kann ein Support mitarbeiter eine Abfrage zum Inhalt dieser Felder ausführen, z. B. Wie behebe ich langsame Internetgeschwindigkeiten nach dem Zurücksetzen des Modems? Das System gibt dann die Dokumente zurück, die einen dieser Suchbegriffe enthalten, einschließlich Modem, Internet, Geschwindigkeit, entweder in einem oder beiden issue_description oder resolution_notes Feldern.
Als dynamisches Attribut verwendbar Bietet kontextbezogene Filter, um Suchanfragen für Nutzer besser auszurichten. Wenn Sie ein Feld als Dynamic Facetable festlegen, kann das System automatisch interaktive Filter (Facetten) basierend auf den eindeutigen Werten im Feld generieren. Wenn Sie ein Feld auf Dynamic facetable festlegen, können Nutzer Suchergebnisse dynamisch verfeinern, indem sie Kategorien oder Attribute auswählen, die direkt aus Ihren aufgenommenen Daten abgeleitet wurden. Sie müssen nicht jede mögliche Filteroption manuell vordefinieren. So kann der Nutzer seine Suche auf sehr spezifische Webinhalte eingrenzen.
Verwenden Sie Als dynamisches Attribut verwendbar mit Suchbar, um bessere Ergebnisse zu erzielen. Dadurch werden sowohl der Recall-Wert Ihrer Suche als auch die Qualität der dem Nutzer angebotenen Facetten verbessert. 		Seiten in einer internen Unternehmenswissensdatenbank, z. B. HR-Richtlinien, werden mit Daten wie department, document_type, oder last_modified_date aufgenommen. Wenn diese Felder als dynamic facetable gekennzeichnet sind, werden bei der Suche eines Mitarbeiters nach einem Begriff wie Kostenerstattung dynamisch interaktive Filter basierend auf den relevanten Ergebnissen generiert. In diesem Fall kann die Weboberfläche Facetten für Abteilung: Finanzen, Reisen, Dokumenttyp: Richtlinie, FAQ oder Letztes Änderungsdatum: Dieses Quartal, Letztes Jahr anzeigen.
Abrufbar Wenn eine Suchanfrage übereinstimmende Inhalte findet, kann die Suchmaschine die Werte der abrufbaren Felder abrufen, um sie anzuzeigen oder in der Anwendung zu verwenden. Das bedeutet, dass Informationen aus dem ursprünglichen Dokument als Teil der Suchergebnisse angezeigt werden. Schlüsselfelder (eindeutige Kennungen für Dokumente) werden als abrufbar eingerichtet. Abrufbare Felder bieten Suchkontext indem sie Felder unterscheiden, deren Werte angezeigt werden können, von Feldern, die nur in der Suchlogik verwendet werden sollen, deren Rohwerte aber nicht für den Endnutzer sichtbar sein sollen. Bei einer Produktsuche auf einer Händlerwebsite sind product_id, name, price und eine image_url typische Felder, die Sie als abrufbar festlegen sollten. Der internal_tracking_code kann indexiert und gefiltert werden, aber nicht in öffentlichen Suchergebnissen abgerufen werden.
Vervollständigbar Ermöglicht die Verwendung des Inhalts eines Felds für Suchvorschläge. Weitere Informationen finden Sie unter Automatische Vervollständigung konfigurieren.

Mit dieser Einstellung können Werte in diesem Feld verwendet werden, um Nutzern während der Eingabe Suchvorschläge in Echtzeit zu präsentieren. Diese Funktion hilft Nutzern, relevante Inhalte zu finden, und beschleunigt den Suchvorgang. Bestimmte Faktoren wie die Verwendung von Filtern für natürliche Sprache können sich auf die Leistung auswirken.

 Wenn das Feld completable für product_name, brand und category festgelegt ist und der Nutzer Tech eingibt, können die Vorschläge für die automatische Vervollständigung Folgendes anzeigen:
  • TechCo (aus dem Feld brand)
  • TechCo UltraBook X1 (aus dem product_name Feld)
  • Technologie GameMaster Pro (ein anderes Produkt aus dem category Feld)
Filterbar Ermöglicht es, dass Empfehlungen ein Feld verwenden, um empfohlene Ergebnisse zu filtern und so zu bestimmen, welche Suchergebnisse Ihren Nutzern angezeigt werden. Informationen zum Filtern von Empfehlungen finden Sie unter Filter Empfehlungen. Wenn Sie ein Feld auf Filterable festlegen, können Sie Empfehlungen für Nutzer anpassen. Beachten Sie, dass Filterbeschränkungen gelten. Eine Filtereinstellung nach Sprache und Drama könnte so aussehen: language_code: ANY("en", "fr") OR categories: ANY("drama").

Unterschiede zwischen häufig verwendeten Einstellungen

Es gibt wichtige Unterschiede zwischen den Feldeinstellungen „Indexierbar“, „Suchbar“ und „Abrufbar“. In der Tabelle sind diese Unterschiede zusammengefasst.

Funktion Indexierbar Suchbar Abrufbar
Primäre Rolle Macht Feldinhalte für die Suchmaschine verfügbar Ermöglicht Volltextabfragen für Feldinhalte Ermöglicht die Rückgabe des Feldwerts in den Suchergebnissen
Analyse Inhalte werden verarbeitet und in einen Index aufgenommen. Wird in der Regel einer umfangreichen lexikalischen Analyse unterzogen. Der Wert wird zur Anzeige unverändert gespeichert.
Kann es...
...suchbar sein? Ja (oft eine Voraussetzung) – Nicht unbedingt (kann abrufbar sein, ohne suchbar zu sein)
...abrufbar sein? Nicht unbedingt Nicht unbedingt –
...filterbar/sortierbar/facetierbar sein? Ja (in der Regel auch eine Voraussetzung dafür) Nicht direkt. Das sind separate Attribute, die oft auf einem indexierbaren Feld basieren. Nicht direkt. Diese Attribute beziehen sich darauf, wie das Feld indexiert und abgefragt wird, nicht nur darauf, wie es angezeigt wird.

In der Praxis werden viele Felder, die für die Nutzererfahrung entscheidend sind (z. B. Titel, Beschreibungen und personenidentifizierbare Informationen), oft auf indexable, searchable und retrievable festgelegt.

Beschränkungen

Für Feldeinstellungen gelten die folgenden Einschränkungen:

  • Sie können bis zu 50 Felder als indexierbar, suchbar, abrufbar oder „Als dynamisches Attribut verwendbar“ konfigurieren.
  • Wenn ein Feld als dynamisches Attribut konfiguriert werden soll, muss es zuerst als indexierbar konfiguriert werden.
  • Wenn Sie die indexierbare Einstellung ändern, müssen die Daten neu indexiert werden. Dies kann insbesondere bei großen Datenspeichern Stunden dauern.

Wenn Sie Felder für eine App zur Mediensuche konfigurieren und detaillierte Informationen zu den Feldern im Schema benötigen, lesen Sie Informationen zu Mediendokumenten und Daten speichern.

Feldeinstellungen aktualisieren

So aktualisieren Sie die Feldeinstellungen:

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

    KI-Anwendungen

  2. Klicken Sie auf den Namen der App, die Sie bearbeiten möchten.

  3. Klicken Sie auf Daten.

  4. Klicken Sie auf den Tab Schema. Auf diesem Tab werden die aktuellen Feldeinstellungen angezeigt.

    Der Tab Schema wird nicht angezeigt, wenn Ihr Datenspeicher grundlegende Websitedaten oder unstrukturierte Daten ohne Metadaten enthält.

  5. Klicken Sie auf Bearbeiten.

  6. Wählen Sie die Feldeinstellungen aus, die Sie aktualisieren müssen, oder heben Sie die entsprechende Auswahl auf. Einige Feldeinstellungen werden nicht unterstützt. Numerische Felder können beispielsweise nicht auf Suchbar festgelegt werden.

  7. Klicken Sie auf Speichern , um die Änderungen zu übernehmen.

Wenn Sie ein Feld als suchbar kennzeichnen, können Sie eine Gewichtung angeben, um seine relative Bedeutung in den Suchergebnissen anzugeben. In den meisten Fällen müssen Sie keine Gewichtungen für einzelne Felder angeben, da die Standardgewichtungen gut funktionieren.

In einigen Fällen kann es jedoch erforderlich sein, die Gewichtungen anzupassen, z. B.:

  • Sie migrieren Daten von einer vorhandenen Suchplattform, auf der bereits gewichtete Felder verwendet werden.

  • Wenn die Standardgewichtungen keine zufriedenstellenden Suchergebnisse liefern. Das kann insbesondere dann der Fall sein, wenn Sie viele suchbare Felder haben und einige deutlich wichtiger sind als andere.

    Vielleicht ist die Zusammenfassung das wichtigste Feld für Suchanfragen und Sie möchten diesen Text priorisieren.

    Oder das Schema enthält ein Feld mit hochrelevanten Keywords, die hervorragende Prädiktoren für Suchergebnisse sind. Da dieses Feld jedoch viel kürzer als andere ist, wird sein Einfluss oft von längeren Feldern überschattet. Wenn Sie die Gewichtung erhöhen, hat es die gewünschte Wirkung.

Gewichtungsstufen

Die Gewichtungen sind in die folgenden Stufen unterteilt:

Feldwichtigkeit Erklärung
Sehr niedrig Ein niedriger Wert, der vom System berücksichtigt wird, wenn es die Ergebnisse aus allen Feldern kombiniert. Wenn Sie noch weniger Gewichtung wünschen, damit der Effekt vernachlässigbar ist, kennzeichnen Sie das Feld nicht als suchbar.
Niedrig Eine Gewichtung, die niedriger als die Standardgewichtung ist.
Standard Die Standardgewichtung für suchbare Felder. Diese Gewichtung bietet in den meisten Fällen eine angemessen gute Leistung.
Hoch Eine Gewichtung, die deutlich höher als die Standardgewichtung ist.
Sehr hoch Eine dominierende Gewichtung. In der Regel reservieren Sie diese für maximal ein Feld.

Schemaaktualisierung und Neuindexierung

Wenn Sie suchbaren Feldern Gewichtungen hinzufügen, ist eine Schemaaktualisierung und anschließende Neuindexierung der Daten im Datenspeicher erforderlich. Die Aktualisierung des Schemas dauert Stunden und es gibt keine zuverlässige Anzeige, die Ihnen mitteilt, wann die Indexierung abgeschlossen ist. Sie müssen die Indexierungszeit also überschätzen.

Gewichtungsstufen für Felder festlegen

Das Festlegen von Gewichtungsstufen für Felder kann mühsam sein, da Sie nur kleine Änderungen vornehmen und die Suchergebnisse anschließend sorgfältig prüfen sollten, um unbeabsichtigte Folgen zu vermeiden. Nach jeder Änderung müssen Sie warten, bis die Neuindexierung abgeschlossen ist, bevor Sie die Auswirkungen der Änderung bewerten können.

Sie können die Gewichtung von Suchfeldern nur über die API konfigurieren. Diese Funktion ist in der Google Cloud Console nicht verfügbar.

Wenn Sie Gewichtungen festlegen möchten, müssen Sie das Schema für den Datenspeicher über die API projects.locations.dataStores.schemas.patch Methode aktualisieren.

  1. Wenn Sie Ihr Schema noch nicht haben, folgen Sie der Anleitung unter Schemadefinition ansehen, um es abzurufen.

  2. Folgen Sie der Anleitung, um das Schema programmatisch zu aktualisieren. Fügen Sie einem oder mehreren suchbaren Feldern Gewichtungen hinzu, wie in diesen Beispielen:

    "summary": {
   "type": "string",
   "searchable": true,
   "weight": "high"
 },
 "uri": {
   "type": "string",
   "searchable": true,
   "weight": "low"
 },

    In diesem Beispiel ist für das Feld summary eine höhere Gewichtung als normal und für das Feld uri eine niedrigere Gewichtung festgelegt. Wenn Sie eine Gewichtung auf den Standardwert zurücksetzen möchten, legen Sie sie auf default fest.

    Zulässige Werte für den Gewichtungsparameter sind:

    • very_low
    • low
    • default
    • high
    • very_high

  3. Warten Sie, bis die Neuindexierung abgeschlossen ist, und testen Sie das Suchverhalten.

Nächste Schritte