Hinzufügen der Rechtschreibprüfung zu Abfragen in Azure KI-Suche (Vorschau)

Sie können die Treffergenauigkeit verbessern, indem Sie die Rechtschreibung von Wörtern in einer Abfrage korrigieren, bevor sie die Suchmaschine erreicht. Der speller Parameter (Vorschau) wird für alle Textabfragetypen (nicht Vektor) unterstützt und ist über das Azure Portal, Vorschau-REST-APIs und Betaversionen von Azure SDK-Bibliotheken verfügbar.

Voraussetzungen

• Ein Suchdienst auf der Ebene "Einfach" oder höher in einer beliebigen Region.

• Ein vorhandener Suchindex mit Inhalt in einer unterstützten Sprache.

• Eine Abfrageanforderung, bei der speller=lexicon und queryLanguage auf eine unterstützte Sprache festgelegt sind. Die Rechtschreibprüfung funktioniert bei Zeichenfolgen, die im Parameter search übergeben werden. Es wird für Filter, Fuzzy-Suche, Wildcardsuche, reguläre Ausdrücke oder Vektorabfragen nicht unterstützt.

Verwenden Sie einen Suchclient, der Vorschau-APIs für die Abfrageanforderung unterstützt. Sie können einen REST-Client oder Betaversionen der Azure SDKs verwenden.

Rechtschreibkorrektur mit einfacher Suche

Im folgenden Beispiel wird der Hotels-Beispielindex verwendet, um die Rechtschreibkorrektur für eine einfache Textabfrage zu veranschaulichen. Ohne Rechtschreibkorrektur gibt die Abfrage null Ergebnisse zurück. Mit der Korrektur gibt die Abfrage ein Ergebnis für Johnsons familienorientiertes Resort zurück.

POST https://[service name].search.windows.net/indexes/hotels-sample/docs/search?api-version=2026-08-01-preview
{
    "search": "famly acitvites",
    "speller": "lexicon",
    "queryLanguage": "en-us",
    "queryType": "simple",
    "select": "HotelId,HotelName,Description,Category,Tags",
    "count": true
}

Rechtschreibkorrektur mit voller Lucene

Die Rechtschreibkorrektur erfolgt in einzelnen Abfragebegriffen, die einer Textanalyse unterzogen werden, weshalb Sie den Rechtschreibparameter für einige Lucene-Abfragen verwenden können, andere jedoch nicht.

• Inkompatible Abfrageformulare, die die Textanalyse umgehen, umfassen: Wildcard, regex, fuzzy
• Kompatible Abfrageformulare umfassen: Feldbasierte Suche, Näherungssuche, Begriffsgewichtung

In diesem Beispiel wird eine Feldsuche über das Feld "Kategorie" mit der vollständigen Lucene-Syntax und einem falsch geschriebenen Abfragebegriff angewendet. Durch die Einbeziehung der Rechtschreibprüfung wird der Tippfehler in „Suiite“ korrigiert, und die Abfrage ist erfolgreich.

POST https://[service name].search.windows.net/indexes/hotels-sample/docs/search?api-version=2026-08-01-preview
{
    "search": "Category:(Resort and Spa) OR Category:Suiite",
    "queryType": "full",
    "speller": "lexicon",
    "queryLanguage": "en-us",
    "select": "Category",
    "count": true
}

Rechtschreibkorrektur mit semantischer Rangfolge

Bei dieser Abfrage mit Tippfehlern in jedem Suchbegriff mit Ausnahme eines Suchbegriffs werden Rechtschreibkorrekturen vorgenommen, um relevante Ergebnisse zu liefern. Weitere Informationen finden Sie unter Konfigurieren des semantischen Rangierers.

POST https://[service name].search.windows.net/indexes/hotels-sample/docs/search?api-version=2026-08-01-preview
{
    "search": "hisotoric hotell wiht great restrant nad wiifi",
    "queryType": "semantic",
    "speller": "lexicon",
    "queryLanguage": "en-us",
    "searchFields": "HotelName,Tags,Description",
    "select": "HotelId,HotelName,Description,Category,Tags",
    "count": true
}

Unterstützte Sprachen

Gültige Werte für queryLanguage finden Sie in der folgenden Tabelle, die aus der Liste der unterstützten Sprachen (REST-API-Referenz) kopiert wurde.

Überlegungen zur Sprachanalyse

Indizes, die nicht englische Inhalte enthalten, verwenden häufig Sprachanalysatoren in nicht englischen Feldern, um die sprachlichen Regeln der Muttersprache anzuwenden.

Beim Hinzufügen der Rechtschreibprüfung zu Inhalten, die auch einer Sprachanalyse unterzogen werden, können Sie bessere Ergebnisse erzielen, indem Sie für jeden Indizierungs- und Abfrageverarbeitungsschritt dieselbe Sprache verwenden. Wenn zum Beispiel der Inhalt eines Felds mit dem Sprachanalysetool "fr.microsoft" indiziert wurde, dann sollten Abfragen und die Rechtschreibprüfung alle ein französisches Lexikon oder eine Sprachbibliothek in irgendeiner Form verwenden.

So stellen Sie fest, wie Sprachbibliotheken in Azure KI-Suche verwendet werden:

• Sprachanalysatoren können während der Indizierung und Abfrageausführung aufgerufen werden und sind Apache Lucene (z. B. "de.lucene") oder Microsoft ("de.microsoft").

• Sprachverzeichnisse, die während der Rechtschreibprüfung aufgerufen werden, werden mithilfe eines der Sprachcodes in der unterstützten Sprachtabelle angegeben.

In einer Abfrageanforderung gilt der zugewiesene queryLanguage Wert für speller.

Während Inhalte in einem Suchindex in mehreren Sprachen verfasst werden können, ist die Abfrageeingabe höchstwahrscheinlich in einem. Die Suchmaschine überprüft nicht auf Kompatibilität von queryLanguage, Sprachanalyse und die Sprache, in der Inhalte verfasst werden. Achten Sie daher darauf, Abfragen entsprechend zu beschränken, um falsche Ergebnisse zu vermeiden.

Nächste Schritte

• Erstellen einer einfachen Abfrage
• Vollständige Lucene-Abfragesyntax verwenden
• Verwenden einer einfachen Abfragesyntax