Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Hinweis
Foundry IQ (Azure KI-Suche) bietet direkte Indizierungs- und Abfrage-APIs zusammen mit Wissensquellen- und Knowledge Base-APIs auf höherer Ebene für den verwalteten Abruf. Verwenden Sie das Azure Portal, REST-APIs oder Azure SDKs, um diese Funktionen zu konfigurieren, oder verbinden Sie Agents mit Wissensdatenbanken im Microsoft Foundry-Portal.
Foundry IQ (Azure KI-Suche) unterstützt Abfragekonstrukte für eine breite Palette von Szenarien, von der Freiformtextsuche bis hin zu stark angegebenen Abfragemustern bis hin zur Vektorsuche. Alle Abfragen werden über einen Suchindex ausgeführt, der suchbare Inhalte speichert.
Abfragetypen
| Abfrageformular | Suchbarer Inhalt | BESCHREIBUNG |
|---|---|---|
| Volltextsuche | Invertierte Indizes von tokenisierten Ausdrücken. | Volltextabfragen durchlaufen die invertierten Indizes, die für schnelle Scans strukturiert sind, wobei eine Übereinstimmung in potenziell jedem Feld innerhalb einer beliebigen Anzahl von Suchdokumenten gefunden werden kann. Text wird für die Volltextsuche analysiert und tokenisiert. |
| Vektorsuche | Vektorindizes von generierten Einbettungen. | Vektorabfragen durchlaufen Vektorfelder in einem Suchindex. |
| Hybridsuche | Alles oben Genannte in einem einzigen Suchindex. | Kombiniert die Textsuche und die Vektorsuche in einer einzigen Abfrageanforderung. Die Textsuche funktioniert bei Nur-Text-Inhalten in durchsuchbaren Feldern. Filter gelten für filterbare Felder. Die Vektorsuche funktioniert für Vektorfelder. |
| Agent-Abruf | Mindestens eine unterstützte Wissensquelle. | Dieser Abrufpfad verwendet optional große Sprachmodelle für die Abfrageplanung. Modellgestützte Planung und Antwortsynthese sind in der REST-API 2026-10-01 allgemein verfügbar; für zusätzliche Funktionen gelten weiterhin die Previewanforderungen. Die Antwort ist zur Verwendung durch Agenten konzipiert. |
| Andere | Nur-Text und für Menschen lesbare Inhalte. | Unformatierter Inhalt, extrahiert aus Quelldokumenten, unterstützende Filter und Musterabgleichungsabfragen wie raumbezogene Suche, Fuzzy-Suche und Feldsuche. |
Im verbleibenden Teil dieses Artikels konzentrieren wir uns auf die letzte Kategorie: klassische Abfragen, die mit unformatiertem Text und menschlich lesbaren Inhalten arbeiten, die aus der ursprünglichen Quelle extrahiert und für Filter und andere spezielle Abfragearten verwendet werden. Wenn Sie eine herkömmliche Suchanwendung erstellen, die keine KI verwendet, werden in diesem Abschnitt die Abfragemethoden erläutert, die Sie in Ihrem Clientcode implementieren können.
AutoVervollständigen und vorgeschlagene Abfragen
Automatische Vervollständigung oder vorgeschlagene Ergebnisse sind Alternativen zu search, die bei einer Suche während der Eingabe auf Grundlage teilweiser Eingaben (nach jedem Zeichen) nacheinander Suchabfragen auslösen. Sie können die Parameter autocomplete und suggestions gemeinsam oder separat verwenden, wie in dieser Anleitung beschrieben. Die Verwendung mit search ist allerdings nicht möglich. Sowohl automatisch vervollständigte Begriffe als auch vorgeschlagene Abfragen werden aus dem Indexinhalt abgeleitet. Das Modul gibt niemals eine Zeichenfolge oder einen Vorschlag zurück, der in Ihrem Index nicht vorhanden ist. Weitere Informationen finden Sie unter AutoVervollständigen (REST-API) und Vorschläge (REST-API).
Filtern der Suche
Filter werden häufig in Apps verwendet, die auf Foundry IQ basieren. Auf Anwendungsseiten werden Filter oft als Facetten in Linknavigationsstrukturen dargestellt, sodass Benutzer die Filterung steuern können. Filter werden auch intern verwendet, um Slices der indizierten Inhalte verfügbar zu machen. Beispielsweise können Sie eine Suchseite mithilfe eines auf eine Produktkategorie festgelegten Filters initialisieren oder einen Sprachfilter verwenden, wenn ein Index Felder sowohl in englischer als auch in französischer Sprache enthält.
Möglicherweise benötigen Sie auch Filter, um ein spezielles Abfrageformular aufzurufen, wie in der folgenden Tabelle beschrieben. Sie können einen Filter mit einer nicht spezifizierten Suche (search=*) oder mit einer Abfragezeichenfolge verwenden, die Begriffe, Ausdrücke, Operatoren und Muster umfasst.
| Filterszenario | BESCHREIBUNG |
|---|---|
| Bereichsfilter | In Foundry IQ werden Bereichsabfragen mithilfe des filter Parameters erstellt. Weitere Informationen und Beispiele finden Sie unter Beispiel: Bereichsfilter. |
| Facettennavigation | In der Facettennavigationsstruktur können Benutzer Facets auswählen. Bei Filterung werden die Suchergebnisse bei jedem Klick eingeengt. Jede Facette wird durch einen Filter unterstützt, der Dokumente ausschließt, die nicht mehr den durch das Facet angegebenen Kriterien entsprechen. |
Hinweis
In einem Filterausdruck verwendeter Text wird während der Abfrageverarbeitung nicht analysiert. Hierbei wird davon ausgegangen, dass es sich bei der Texteingabe um ein wortgetreues Zeichenmuster mit Beachtung der Groß- und Kleinschreibung handelt, das entweder erfolgreich oder nicht erfolgreich mit der Abfrage abgeglichen wird. Filterausdrücke werden mithilfe der OData-Syntax erstellt und in einem filter-Parameter an alle filterbaren Felder in Ihrem Index übergeben. Weitere Informationen finden Sie unter Filters in Foundry IQ.
Geosuche
Die Geosuche gleicht anhand der Breiten- und Längenkoordinaten eines Standorts für „In meiner Nähe suchen“ oder einer kartenbasierte Suchoberfläche ab. In Foundry IQ können Sie geospatiale Suche implementieren, indem Sie die folgenden Schritte ausführen:
- Definieren Sie ein filterbares Feld vom Typ "Edm.GeographyPoint" oder "Collection(Edm.GeographyPoint)".
- Überprüfen Sie, ob die eingehenden Dokumente die entsprechenden Koordinaten enthalten.
- Erstellen Sie nach Abschluss der Indizierung eine Abfrage, die einen Filter und eine Geofunktion verwendet.
Die Geosuche verwendet Kilometer für die Entfernung. Koordinaten werden in diesem Format angegeben: (longitude, latitude).
Hier ist ein Beispiel für einen Filter für die Geosuche. Dieser Filter findet andere Location Felder im Suchindex, die Koordinaten innerhalb eines Radius von 300 Kilometern des geografischen Punkts haben (in diesem Beispiel Washington D.C.). Er gibt Adressinformationen im Ergebnis zurück und enthält eine optionale facets Klausel für die Selbstnavigation basierend auf der Position.
POST https://{{searchServiceName}}.search.windows.net/indexes/hotels-vector-quickstart/docs/search?api-version=2026-10-01
{
"count": true,
"search": "*",
"filter": "geo.distance(Location, geography'POINT(-77.03241 38.90166)') le 300",
"facets": [ "Address/StateProvince"],
"select": "HotelId, HotelName, Address/StreetAddress, Address/City, Address/StateProvince",
"top": 7
}
Weitere Informationen und Beispiele finden Sie unter Beispiel: Geosuche.
Dokumentsuche
Im Gegensatz zu den bisher beschriebenen Abfrageformen wird hier ein einzelnes Suchdokument anhand der ID abgerufen, ohne entsprechende Indexsuche oder -überprüfung. Es wird nur dieses eine Dokument angefordert und zurückgegeben. Wenn ein Benutzer in Suchergebnissen ein Element auswählt, besteht die typische Antwort darin, dass das Dokument abgerufen und die Detailseite mit Feldern aufgefüllt wird. Die Dokumentsuche ist der Vorgang, der diesen Fall unterstützt.
Erweiterte Suche: Fuzzy, Platzhalter, Näherung, regulärer Ausdruck
Ein erweitertes Abfrageformular benötigt die vollständige Version des Lucene-Parsers sowie Operatoren, die ein bestimmtes Abfrageverhalten auslösen.
| Abfragetyp | Verwendung | Beispiele und weitere Informationen |
|---|---|---|
| Feldsuche |
search parameter, queryType=full |
Erstellen Sie einen zusammengesetzten Abfrageausdruck für ein einzelnes Feld. Feldsuche (Beispiel) |
| Fuzzysuche |
search parameter, queryType=full |
Ordnen Sie Begriffe mit ähnlicher Struktur oder Schreibweise zu. Beispiel für eine Fuzzysuche |
| Näherungssuche |
search Parameter, queryType=full |
Suchen Nach Begriffen, die sich in einem Dokument nahe beieinander befinden. Beispiel für die Näherungssuche |
| Boosting von Begriffen |
search parameter, queryType=full |
Stufen Sie ein Dokument höher ein, wenn es den verstärkten Begriff enthält, im Vergleich zu anderen, die ihn nicht enthalten. Beispiel für Term-Boosting |
| Suche nach regulären Ausdrücken |
search parameter, queryType=full |
Abgleich anhand des Inhalts eines regulären Ausdrucks. Beispiel für einen regulären Ausdruck |
| Suchen nach Wildcards oder Präfixen |
search parameter mit * oder ?, queryType=full |
Übereinstimmung basierend auf einem Präfix, mehreren Zeichen (*) oder einem Zeichen (?). Beispiel für die Wildcardsuche |
Nächste Schritte
Genauere Informationen zur Implementierung der Abfrage finden Sie in den Beispielen für die jeweilige Syntax. Wenn Sie mit der Volltextsuche noch nicht fertig sind, möchten Sie möglicherweise auch mehr darüber erfahren, was das Abfragemodul tut.