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 |
Wenn Sie ein Feld als Wenn Sie ein Feld als |
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 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 |
| Präfix-abgleichbar (Vorschau) |
Ermöglicht den Präfixabgleich von Textfeldern mit dem Operator 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 |
| Teilweise abgleichbar (Vorschau) |
Ermöglicht den Teilstring-Abgleich für Textfelder mit dem Operator 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 |
| 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 Weitere Informationen finden Sie unten im Abschnitt Felder für die Suche während der Eingabe verfügbar machen. |
Wenn Sie ein Feld auf |
In einem Datenspeicher für Filme legen Sie das Feld |
| 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:
|
| 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:
Rufen Sie in der Google Cloud Console die Seite KI-Anwendungen auf.
Klicken Sie auf den Namen der App, die Sie bearbeiten möchten.
Klicken Sie auf Daten.
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.
Klicken Sie auf Bearbeiten.
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.
Klicken Sie auf Speichern, um die Änderungen zu übernehmen.
Durchsuchbare Felder gewichten (Vorabversion)
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.
Wenn Sie noch kein Schema haben, folgen Sie der Anleitung unter Schemadefinition ansehen, um Ihr Schema abzurufen.
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
summaryauf eine höhere Gewichtung als normal und das Felduriauf eine niedrigere Gewichtung festgelegt. Wenn Sie eine Gewichtung auf den Standardwert zurücksetzen möchten, legen Sie sie aufdefaultfest.Zulässige Werte für den Parameter „weight“:
very_lowlowdefaulthighvery_high
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.
Wenn Sie noch kein Schema haben, folgen Sie der Anleitung unter Schemadefinition ansehen, um Ihr Schema abzurufen.
Folgen Sie der Anleitung, um das Schema programmatisch zu aktualisieren. Legen Sie die abgleichbaren Parameter im Schema auf
truefest, 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
zoneso 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 Feldregionist so eingestellt, dass es teilweise abgeglichen werden kann.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.
Kleinbuchstaben: Alle Zeichen werden in Kleinbuchstaben umgewandelt. Dadurch wird die Groß-/Kleinschreibung beim Abgleich nicht berücksichtigt.
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,australiaoderafrica.Teilpräfixe:
STARTS_WITH("asia-south")stimmt sowohl mitasia-south1-aals auch mitasia-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 Feldwertasia-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.comwird insupport,tier1,example,com,support+tier1@example.comundsupport@example.comtokenisiert.
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 poolist, stimmt ein Filter vonCONTAINS("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 Feldwert25-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.comgespeichert ist, werden Filter wieCONTAINS("support"),CONTAINS("example.com")oderCONTAINS("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
completablegesteuert. - Search-as-you-type gibt sortierte Dokumente zurück und wird durch die Feldeinstellung
saytCompatiblegesteuert.
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
saytCompatiblemarkieren. Wenn Sie ein viertes Feld festlegen, gibt die API beim Patchen des Schemas den FehlerINVALID_ARGUMENTzurück. saytCompatibleist nur für Felder vom Typstringgültig. Wenn Sie es für die Feldernumber,integer,boolean,objectoderdatetimefestlegen, gibt die API den FehlerINVALID_ARGUMENTzurü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:
Wenn Sie noch kein Schema haben, folgen Sie der Anleitung unter Schemadefinition ansehen, um Ihr Schema abzurufen.
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,
saytCompatibleauftruefest, 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
titleals auch das Feldchannel_namealssaytCompatiblegekennzeichnet. Wenn SiesaytCompatiblefür ein Feld festlegen, dessen Typ nichtstringist, gibt die API den FehlerINVALID_ARGUMENTzurück. Das Gleiche gilt , wenn Sie für mehr als drei Felder im Schema festlegen.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:
Rufen Sie die Suchmethode für Ihre Bereitstellungskonfiguration auf, wie unter Suchergebnisse abrufen beschrieben.
Legen Sie im Anfragetext für
searchAsYouTypeSpec.conditionden WertENABLEDfest. Dadurch wird die Suche während der Eingabe für die Anfrage aktiviert.Optional: Schränken Sie im selben
searchAsYouTypeSpecdie Suche während der Eingabe auf eine Teilmenge dersaytCompatible-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 mitsaytCompatiblegekennzeichnet ist. Wenn Sie auf ein Feld verweisen, das nichtsaytCompatibleist, 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 ist1.0.scoreThreshold: Dokumente, deren „Search-as-you-type“-Wert unter diesem Wert liegt, werden ausgeschlossen. Standardmäßig ist kein Grenzwert festgelegt.
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.