Feldeinstellungen konfigurieren

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

Mit den Feldeinstellungen wird festgelegt, wie die Agentensuche die Felder in den Ergebnissen verwendet. In derGoogle 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 innerhalb eines Schemas angewendet werden können. Für diese Feldeinstellungen wird die Verwendung strukturierter Daten dringend empfohlen:

Einstellung Definition Zweck Beispiel für einen Anwendungsfall
Indexierbar

Wenn Sie Felder als indexierbar festlegen, können Sie Vorgänge wie Filtern, Boosten und Facettieren für strukturierte Felder in einem Dokument ausführen.

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

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

Wenn Sie ein Feld als Indexable markieren, erhöht sich die Größe des Suchindex und die Indexierung kann sich verlangsamen.

In einem Hoteldatenspeicher 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 nur Suchergebnisse mit der gefilterten Hotelkette angezeigt werden.
Suchbar

Felder, die am wahrscheinlichsten mit Suchanfragen zusammenhängen, werden als Searchable bezeichnet. Ein Feld kann suchbar sein, ohne indexierbar oder abrufbar zu sein.

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

Wenn Sie ein Feld auf Suchbar setzen, wird der Recall-Wert für dieses Feld in Suchanfragen verbessert. Nutzer können dann Inhalte wie Webseiten finden, indem sie den Text in diesen Feldern abfragen. Wenn Sie ein Feld als suchbar markieren, kann ein Ranking angewendet werden. Wenn Sie zu viele Felder als suchbar markieren, kann sich das negativ auf die Suchgenauigkeit auswirken, da der Ranking-Algorithmus überlastet wird und zu viele Ergebnisse zurückgibt. Dies kann zu irrelevanten Suchergebnissen führen.

Sie können durchsuchbaren Feldern eine relative Gewichtung zuweisen. Aufgrund der robusten Standardeinstellungen ist dies jedoch selten erforderlich. Weitere Informationen finden Sie unten unter Suchbare Felder für die Gewichtung.

Das Support-Ticketsystem eines Internetanbieters speichert jedes Ticket als strukturiertes Dokument. Wenn diese Dokumente durchsuchbare Textfelder wie issue_description oder resolution_notes enthalten, kann ein Kundenservicemitarbeiter eine Anfrage zu den Inhalten in diesen Feldern stellen, z. B. wie man langsame Internetgeschwindigkeiten nach dem Zurücksetzen des Modems behebt. Das System würde dann die Dokumente anzeigen, die einen dieser Suchbegriffe enthalten, einschließlich Modem, Internet, Geschwindigkeit, entweder in einem oder in beiden issue_description- oder resolution_notes-Feldern.

Präfix-abgleichbar
(Vorschau)

Ermöglicht den Präfixabgleich von Textfeldern mit dem Operator STARTS_WITH in Filterausdrücken. Nur Felder vom Typ String oder String Array können auf „Präfixübereinstimmung“ festgelegt werden.

Weitere Informationen finden Sie unten im Abschnitt Felder für Präfix- und Teilübereinstimmungen verfügbar machen.

Wenn Sie ein Feld auf „Präfixübereinstimmung“ festlegen, kann die Suchmaschine Abfragestrings abgleichen, die Präfixe des Feldwerts sind. Das ist besonders nützlich für den Abgleich hierarchischer Kennungen, Pfade oder Codes, bei denen der Anfang des Strings bekannt ist. Der Präfixabgleich ist auf die ersten 12 Zeichen des normalisierten Feldwerts beschränkt und erhöht die Größe des Suchindex. Sie können nicht mehr als 10 Felder als Präfix-übereinstimmend festlegen.

Sie haben ein Feld ticket_id, das ein Format wie <country-code><city-code><number> verwendet. Beispiele: UKLON100, UKMAN100, UKMAN101 und USNY200. Wenn Sie alle Tickets aus Manchester (UK) finden möchten, können Sie das Feld ticket_id als Präfix-übereinstimmend festlegen und dann den Filter ticket_id: STARTS_WITH("UKMAN") verwenden, der UKMAN100 und UKMAN101 zurückgibt.

Teilweise abgleichbar
(Vorschau)

Ermöglicht den Teilstring-Abgleich für Textfelder mit dem Operator CONTAINS in Filterausdrücken. Nur Felder vom Typ String oder String Array können als teilweise abgleichbar festgelegt werden.

Weitere Informationen finden Sie unten im Abschnitt Felder für Präfix- und Teilübereinstimmungen verfügbar machen.

Wenn Sie ein Feld auf „Teilweise abgleichbar“ festlegen, wird der tokenbasierte Abgleich innerhalb eines Felds aktiviert. So können Nutzer Inhalte finden, wenn nur ein Teil des Feldwerts bekannt ist. Die Suchmaschine gleicht Suchanfragen-Tokens mit Tokens im Feldwert ab, unabhängig von ihrer Reihenfolge. Wenn Sie ein Feld als teilweise abgleichbar markieren, erhöht sich die Größe des Suchindex. Sie können maximal 10 Felder als teilweise übereinstimmend festlegen.

Sie möchten nach Regionen in Europa filtern. Die region-Namen enthalten Central Europe und Eastern Europe. Wenn Ihr Filter region: ANY("Europe") ist, erhalten Sie keine Übereinstimmungen. Wenn das Feld region jedoch als teilweise übereinstimmend festgelegt ist, können Sie mit region: CONTAINS("Europe") filtern und Übereinstimmungen für Central Europe und Eastern Europe erhalten.

Kompatibel mit der Suche während der Eingabe
(Vorschau)

Kennzeichnet ein Textfeld als für die Funktion „Suchen während der Eingabe“ verwendbar: Während der Nutzer tippt, werden Dokumente zurückgegeben, wenn der Feldwert ein Token enthält, das mit dem Abfragetext beginnt. Die Ergebnismenge wird bei jedem Tastendruck neu sortiert.

Nur Felder vom Typ String oder String Array können als kompatibel mit der Funktion „Suche während der Eingabe“ festgelegt werden. Sie können pro Schema nicht mehr als drei Felder als kompatibel mit der Funktion „Suchen während der Eingabe“ festlegen.

Weitere Informationen finden Sie unten im Abschnitt Felder für die Suche während der Eingabe verfügbar machen.

Wenn Sie ein Feld auf saytCompatible setzen, erhalten Nutzer bei jedem Tastendruck eine aktualisierte Gruppe von Dokumenten, bevor sie eine vollständige Abfrage eingegeben haben. Wenden Sie diese Einstellung an, wenn Sie erwarten, dass Nutzer während der Eingabe eine sich aktualisierende Ergebnisliste durchsuchen, z. B. bei Katalogabfragen oder Longtail-Navigation, bei denen der Nutzer das richtige Ergebnis während der Abfrage erkennt, anstatt es vollständig einzugeben. Dies unterscheidet sich von der automatischen Vervollständigung, bei der Abfragestrings vorgeschlagen werden. Bei der Suche während der Eingabe werden sortierte Dokumente zurückgegeben, die der unvollständigen Abfrage entsprechen.

In einem Datenspeicher für Filme legen Sie das Feld title als saytCompatible fest. Wenn ein Nutzer b eingibt, enthalten die Suchergebnisse dynamisch Batman Begins, Batman Returns und Bats, die nach der Suchanfrage des Nutzers sortiert sind. Wenn der Nutzer die Abfrage auf bat erweitert, bleiben dieselben drei Dokumente in der Ergebnismenge, werden aber für das längere Präfix neu sortiert. Wenn die Abfrage auf batm erweitert wird, wird Bats entfernt, da das erste Token des Titels nicht mit batm beginnt. Es bleiben also nur Batman Begins und Batman Returns übrig, die noch einmal neu eingestuft werden.

Als dynamisches Attribut verwendbar Bietet kontextsensitive 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 setzen, können Nutzer Suchergebnisse dynamisch verfeinern, indem sie Kategorien oder Attribute auswählen, die direkt aus Ihren aufgenommenen Daten abgeleitet werden, ohne dass jede mögliche Filteroption manuell vordefiniert werden muss. So können Nutzer ihre Suche auf sehr spezifische Webinhalte eingrenzen.
Verwenden Sie Dynamisch facettierbar mit Suchbar, um bessere Ergebnisse zu erzielen. Dadurch werden sowohl die Trefferquote Ihrer Suche als auch die Qualität der Facetten verbessert, die dem Nutzer angeboten werden.
Seiten in einer internen Unternehmenswissensdatenbank, z. B. Personalrichtlinien, werden mit Daten wie department, document_type oder last_modified_date aufgenommen. Wenn diese Felder als dynamic facetable getaggt sind, werden bei einer Mitarbeitersuche nach einem Begriff wie Kostenerstattung dynamisch interaktive Filter basierend auf den relevanten Ergebnissen generiert. In diesem Fall könnte die Weboberfläche Facetten für Abteilung: Finanzen, Reisen, Dokumenttyp: Richtlinie, FAQ oder Datum der letzten Änderung: Dieses Quartal, Letztes Jahr anzeigen.
Abrufbar Wenn eine Suchanfrage auf übereinstimmende Inhalte trifft, kann die Suchmaschine die Werte der abrufbaren Felder abrufen, um sie anzuzeigen oder in der Anwendung zu verwenden. Das bedeutet, dass Informationen aus dem Originaldokument als Teil der Suchergebnisse angezeigt werden. Schlüsselfelder (eindeutige Kennungen für Dokumente) sind als abrufbar eingerichtet. Abrufbare Felder bieten Suchkontext, indem sie Felder, deren Werte angezeigt werden können, von Feldern unterscheiden, die nur in der Suchlogik verwendet werden sollen, deren Rohwerte aber nicht für den Nutzer bestimmt sind. Bei einer Produktsuche auf einer Händlerwebsite sind product_id, name, price und image_url typische Felder, die Sie als abrufbar festlegen sollten. Andererseits kann die internal_tracking_code nur für administrative Zwecke indexiert und gefiltert werden, ist aber nicht in öffentlichen Suchergebnissen abrufbar.
Vervollständigbar Ermöglicht die Verwendung des Inhalts eines Felds für Vorschläge für Suchanfragen. 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 Echtzeit-Suchvorschläge zu machen. 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 diese Leistung auswirken.

Wenn das Feld completable für product_name, brand und category festgelegt ist und der Nutzer Tech eingibt, können die automatisch vervollständigten Vorschläge Folgendes enthalten:
  • TechCo (aus dem Feld brand)
  • TechCo UltraBook X1 (aus dem Feld product_name)
  • Technologie GameMaster Pro (ein weiteres Produkt aus dem Feld category)
Filterbar Ermöglicht es, Empfehlungen anhand eines Feldes zu filtern, um festzulegen, welche Suchergebnisse Ihre Nutzer sehen. Informationen zum Filtern von Empfehlungen finden Sie unter Empfehlungen filtern. Wenn Sie ein Feld auf Filterable setzen, können Sie Empfehlungen für Nutzer personalisieren. Beachten Sie, dass Filterlimits 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 Stellt Feldinhalte für die Suchmaschine bereit Ermöglicht Volltextabfragen für Feldinhalte Ermöglicht die Rückgabe des Feldwerts in Suchergebnissen
Analyse Inhalte werden verarbeitet und in einen Index aufgenommen. Wird in der Regel einer umfangreichen lexikalischen Analyse unterzogen. Der Wert wird für die Anzeige unverändert gespeichert.
Kann es sein, dass…
… suchbar? Ja (oft eine Voraussetzung) – Nicht unbedingt (kann abrufbar sein, ohne suchbar zu sein)
… abrufbar? Nicht unbedingt Nicht unbedingt –
… filterbar/sortierbar/als Attribut verwendbar? Ja (im Allgemeinen auch eine Voraussetzung für diese) Nicht direkt. Es handelt sich um 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 Nutzerfreundlichkeit entscheidend sind (z. B. Titel, Beschreibungen und personenidentifizierbare Informationen), oft auf indexable, searchable und retrievable gesetzt.

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 Einstellung für die Indexierbarkeit ändern, müssen die Daten neu indexiert werden. Dies kann insbesondere bei großen Datenspeichern Stunden dauern.

Wenn Sie Felder für eine Mediensuch-App konfigurieren und detaillierte Informationen zu den Feldern im Schema benötigen, lesen Sie den Hilfeartikel Informationen zu Mediendokumenten und Datenspeichern.

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 einfache 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 durchsuchbar markieren, können Sie eine Gewichtung angeben, um die 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 Situationen kann es jedoch erforderlich sein, die Gewichtungen anzupassen, z. B.:

  • Sie migrieren Daten von einer vorhandenen Suchplattform, die bereits gewichtete Felder verwendet.

  • Wenn die Standardgewichtungen keine zufriedenstellenden Suchergebnisse liefern. Das kann insbesondere dann passieren, wenn Sie viele durchsuchbare Felder haben und einige davon 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, wird die gewünschte Wirkung erzielt.

Gewichtsstufen

Die Gewichtungen sind in folgende Stufen unterteilt:

Wichtigkeit des Felds Erklärung
Sehr niedrig Ein niedriger Wert, der vom System beim Kombinieren der Punktzahlen aus allen Feldern berücksichtigt wird. Wenn Sie die Gewichtung noch weiter verringern möchten, sodass der Effekt vernachlässigbar ist, markieren Sie das Feld nicht als durchsuchbar.
Niedrig Eine Gewichtung, die niedriger als die Standardgewichtung ist.
Default Die Standardgewichtung für suchbare Felder. Diese Gewichtung bietet in den meisten Fällen eine relativ gute Leistung.
Hoch Eine Gewichtung, die deutlich über dem Standardwert liegt.
Sehr hoch Ein dominierendes Gewicht. In der Regel reservieren Sie dies für höchstens ein Feld.

Schemaaktualisierung und Neuindexierung

Wenn Sie durchsuchbaren Feldern Gewichtungen hinzufügen möchten, müssen Sie das Schema aktualisieren und die Daten im Datenspeicher anschließend neu indexieren. Die Aktualisierung des Schemas dauert Stunden und es gibt keinen zuverlässigen Indikator, der 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 danach sorgfältig auf unbeabsichtigte Folgen prüfen sollten. Nach jeder Änderung müssen Sie warten, bis die Neuindexierung abgeschlossen ist, bevor Sie die Auswirkungen der Änderung bewerten können.

Die Gewichtung von Suchfeldern kann nur über die API konfiguriert werden. 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-Methode projects.locations.dataStores.schemas.patch aktualisieren.

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

  2. Folgen Sie der Anleitung, um das Schema programmatisch zu aktualisieren. Fügen Sie einem oder mehreren durchsuchbaren Suchfeldern Gewichtungen hinzu, wie in den folgenden Beispielen:

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

    In diesem Beispiel wird das Feld summary auf eine höhere Gewichtung als normal und das Feld uri auf 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 Parameter „weight“:

    • very_low
    • low
    • default
    • high
    • very_high
  3. Warten Sie, bis die Neuindexierung abgeschlossen ist, und testen Sie das Suchverhalten.

Felder für Präfix- und Teilübereinstimmungen verfügbar machen (Vorabversion)

Bei Feldern vom Typ string können Sie das Schema so bearbeiten, dass die Felder für den Präfixabgleich oder den Teilabgleich verfügbar sind. So können Sie STARTS_WITH oder CONTAINS in Filterausdrücken verwenden.

Schemaaktualisierung und Neuindexierung

Damit Felder für Präfix- oder Teilübereinstimmungen verfügbar sind, ist eine Schemaaktualisierung und eine anschließende Neuindexierung der Daten im Datenspeicher erforderlich. Das Aktualisieren des Schemas dauert Stunden und es gibt keinen zuverlässigen Indikator, der Ihnen mitteilt, wann die Indexierung abgeschlossen ist. Sie müssen die Indexierungszeit also überschätzen.

Schema für Präfix- und Teilübereinstimmungen aktualisieren

Wenn Sie Felder für den Präfixabgleich oder den Teilabgleich verfügbar machen möchten, müssen Sie das Schema für den Datenspeicher über die API-Methode projects.locations.dataStores.schemas.patch aktualisieren.

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

  2. Folgen Sie der Anleitung, um das Schema programmatisch zu aktualisieren. Legen Sie die abgleichbaren Parameter im Schema auf true fest, wie in diesen Beispielen:

    "zone": {
       "type": "string",
       "searchable": true,
       "prefixMatchable": true
     },
     "region": {
       "type": "string",
       "searchable": true,
       "partialMatchable": true
     },
     "model": {
       "type": "string",
       "searchable": true,
       "prefixMatchable": true,
       "partialMatchable": true
     },
    

    In diesem Beispiel ist das Feld zone so festgelegt, dass es mit Präfixen abgeglichen werden kann. Im Filterausdruck können bis zu 12 Zeichen verwendet werden, um den Feldwert abzugleichen. Die Groß-/Kleinschreibung wird nicht berücksichtigt. Das Feld region ist so eingestellt, dass es teilweise abgeglichen werden kann.

  3. Warten Sie, bis die Neuindexierung abgeschlossen ist.

Details zum Präfixabgleich

Mit dem Präfixabgleich in der Agentensuche können Sie Ergebnisse danach filtern, ob der Wert eines Felds mit einem bestimmten String beginnt. Diese Funktion wird durch den Operator STARTS_WITH unterstützt und erfordert, dass das Zieltextfeld im Schema als prefixMatchable konfiguriert ist.

Normalisierungs- und Abgleichslogik

Um die Leistung zu optimieren und Konsistenz zu gewährleisten, wendet das System einen bestimmten Normalisierungsprozess sowohl auf den Feldwert (während der Indexierung) als auch auf den Abfragestring (während der Suche) an.

  1. Kleinbuchstaben: Alle Zeichen werden in Kleinbuchstaben umgewandelt. Dadurch wird die Groß-/Kleinschreibung beim Abgleich nicht berücksichtigt.

  2. Kürzung auf 12 Zeichen: Das System berücksichtigt nur die ersten 12 Zeichen des Strings. Alle Zeichen, die dieses Limit überschreiten, werden für den Präfixabgleich ignoriert.

Funktionsweise

Bei der Indexierung generiert das System für ein als prefixMatchable markiertes Feld Präfixtokens für die ersten 12 Zeichen. Für einen Wert wie asia-south1-c speichert der Index Tokens für a, as, asi, asia, asia- usw. bis zum 12. Zeichen (asia-south1-).

Bei der Abfrage wird der String, der für den Operator STARTS_WITH angegeben wird, ebenfalls in Kleinbuchstaben umgewandelt und auf 12 Zeichen gekürzt. Die Abfrage wird dann mit den gespeicherten Präfix-Tokens abgeglichen.

Beispiele

Die folgenden Beispiele zeigen, wie sich die 12-stellige Normalisierung auf die Suchergebnisse auswirkt:

  • Weitgehend passend: STARTS_WITH("A") stimmt mit jedem Wert überein, der mit „a“ beginnt (Groß-/Kleinschreibung wird nicht berücksichtigt), z. B. asia, australia oder africa.

  • Teilpräfixe: STARTS_WITH("asia-south") stimmt sowohl mit asia-south1-a als auch mit asia-southeast1-b überein, da beide mit dem angegebenen 10-stelligen String beginnen.

  • Kürzungsverhalten: Da nur die ersten 12 Zeichen abgeglichen werden, stimmt STARTS_WITH("asia-south1-a") mit dem Feldwert asia-south1-c überein. Das liegt daran, dass beide Strings auf dasselbe Präfix mit 12 Zeichen normalisiert werden: asia-south1-.

Details zum teilweisen Abgleich

Mit der Teilübereinstimmung in der Agentensuche können Sie Ergebnisse danach filtern, ob der Wert eines Felds bestimmte Wörter oder Tokens enthält. Diese Funktion wird vom Operator CONTAINS unterstützt und erfordert, dass das Zieltextfeld im Schema als partialMatchable konfiguriert ist.

Normalisierungs- und Tokenisierungslogik

Bei der Agentensuche werden sowohl der Feldwert (während der Indexierung) als auch der Abfragestring (während der Suche) normalisiert und tokenisiert:

  • Kleinschreibung: Agent Search wandelt die Zeichen in Kleinbuchstaben um. Dadurch wird die Groß-/Kleinschreibung beim Abgleich nicht berücksichtigt.

  • Tokenisierung: Die Agentensuche teilt den String mithilfe von Leerzeichen und anderen Zeichen als Trennzeichen in einzelne Tokens (Wörter) auf.

    • Standard-Trennzeichen: Leerzeichen und gängige Satzzeichen dienen als Trennzeichen. Dazu gehören Bindestriche (-), Schrägstriche (/), Kommas (,), Punkte (.), Sternchen (*), geschweifte Klammern ({ }), eckige Klammern ([ ]), runde Klammern (( )) und Apostrophe (').

    • Keine Trennzeichen: Das kaufmännische Und-Zeichen (&) und der Unterstrich (_) dienen nicht als Trennzeichen. Das System behandelt Zeichen, die durch diese Symbole verbunden sind, als ein einzelnes Token.

    • E-Mail-Trennzeichen (@): Das Symbol @ dient als spezielles Trennzeichen, um E-Mail-Adressen zu erkennen. Das System generiert Tokens für die einzelnen Komponenten sowie für kombinierte Formen. Beispiel: support+tier1@example.com wird in support, tier1, example, com, support+tier1@example.com und support@example.com tokenisiert.

Funktionsweise

Bei der Indexierung normalisiert und tokenisiert das System den Feldwert für ein als partialMatchable markiertes Feld und speichert die resultierenden Tokens im Index. Beispielsweise wird der Feldwert 25-meter, outdoor, swimming pool in [25, meter, outdoor, swimming, pool] tokenisiert.

Bei der Abfrage wird der String, der für den Operator CONTAINS bereitgestellt wird, demselben Normalisierungs- und Tokenisierungsprozess unterzogen. Die Suchmaschine prüft dann, ob alle resultierenden Abfragetokens mit den gespeicherten Tokens für das Feld übereinstimmen. Die Reihenfolge der Tokens hat keine Auswirkungen.

Beispiele

Die folgenden Beispiele zeigen, wie sich die Tokenisierung auf die Ergebnisse von Teilübereinstimmungen auswirkt:

  • Einfacher Tokenabgleich: Wenn der Feldwert 25-meter, outdoor, swimming pool ist, stimmt ein Filter von CONTAINS("Outdoor pool") überein. Das System tokenisiert die Abfrage zu [outdoor, pool], die beide in den Tokens des Felds vorhanden sind.

  • Unabhängigkeit von der Reihenfolge: Der Filter CONTAINS("pool outdoor") stimmt auch mit dem Feldwert 25-meter, outdoor, swimming pool überein, da das System das Vorhandensein jedes Tokens unabhängig von seiner Reihenfolge prüft.

  • E-Mail-Adressen-Abgleich: Wenn in einem Feld die E-Mail-Adresse support+tier1@example.com gespeichert ist, werden Filter wie CONTAINS("support"), CONTAINS("example.com") oder CONTAINS("support@example.com") aufgrund der speziellen Tokenisierung des Symbols @ erfolgreich abgeglichen.

Felder für die Suche während der Eingabe verfügbar machen (Vorabversion)

Bei Feldern vom Typ string können Sie das Schema bearbeiten, um die Felder als saytCompatible zu markieren. Wenn ein oder mehrere Felder im Schema saytCompatible sind und Ihre Anwendung die Suche während der Eingabe in der Suchanfrage aktiviert, gibt die Agentensuche Dokumente zurück, deren saytCompatible-Felder ein Token enthalten, das mit dem Abfragetext beginnt. Diese Dokumente werden bei jedem Tastendruck neu eingestuft.

Suche während der Eingabe für Medien

Die Suche während der Eingabe ist eine allgemein verfügbare Funktion für Medien-Apps. Informationen zum reinen Medienfeld searchAsYouTypeSpec.condition finden Sie unter Suchergebnisse für eine Medien-App abrufen.

Mit der Feldeinstellung saytCompatible wird die Funktion „Suche während der Eingabe“ auf alle Suchanwendungen ausgeweitet. Sie können damit die spezifischen Schemafelder markieren, die für die Beantwortung von Teilabfragen verwendet werden sollen. Medien-Apps können searchAsYouTypeSpec.condition wie bisher verwenden. Für Nicht-Medien-Apps sind saytCompatible-Felder im Schema erforderlich.

Automatische Vervollständigung und Suche während der Eingabe

Die Suche während der Eingabe unterscheidet sich von der automatischen Vervollständigung:

  • Die automatische Vervollständigung sagt Abfragestrings vorher und wird durch die Feldeinstellung completable gesteuert.
  • Search-as-you-type gibt sortierte Dokumente zurück und wird durch die Feldeinstellung saytCompatible gesteuert.

Die beiden Funktionen können unabhängig voneinander oder zusammen verwendet werden und es werden keine Daten zwischen ihnen ausgetauscht.

Limits

Für das Festlegen von Feldern als saytCompatible gelten die folgenden Limits:

  • Sie können pro Schema maximal drei Felder als saytCompatible markieren. Wenn Sie ein viertes Feld festlegen, gibt die API beim Patchen des Schemas den Fehler INVALID_ARGUMENT zurück.
  • saytCompatible ist nur für Felder vom Typ string gültig. Wenn Sie es für die Felder number, integer, boolean, object oder datetime festlegen, gibt die API den Fehler INVALID_ARGUMENT zurück.
  • Nur die ersten 12 Tokens des Werts eines Felds werden indexiert. Jedes Token trägt Präfixfragmente bis zu den ersten 10 Zeichen bei. Längere Werte werden zwar indexiert, aber der Schlussteil ist nicht über ein Präfix erreichbar.

Schemaaktualisierung und Neuindexierung

Wenn Sie Felder als saytCompatible festlegen, ist eine Schemaaktualisierung und eine anschließende Neuindexierung der Daten im Datenspeicher erforderlich. Das Aktualisieren des Schemas dauert Stunden und es gibt keinen zuverlässigen Indikator, der Ihnen mitteilt, wann die Indexierung abgeschlossen ist. Sie müssen die Indexierungszeit also überschätzen.

Schema für die Suche während der Eingabe aktualisieren

So markieren Sie Felder mit der Methode projects.locations.dataStores.schemas.patch als saytCompatible:

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

  2. Folgen Sie der Anleitung, um das Schema programmatisch zu aktualisieren. Legen Sie für die Felder, die Sie für das Feature aktivieren möchten, saytCompatible auf true fest, wie in diesem Beispiel:

    "title": {
       "type": "string",
       "retrievable": true,
       "saytCompatible": true
     },
     "channel_name": {
       "type": "string",
       "retrievable": true,
       "saytCompatible": true
     },
    

    In diesem Beispiel sind sowohl das Feld title als auch das Feld channel_name als saytCompatible gekennzeichnet. Wenn Sie saytCompatible für ein Feld festlegen, dessen Typ nicht string ist, gibt die API den Fehler INVALID_ARGUMENT zurück. Das Gleiche gilt , wenn Sie für mehr als drei Felder im Schema festlegen.

  3. Warten Sie, bis die Neuindexierung abgeschlossen ist.

Suchanfrage für die Suche während der Eingabe senden

Nachdem die Neuindexierung abgeschlossen ist, können Sie die Suche während der Eingabe für jede Suchanfrage aktivieren. Senden Sie dazu eine Suchanfrage, deren Text searchAsYouTypeSpec enthält. Felder, die im Schema als saytCompatible gekennzeichnet sind, werden nur berücksichtigt, wenn searchAsYouTypeSpec in der Anfrage festgelegt ist. Sie können also dieselbe Bereitstellungskonfiguration für Teil- und vollständige Abfragen verwenden.

So senden Sie eine Suchanfrage für die Suche während der Eingabe:

  1. Rufen Sie die Suchmethode für Ihre Bereitstellungskonfiguration auf, wie unter Suchergebnisse abrufen beschrieben.

  2. Legen Sie im Anfragetext für searchAsYouTypeSpec.condition den Wert ENABLED fest. Dadurch wird die Suche während der Eingabe für die Anfrage aktiviert.

  3. Optional: Schränken Sie im selben searchAsYouTypeSpec die Suche während der Eingabe auf eine Teilmenge der saytCompatible-Felder des Schemas ein, weisen Sie jedem Feld eine relative Gewichtung zu und legen Sie einen Mindestpunktwert fest, unter dem Dokumente verworfen werden. Alle Werte in diesem Block sind optional. Wenn sie weggelassen werden, gelten die Standardwerte.

    • fields[i].key: Ein Schemafeld, das mit saytCompatible gekennzeichnet ist. Wenn Sie auf ein Feld verweisen, das nicht saytCompatible ist, wird kein Beitrag zur Direktsuche von diesem Feld zurückgegeben.
    • fields[i].weight: relative Bedeutung des Felds im Score für die Suche während der Eingabe. Die Standardeinstellung ist 1.0.
    • scoreThreshold: Dokumente, deren „Search-as-you-type“-Wert unter diesem Wert liegt, werden ausgeschlossen. Standardmäßig ist kein Grenzwert festgelegt.
  4. Senden Sie die Anfrage. Das folgende Beispiel zeigt die Form einer searchAsYouTypeSpec, die die Suche während der Eingabe ermöglicht, sie auf zwei Felder mit unterschiedlichen Gewichtungen beschränkt und eine Mindestpunktzahl festlegt:

    "searchAsYouTypeSpec": {
      "condition": "ENABLED",
      "fields": [
        { "key": "title", "weight": 1.2 },
        { "key": "channel_name" }
      ],
      "scoreThreshold": 0.5
    }
    

Details zur Suche während der Eingabe

Mit der Funktion „Search-as-you-type“ in der Agentensuche können Nutzer bei jedem Tastendruck Dokumente erhalten, die nach Feldern sortiert sind, die im Schema als saytCompatible gekennzeichnet sind.

Normalisierungs- und Tokenisierungslogik

Die Agentensuche normalisiert und tokenisiert sowohl den Feldwert (während der Indexierung) als auch den Abfragetext (während der Suche):

  • Kleinschreibung: Agent Search wandelt die Zeichen in Kleinbuchstaben um. Dadurch wird die Groß-/Kleinschreibung beim Abgleich nicht berücksichtigt.

  • Tokenisierung: Die Agentensuche teilt den String mithilfe von Leerzeichen und gängigen Satzzeichen als Trennzeichen in einzelne Tokens (Wörter) auf. Das entspricht dem Verhalten bei der Teilübereinstimmung.

  • Feldgrenzen: Nur die ersten 12 Tokens des Feldwerts werden für die Suche während der Eingabe indexiert. Jedes dieser Tokens trägt Präfixfragmente bis zu den ersten 10 Zeichen bei.

Beispiel

Wenn das Feld actor_name mit saytCompatible markiert ist und ein Dokument den Wert Christian Bale hat, erreicht eine Abfrage von chr das Dokument über das Präfixfragment der Länge 3 des Tokens christian. Wenn die Abfrage auf chris erweitert wird, wird sie weiterhin über das Präfixfragment der Länge 5 abgeglichen. Eine Abfrage von bale stimmt ebenfalls überein, und zwar über das Präfixfragment der Länge 4 des zweiten Tokens im Feldwert. Die Ranking-Updates werden bei jedem Tastendruck des Nutzers vorgenommen.

Nächste Schritte