Queries uitvoeren in Azure AI Zoeken

Notitie

Azure AI Zoeken is beschikbaar via de Azure-portal, REST API's en Azure-SDK's. Het vormt ook een basis voor Foundry IQ, de beheerde kennislaag die bedrijfsinhoud transformeert in herbruikbare, machtigingsbewuste knowledge bases voor agents in de Microsoft Foundry-portal.

Azure AI Zoeken biedt ondersteuning voor queryconstructies voor een breed scala aan scenario's, van zoeken in vrije tekst tot zeer opgegeven querypatronen, tot vectorzoekopdrachten. Alle query's worden uitgevoerd via een zoekindex waarin doorzoekbare inhoud wordt opgeslagen.

Typen queries

Queryformulier Doorzoekbare inhoud Beschrijving
Zoeken in volledige tekst Omgekeerde indexen van getokenizede termen. Query's in volledige tekst herhalen over omgekeerde indexen die zijn gestructureerd voor snelle scans, waarbij een overeenkomst kan worden gevonden in elk veld, binnen een willekeurig aantal zoekdocumenten. Tekst wordt geanalyseerd en getokeniseerd voor volledige-tekstzoekopdrachten.
Vectorzoekopdracht Vectorindexen van gegenereerde insluitingen. Vectorqueries herhalen over vectorvelden in een zoekindex.
Hybride zoekopdracht Alle bovenstaande in één zoekindex. Combineert tekstzoekopdrachten en vectorzoekopdrachten in één queryaanvraag. Zoeken op tekst werkt met inhoud zonder opmaak in doorzoekbare velden. Filters zijn van toepassing op filterbare velden. Vectorzoekopdrachten werken op vectorvelden.
Agentieve gegevensophaal Alle bovenstaande in één zoekindex. Dit is een alternatief ophaalpad op Azure AI Zoeken dat optioneel gebruikmaakt van grote taalmodellen voor het plannen van query's (preview). Het antwoord is ontworpen voor gebruik door de agent, waarbij de agent, in plaats van de zoekapplicatie-clientcode, het antwoord coördineert dat aan de gebruiker wordt geleverd.
Overige Tekst zonder opmaak en door mensen leesbare inhoud. Ruwe inhoud, geëxtraheerde exacte bewoordingen uit brondocumenten, ondersteunende filters en patroonherkenningsquery's zoals geo-ruimtelijke zoekopdrachten, fuzzy zoekopdrachten en zoeken in velden.

De rest van dit artikel richt zich op de laatste categorie: klassieke query's die werken op platte tekst en menselijk leesbare inhoud, die intact uit de oorspronkelijke bron zijn verkregen, en worden gebruikt voor filters en andere gespecialiseerde queryvormen. Als u een traditionele zoektoepassing maakt die geen ai gebruikt, worden in deze sectie de querymethoden uitgelegd die u in uw clientcode kunt implementeren.

Automatisch aanvullen en voorgestelde queries

Automatisch aanvullen of voorgestelde resultaten zijn alternatieven voor search die opeenvolgende zoekopdrachten starten op basis van gedeeltelijke tekenreeksen (na elk teken) in een zoek-terwijl-u-typt-ervaring. U kunt de parameters en gezamenlijk of afzonderlijk gebruiken, zoals beschreven in , maar u kunt ze niet samen met gebruiken. Zowel voltooide termen als voorgestelde query's zijn afgeleid van de indexinhoud. De zoekmachine retourneert nooit een tekenreeks of suggestie die niet in uw index voorkomt. Zie Automatisch aanvullen (REST API) en Suggesties (REST API) voor meer informatie.

Filters worden veel gebruikt in apps die zijn gebaseerd op Azure AI Zoeken. Op toepassingspagina's worden filters vaak gevisualiseerd als facetten in koppelingsnavigatiestructuren voor door de gebruiker gerichte filters. Filters worden ook intern gebruikt om segmenten van geïndexeerde inhoud beschikbaar te maken. U kunt bijvoorbeeld een zoekpagina initialiseren met behulp van een filter op een productcategorie of een taal als een index velden in zowel het Engels als het Frans bevat.

Mogelijk hebt u filters nodig om een speciaal queryformulier aan te roepen, zoals beschreven in de volgende tabel. U kunt een filter gebruiken met een niet-opgegeven zoekopdracht (search=*) of met een querytekenreeks die termen, woordgroepen, operators en patronen bevat.

Filterscenario Beschrijving
Bereikfilters In Azure AI Zoeken worden bereikquery's gemaakt met behulp van de filter parameter. Zie het voorbeeld van het bereikfilter voor meer informatie en voorbeelden.
Facetnavigatie In de facetnavigatiestructuur kunnen gebruikers facetten selecteren. Wanneer filters worden toegepast, worden de zoekresultaten bij elke klik verfijnd. Elk facet wordt ondersteund door een filter dat documenten uitsluit die niet meer voldoen aan de criteria van het facet.

Notitie

Tekst die in een filterexpressie wordt gebruikt, wordt niet geanalyseerd tijdens het verwerken van query's. De tekstinvoer wordt verondersteld een hoofdlettergevoelig tekenpatroon te zijn dat slaagt of mislukt bij de overeenkomst. Filterexpressies worden samengesteld met behulp van OData-syntaxis en doorgegeven in een filter parameter in alle filterbare velden in uw index. Zie Filters in Azure AI Zoeken voor meer informatie.

Georuimtelijke zoekopdrachten maken gebruik van de breedte- en lengtegraadcoördinaten van een locatie voor het zoeken naar "in de buurt" of een kaartgebaseerde zoekervaring. In Azure AI Zoeken kunt u georuimtelijke zoekopdrachten implementeren door de volgende stappen uit te voeren:

  1. Definieer een filterbaar veld van het type Edm.GeographyPoint of Collection(Edm.GeographyPoint).
  2. Controleer of de binnenkomende documenten de juiste coördinaten bevatten.
  3. Nadat het indexeren is voltooid, maakt u een query die gebruikmaakt van een filter en een georuimtelijke functie.

Georuimtelijke zoekopdracht maakt gebruik van kilometers voor afstand. Coördinaten worden opgegeven in deze indeling: (longitude, latitude).

Hier volgt een voorbeeld van een filter voor georuimtelijke zoekopdrachten. Met dit filter worden andere Location velden gevonden in de zoekindex met coördinaten binnen een radius van 300 kilometer van het geografische punt (in dit voorbeeld Washington D.C.). Het retourneert adresgegevens in het resultaat en bevat een optionele facets component voor zelfnavigatie op basis van locatie.

POST https://{{searchServiceName}}.search.windows.net/indexes/hotels-vector-quickstart/docs/search?api-version=2026-04-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
}

Zie het georuimtelijke zoekvoorbeeld voor meer informatie en voorbeelden.

Document opzoeken

In tegenstelling tot de eerder beschreven queryformulieren haalt deze één zoekdocument op id op, zonder bijbehorende indexzoekopdracht of scan. Er wordt slechts één document aangevraagd en geretourneerd. Wanneer een gebruiker een item in zoekresultaten selecteert, wordt het document opgehaald en een detailpagina met velden ingevuld. Een documentzoekactie is de bewerking die dit ondersteunt.

Geavanceerd zoeken: fuzzy, jokerteken, nabijheid, regex

Een geavanceerd queryformulier is afhankelijk van de full Lucene-parser en operators die een specifiek querygedrag activeren.

Querytype Gebruik Voorbeelden en meer informatie
Gestructureerd zoeken search parameter queryType=full Bouw een samengestelde query-expressie die gericht is op één veld.
Voorbeeld van zoeken in velden
Fuzzy zoekopdracht search parameter queryType=full Koppel termen met een vergelijkbare opbouw of spelling.
Voorbeeld van fuzzy zoekopdracht
Nabijheid zoeken search parameter queryType=full Zoek termen in de buurt van elkaar in een document.
Voorbeeld van nabijheidszoekopdracht
Termverhoging search parameter queryType=full Rangschik een document hoger als het de boosted term bevat, ten opzichte van anderen die dat niet doen.
Voorbeeld van het stimuleren van termen
Zoeken in reguliere expressies search parameter queryType=full Overeenkomen op basis van de inhoud van een reguliere expressie.
Voorbeeld van reguliere expressie
Zoekopdracht met jokertekens of voorvoegsels search parameter met * of ?, queryType=full Overeenkomen op basis van een voorvoegsel, meerdere tekens (*) of één teken (?).
Voorbeeld van zoeken met jokertekens

Volgende stappen

Bekijk de voorbeelden voor elke syntaxis voor een beter overzicht van de implementatie van query's. Als u geen kennis hebt met zoeken in volledige tekst, wilt u mogelijk ook meer weten over wat de query-engine doet.

  • Laatst bijgewerkt om