Hinzufügen der Rechtschreibprüfung zu Abfragen in Azure KI Search

Sie können den Abruf verbessern, indem Sie die Rechtschreibung von Wörtern in einer Abfrage korrigieren, bevor sie an die Suchmaschine übergeben werden. Der speller-Parameter wird für alle Textabfragetypen (keine Vektorabfragen) unterstützt.

Voraussetzungen

• Ein Suchdienst auf der Basic-Dienstebene oder höher in einer beliebigen Region.

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

• Eine Abfrageanforderung, in der speller=lexicon und queryLanguage auf eine unterstützte Sprache festgelegt sind. Die Rechtschreibprüfung funktioniert für Zeichenfolgen, die im search-Parameter übergeben werden. Sie wird nicht für Filter, Fuzzysuche, Platzhaltersuche, reguläre Ausdrücke oder Vektorabfragen 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 integrierte Index „hotels-sample“ verwendet, um die Rechtschreibkorrektur für eine einfachen Textabfrage zu veranschaulichen. Ohne Rechtschreibkorrektur gibt die Abfrage keine Ergebnisse zurück. Bei der Korrektur gibt die Abfrage ein Ergebnis für die familienfreundliche Ferienunterkunft von Johnson zurück.

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

Rechtschreibkorrektur mit Lucene-Abfragen vom Typ „full“ (vollständig)

Die Rechtschreibkorrektur erfolgt für einzelne Abfragebegriffe, die einer Textanalyse unterzogen werden, weshalb Sie den Parameter „speller“ bei einigen Lucene-Abfragen verwenden können, bei anderen jedoch nicht.

• Nicht kompatible Abfrageformulare, die die Textanalyse umgehen, sind: Platzhalter, Regex, Fuzzy
• Kompatible Abfrageformulare umfassen Folgendes: feldbezogene Suche, NEAR-Suche, Term Boosting

In diesem Beispiel wird die feldbezogene Suche über das Feld „Kategorie“ mit vollständiger Lucene-Syntax und einen falsch geschriebenen Abfragebegriff verwendet. 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-index/docs/search?api-version=2024-05-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

Für diese Abfrage, bei der jeder Begriff mit Ausnahme von einem Tippfehler enthält, werden Rechtschreibkorrekturen vorgenommen, um relevante Ergebnisse zurückzugeben. Weitere Informationen finden Sie unter Konfigurieren des semantischen Sortierers.

POST https://[service name].search.windows.net/indexes/hotels-sample-index/docs/search?api-version=2024-05-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 unterstützter Sprachen (REST-API-Referenz) kopiert wurde.

Überlegungen zum Sprachanalysetool

Indizes, die nicht englischsprachige Inhalte enthalten, verwenden häufig Sprachanalysetools für nicht englischsprachige Felder, um die linguistischen Regeln der nativen Sprache anzuwenden.

Wenn Sie Inhalten, die auch einer Sprachanalyse unterzogen werden, eine Rechtschreibprüfung hinzufügen, können Sie bessere Ergebnisse erzielen, wenn Sie dieselbe Sprache für die Indizierung und die Abfrageverarbeitung verwenden. Wenn beispielsweise der Inhalt eines Felds mit dem Sprachanalysetool „fr.microsoft“ indiziert wurde, sollte für Abfragen und die Rechtschreibprüfung ein französisches Lexikon oder eine französische Sprachbibliothek verwendet werden.

Verwendung von Sprachbibliotheken in Azure KI Search:

• Sprachanalysetools können während der Indizierung und Abfrageausführung aufgerufen werden und entsprechen entweder Apache Lucene (z. B. „de.lucene“) oder Microsoft („de.microsoft“).

• Sprachlexika, die während der Rechtschreibprüfung aufgerufen werden, werden mit einem der Sprachcodes in der Tabelle der unterstützten Sprachen angegeben.

In einer Abfrageanforderung gilt der Wert, der queryLanguage zugewiesen ist, für speller.

Inhalt in einem Suchindex kann zwar aus mehreren Sprachen zusammengesetzt sein, die Abfrageeingabe erfolgt jedoch höchstwahrscheinlich nur in einer Sprache. Die Suchmaschine prüft nicht die Kompatibilität von queryLanguage, des Sprachanalysetools und der Sprache, in der der Inhalt verfasst ist. Stellen Sie daher sicher, dass Sie Abfragen entsprechend einschränken, um falsche Ergebnisse zu vermeiden.

Nächste Schritte

• Erstellen einer einfachen Abfrage
• Verwenden der vollständigen Lucene-Abfragesyntax
• Verwenden einfacher Abfragesyntax