Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Dit artikel bevat de huidige en eerdere versies van de Search REST API's voor Azure AI Search.
Api-documenten met versiebeheer
REST API-documenten zijn nu geversied. Wanneer u een API-referentiepagina opent, wordt boven de inhoudsopgave een versiekiezer weergegeven. De selector wordt beschikbaar wanneer u een pagina kiest uit de map Reference > Data Plane .
Stabiele versies
| API-versie | Specificatie | API-updates |
|---|---|---|
2025-09-01 (laatste) |
Swagger-specificatie | releasenotitie |
2024-07-01 |
Swagger-specificatie | releasenotitie |
2023-11-01 |
Swagger-specificatie | releasenotitie |
2020-06-30 |
Swagger-specificatie | releasenotitie |
2019-05-06 |
Swagger-specificatie | Hiermee worden complexe typen toegevoegd. |
Preview-versies
Alle nieuwe functies worden geïntroduceerd in preview-API's voordat ze worden overgezet naar een stabiele versie. Preview-API's zijn beschikbaar onder Aanvullende gebruiksvoorwaarden voor Microsoft Azure Previews.
| API-versie | Specificatie | API-updates |
|---|---|---|
2025-11-01-preview (laatste) |
Swagger-specificatie | releasenotitie |
2025-08-01-preview |
Swagger-specificatie | releasenotitie |
2025-05-01-preview |
Swagger-specificatie | releasenotitie |
2025-03-01-preview |
Swagger-specificatie | releasenotitie |
2024-11-01-preview |
Swagger-specificatie | releasenotitie |
2024-09-01-preview |
Swagger-specificatie | releasenotitie |
2024-05-01-preview |
Swagger-specificatie | releasenotitie |
2024-03-01-preview |
Swagger-specificatie | releasenotitie |
2023-10-01-preview |
Swagger-specificatie | releasenotitie |
2023-07-01-preview (afgeschaft) |
Swagger-specificatie | releasenotitie |
2021-04-30-preview |
Swagger-specificatie | releasenotitie |
2020-06-30-preview |
Swagger-specificatie | releasenotitie |
2019-05-06-preview |
Swagger-specificatie | releasenotitie |
Opmerkingen bij de release
2025-11-01-preview
Deze preview bouwt voort op de 2025-08-01-preview en is inclusief alle functies die momenteel in preview zijn.
Als u de 2025-08-01-preview hebt gebruikt om een kennisagent te maken, waarvan de naam sindsdien is gewijzigd in Knowledge Base, worden in deze preview belangrijke wijzigingen geïntroduceerd. Zie Agentic retrieval code migreren naar de nieuwste versie voor hulp bij de migratie.
Zie Nieuw in Azure AI Search voor meer informatie over deze updates.
| Eigenschap | bijwerken | Toepasselijke REST API |
|---|---|---|
| Kennisbanken (voorheen kennisagenten) | Kennisagenten zijn hernoemd naar kennisdatabases, waardoor meerdere routes worden gewijzigd:
Kennisbanken verwijzen nu alleen op naam naar kennisbronnen, waarbij alle configuraties zijn verplaatst naar het ophaalverzoek.
|
Kennisbanken |
| Kennisbronnen | Nieuwe soorten kennisbronnen:
Geïndexeerde kennisbronnen bieden nu ondersteuning voor |
Kennisbronnen |
| Kennis ophalen | Aanvraagparameters (rerankerThreshold, alwaysQuerySource, includeReferences) worden nu per kennisbron doorgegeven via knowledgeSourceParams. Ondersteunt gedeeltelijke reacties met HTTP 206-statuscodes en optionele foutuitvoer in activiteitenrecords. De minimal redeneermodus gebruikt een intent object (directe zoekopdrachten) in plaats van een LLM voor queryplanning. |
Kennis ophalen |
| Vaardigheid Azure Content Understanding | Nieuwe vaardigheid die Azure Content Understanding verpakt in Foundry Tools om gestructureerde Markdown te extraheren uit tekst, afbeeldingen, PDF's, Microsoft PowerPoint, Microsoft Word en meer. Voor geïndexeerde kennisbronnen is deze vaardigheid beschikbaar via de contentExtractionMode eigenschap binnen ingestionParameters. |
Vaardigheden - Maken of bijwerken |
| Ondersteuning voor SharePoint indexer ACL | Uitgebreide ACL-ondersteuning om basismachtigingen van SharePoint naar geïndexeerde documenten te laten stromen, waardoor toegangscontrole op documentniveau mogelijk is. | Indexen - Maken of bijwerken, Gegevensbronnen - Maken of bijwerken, en Documenten - Bericht zoeken |
| Verhoogde leesmachtigingen voor ACL's | Nieuwe mogelijkheid om verhoogde leesmachtigingen toe te wijzen aan beheerders voor het onderzoeken van problemen met ACL-configuraties die worden gebruikt in toegangsbeheer voor documenten. | Documenten - Zoekpost |
| Indexering van gevoeligheidslabels op documentniveau | Nieuwe integratie met Microsoft Purview om vertrouwelijkheidslabels voor documenten te synchroniseren met de index, waarbij hun labels en beveiliging tijdens query's voor gegevensbeheer worden gerespecteerd. | Indexen - Maken of bijwerken, Gegevensbronnen - Maken of bijwerken, en Documenten - Bericht zoeken |
| Updates voor SharePoint-indexering | Nieuwe SharePoint-indexeerfuncties, waaronder verbeterde verificatieopties, incrementele updates en basisafhandeling van documentmachtigingen. | Gegevensbronnen - Maken of bijwerken |
| Aggregatie van scorefuncties | Nieuwe mogelijkheid om meerdere scorefuncties te combineren en samen te voegen, waardoor een geavanceerdere relevantieaanpassing en gewogen signaalcombinatie mogelijk zijn. | Indexen - Maken of bijwerken |
| Facet aggregaties | Nieuwe facetaggregatiebewerkingen, waaronder minimum, maximum, gemiddelde en kardinaliteit, bieden verbeterde analyses in gefacetteerde zoekervaringen. | Indexen - Maken of bijwerken |
2025-09-01
Deze API-versie is de nieuwste stabiele REST API voor Azure AI Search. Het bouwt voort op de vorige stabiele versie (2024-07-01) en voegt de API-updates toe die in de volgende tabel worden vermeld.
Een paar andere algemeen beschikbare functies, zoals integratie van Logic Apps en ondersteuning voor semantische scoreprofielen, hebben geen invloed op het API-contract en worden niet weergegeven in de tabel. Zie Nieuwe functies in Azure AI Search voor de volledige lijst met aankondigingen.
| Eigenschap | bijwerken | Toepasselijke REST API |
|---|---|---|
| OneLake-indexeerfunctie | Automatiseert het ophalen en indexeren van gegevens vanuit een Microsoft OneLake lakehouse. | Gegevensbronnen maken of bijwerken |
| Documentindeling vaardigheid | Segmenteert tekst op basis van de documentstructuur. | vaardighedenset maken of bijwerken |
| Normalizer eigenschap | Ondersteunt hoofdlettergevoelig filteren, facetteren en sorteren. | index maken of bijwerken |
| Index beschrijving eigenschap | Beschrijft een index die handig is voor snelle engineering in RAG-workloads. | index maken of bijwerken |
| Opties voor herscoren voor gecomprimeerde vectoren | Herscoort vectorzoekresultaten met originele vectoren in plaats van gecomprimeerde vectoren. Is van toepassing op HNSW en uitgebreide KNN-vectoralgoritmen met behulp van binaire en scalaire compressie. | index maken of bijwerken |
| Afgekapte afmetingen | Van toepassing op tekst-inbedding-3-kleine en tekstinbedding-3-grote modellen, getraind op Matroesjka Representation Learning (MRL) kwantisatie. | index maken of bijwerken |
| Foutopsporingsparameters en querysubscores | Pakt een hybride zoekresultaatscore uit in zijn samenstellende delen. | documenten zoeken |
2025-08-01-preview
Deze preview bouwt voort op de 2025-05-01-preview en is inclusief alle functies die momenteel in preview zijn.
Als u de 2025-05-01-preview hebt gebruikt om een knowledge agent te maken, worden in dit voorbeeld belangrijke wijzigingen geïntroduceerd. Zie Agentic retrieval code migreren naar de nieuwste versie voor hulp bij de migratie.
Zie Nieuw in Azure AI Search voor meer informatie over deze updates.
| Eigenschap | bijwerken | Toepasselijke REST API |
|---|---|---|
| Kennis agenten | Architecturale wijzigingen in de definitie van de kennisagent, die nu een of meer knowledgeSources vereist in plaats van targetIndexes en afschaft.defaultMaxDocsForRerankerVoegt meerdere eigenschappen toe voor meer controle over de planning en uitvoering van query's, waaronder |
Knowledge Agents - Maken of bijwerken |
| Kennisbronnen | Nieuwe REST API's voor het maken en beheren van kennisbronnen, die ondersteuning bieden searchIndex (één of meerdere indexen) en azureBlob soorten. |
Kennisbronnen |
| Strikte nafiltering voor vectorquery's | Nieuwe strictPostFilter waarde voor vectorFilterMode, die filters toepast nadat de resultaten van de globale topvectork zijn geïdentificeerd. |
Documenten - Zoekpost |
| Verhoogde maximale afmetingen voor vectorvelden | Het maximum dimensions per vectorveld is nu 4096. Deze update is van toepassing op alle stabiele en preview-REST API-versies die vectoren ondersteunen en introduceert geen belangrijke wijzigingen. |
Indexen - Maken of bijwerken |
| Verbeterde informatie over het bijhouden van de runtime van de indexer | Servicestatistieken ophalen retourneert nu cumulatieve gegevensverwerking van de indexeerfunctie voor de gehele zoekservice. Status ophalen - Indexeren biedt dezelfde informatie voor individuele indexeerders. | Servicestatistieken ophalen en status ophalen - Indexers |
2025-05-01-preview
Deze preview bouwt voort op de 2025-03-01-preview en is inclusief alle functies die momenteel in preview zijn. U kunt REST API-versies upgraden van 2025-03-01-preview naar met 2025-05-01-preview minimale codewijzigingen.
Deze preview voegt ondersteuning toe voor het ophalen van agenten, multimodale indexering, het overnemen van machtigingen op documentniveau en diepere integratie met grote taalmodellen in zowel indexerings- als queryworkloads. Zie Nieuw in Azure AI Search voor meer informatie.
| Eigenschap | bijwerken | Toepasselijke REST API |
|---|---|---|
| Agentisch ophalen | Voegt query-uitbreiding toe met behulp van conversationele taalmodellen voor intelligente queryplanning. Het genereert ook een complexe respons die aardingsgegevens bevat voor downstream-chattoepassingen. Het antwoord bevat een queryplan en referentiegegevens op basis van brondocumenten. | Kennisagenten en het ophalen van kennis |
| GenAI Prompt vaardigheid | Hiermee kunt u prompts en een LLM opgeven om nieuwe veldinhoud te genereren. | vaardighedenset maken of bijwerken |
| Documentindeling vaardigheid | Ondersteunt nu beelddetectie en contextbehoud voor multimodale indexering. | vaardighedenset maken of bijwerken |
| Integratie met Azure Logic Apps | Breidt ondersteunde gegevensbrontypen uit voor indexering op basis van indexeerfuncties die worden uitgevoerd op basis van werkstromen. | Gegevensbronnen maken of bijwerken |
| Overerving van machtigingen op documentniveau | Ondersteunt zoekresultaten met toestemming per gebruiker. |
Indexen maken of bijwerken (machtigingsfilters) Gegevensbronnen maken of bijwerken (machtigingsopties) |
2025-03-01-preview
Deze preview bouwt voort op de 2024-11-01-preview en is inclusief alle functies die momenteel in preview zijn. U kunt REST API-versies upgraden van 2024-11-01-preview naar met 2025-03-01-preview minimale codewijzigingen.
Er zijn slechts een paar API-updates voor het gegevensvlak in deze preview, maar er zijn meer mogelijkheden beschikbaar in de zoekservice wanneer uw code deze preview-API-versie aanroept. Zie Nieuw in Azure AI Search voor meer informatie.
| bijwerken | Toepasselijke REST API |
|---|---|
| Facethiërarchieën, aggregatie en filters, die worden gebruikt om facetnavigatiestructuren te genereren voor hiërarchische, geaggregeerde en gefilterde facetten. | Zoeken Documenten, nieuwe facet parameters op het verzoek. |
| Semantic ranker opt-in voor modellen aan boord | Maak of update Index, nieuwe flightingOptIn booleaanse eigenschap in de semantische configuratiesectie. Als er een prerelease-semantisch rangschikkingsmodel beschikbaar is in de regio van uw zoekservice, wordt dit gebruikt in plaats van de stabiele versie voor secundaire rangschikking. Deze eigenschap is bedoeld voor ontwikkelaars die de nieuwste rangschikkingsmodellen willen testen op niet-productiecode. |
2024-11-01-preview
Deze preview bouwt voort op de 2024-09-01-preview en is inclusief alle functies die momenteel in preview zijn. U kunt REST API-versies upgraden van 2024-09-01-preview naar met 2024-11-01-preview minimale codewijzigingen.
| bijwerken | Toepasselijke REST API |
|---|---|
| query herschrijven in de semantische reranker, gebruikt om query's te verfijnen die naar de L2-rangschikking worden verzonden. | zoekdocumenten, nieuwe eigenschap QueryRewritesType in de aanvraag. |
| vaardigheid documentindeling gebruikt om een document voor structuur te analyseren. | vaardighedenset maken of bijwerken, nieuwe DocumentIntelligenceLayoutSkill vaardigheid. |
| Beheerde identiteit voor het koppelen van een Azure AI-resource voor meerdere services. | vaardighedenset maken of bijwerken, nieuwe eigenschap AIServicesAccountIdentity. |
| Markdown-parseermodus, gebruikt voor het indexeren van Markdown-bestanden in Azure Storage. | Indexeerfunctie maken of bijwerken, nieuwe markdown parseringsmodus. |
| Rescoring options for compressed vectors, used for rescoring with original vectors in plaats van compressed vectors. Is van toepassing op HNSW en uitgebreide KNN-vectoralgoritmen met behulp van binaire en scalaire compressie. | enableRescoring eigenschap wordt toegewezen aan rerankWithOriginalVectors geïntroduceerd in de preview-versie van 2024-03-01. |
2024-09-01-preview
Deze preview bouwt voort op de 2024-05-01-preview en is inclusief alle functies die momenteel in preview zijn. U kunt een upgrade uitvoeren van 2024-05-01-preview naar 2024-09-01-preview zonder dat er codewijzigingen nodig zijn. Zie De REST API's upgradenvoor meer informatie.
| bijwerken | Toepasselijke REST API |
|---|---|
| afgekapte dimensies voor het insluiten van tekst-3-kleine en tekst-embedding-3-grote modellen die opnieuw zijn getraind op Matryoshka Representation Learning (MRL). | index maken of bijwerken, nieuwe truncationDimension parameter |
| Subscores of scoregegevens voor het uitpakken van hybride zoekresultaten die zijn beoordeeld door Recimaal Rank Fusion -. | documenten zoeken, nieuwe foutopsporing in parameter- en querysubscoredefinities in het antwoord. |
| Doelfiltering naar het vectorgedeelte van een hybride zoekquery. | search Documents, new filterOverride parameter in RawVectorQuery, VectorizableTextQuery, VectorizableImageUrlQuery, VectorizableImageBinaryQuery. |
| Tokensegmenteren in vaardigheid Tekst splitsen, in plaats van alleen tekens. | vaardighedenset maken of bijwerken, nieuwe -eenheid parameter en andere tokengerelateerde eigenschappen. |
2024-07-01
Deze versie biedt algemeen beschikbare updates voor geïntegreerde vectorisatie (vaardigheden en vectorizers), scalaire kwantisatie en binaire kwantisatie. Zie Wat is er nieuw in Azure AI Search voor meer informatie.
| bijwerken | Toepasselijke REST API |
|---|---|
| Algemeen beschikbaar - vectorgegevenstypen | index maken of bijwerken |
| Algemeen beschikbaar: vector kwantisatie-eigenschappen voor ingebouwde scalaire of binaire kwantisatie in een zoekindex. | index maken of bijwerken |
| Algemeen beschikbaar: opgeslagen eigenschap op een vectorveld die bepaalt of er een extra kopie van het veld wordt opgeslagen. De extra kopie is de ophaalbare inhoud van dat veld. Als u het niet opslaat, wordt het veld nog steeds gebruikt in query's, maar kan het niet worden geretourneerd in een zoekresultaat. U kunt deze eigenschap instellen om ruimte te besparen op uw zoekservice of vectorquotum in een zoekindex. | index maken of bijwerken |
| Algemeen beschikbaar: VectorizableTextQuery parameters voor het afstemmen van relevantie. Hybride queryparameters (MaxTextSizeRecall) zijn nog in preview. | documenten zoeken |
| Algemeen beschikbaar: AzureOpenAIEmbedding-vaardigheid om meer modellen te ondersteunen dan alleen tekst-embedding-ada-002 voor geïntegreerde vectorisatie tijdens het indexeren. Stel de eigenschappen van de modelnaam en dimensies in op een specifiek model. | vaardighedenset maken of bijwerken |
| Algemeen beschikbaar: Azure OpenAI embedding vectorizer voor geïntegreerde vectorisatie tijdens query's. Vectorizer-eigenschappen ondersteunen meer modellen. | index maken of bijwerken |
| Vanaf 29 maart 2024: GET-antwoorden retourneren geen verbindingsreeksen of sleutels meer. Zie Belangrijke wijziging voor clientcode die verbindingsgegevens leest voor meer informatie. | Alle versies |
2024-05-01-preview
In deze preview wordt ondersteuning toegevoegd voor OneLake-indexering, relevantieafstemming en diepere integratie met meer insluitingsmodellen tijdens het indexeren en uitvoeren van query's. Het bouwt voort op de 2024-03-01-preview en is inclusief alle functies die momenteel in preview zijn.
Als u een upgrade wilt uitvoeren van 2024-03-01-preview of 2023-10-01-preview, werkt u de vaardigheid of vectorizer van AzureOpenAIEmbedding bij om de modelnaam en dimensies op te nemen. Als u een upgrade wilt uitvoeren van 2023-07-01-preview (afgeschaft) of voor stapsgewijze instructies, raadpleegt u REST API's upgraden.
Dit zijn de updates in deze preview. U wordt ook aangeraden wat er nieuw is in Azure AI Search.
| bijwerken | Toepasselijke REST API |
|---|---|
| Indexeerfunctiegegevensbron voor OneLake-bestanden en snelkoppelingen. | gegevensbron maken of bijwerken |
Collection(Edm.Byte), een binair gegevenstype voor het insluiten van modellen die deze ondersteunen. Vectorvelddefinities ondersteunen dit gegevenstype. |
index maken of bijwerken |
| Meerdere vector- en hybride queryparameters voor het afstemmen van relevantie. Stel drempelwaarden in om lage scoreresultaten uit te sluiten. Gewichtsvectorquery's. Voor hybride query's stelt u het maximum aantal documenten in dat moet worden opgehaald in het tekstgedeelte van een hybride query. | documenten zoeken |
| Nieuwe Azure AI Vision-vaardigheid voor multimodale geïntegreerde vectorisatie tijdens het indexeren. Deze vaardigheid roept de multimodale API van Azure AI Vision aan. | vaardighedenset maken of bijwerken |
| Nieuwe Azure AI Vision-vectorizer voor multimodale query's. Een vectorizer wordt opgegeven in indexdefinities, maar wordt gebruikt tijdens het uitvoeren van query's. | index maken of bijwerken |
| AzureOpenAIEmbedding-vaardigheid bijgewerkt om meer modellen te ondersteunen dan alleen tekst-embedding-ada-002 voor geïntegreerde vectorisatie tijdens het indexeren. Stel de eigenschappen van de modelnaam en dimensies in op een specifiek model. | vaardighedenset maken of bijwerken |
| Azure OpenAI embedding vectorizer bijgewerkt voor geïntegreerde vectorisatie tijdens query's. Vectorizer-eigenschappen ondersteunen meer modellen. | index maken of bijwerken |
| Vanaf 29 maart 2024: GET-antwoorden retourneren geen verbindingsreeksen of sleutels meer. Zie Belangrijke wijziging voor clientcode die verbindingsgegevens leest voor meer informatie. | Alle versies |
2024-03-01-preview
Deze preview-versie is gebaseerd op 2023-10-01-preview door preview-API's toe te voegen die vectoropslag verbeteren. Zie Wat is er nieuw in Azure AI Search voor meer informatie.
| bijwerken | Toepasselijke REST API |
|---|---|
| Nieuwe smalle gegevenstypen voor vectorvelden als u modellen hebt ingesloten die deze ondersteunen of kwantisatielogica die kleinere vectoren uitvoert. | index maken of bijwerken |
| Nieuwe vector kwantisatie-eigenschappen voor ingebouwde vectorcompressie in een zoekindex. | index maken of bijwerken |
| Nieuwe booleaanse opgeslagen eigenschap op een vectorveld die bepaalt of een extra kopie van het veld wordt opgeslagen. De extra kopie is de ophaalbare inhoud van dat veld. Als u het niet opslaat, wordt het veld nog steeds gebruikt in query's, maar kan het niet worden geretourneerd in een zoekresultaat. U kunt deze eigenschap instellen om ruimte te besparen op uw zoekservice of vectorquotum in een zoekindex. | index maken of bijwerken |
| Vanaf 29 maart 2024: GET-antwoorden retourneren geen verbindingsreeksen of sleutels meer. Zie Belangrijke wijziging voor clientcode die verbindingsgegevens leest voor meer informatie. | Alle versies |
2023-11-01
Deze versie biedt algemeen beschikbare functies. Zie Wat is er nieuw in Azure AI Search voor meer informatie.
| bijwerken | Toepasselijke REST API |
|---|---|
| Semantische rangschikking in Search Post-aanvragen. | documenten zoeken |
| Vectorzoekconfiguratie voor indexeringsvectorvelden | index maken of bijwerken |
| Vectorquery's in Search Post-aanvragen. | documenten zoeken |
| Vanaf 29 maart 2024: GET-antwoorden retourneren geen verbindingsreeksen of sleutels meer. Zie Belangrijke wijziging voor clientcode die verbindingsgegevens leest voor meer informatie. | Alle versies |
2023-10-01-preview
Deze versie bevat alle functies die zijn geïntroduceerd in eerdere previews, plus toevoegingen en wijzigingen aan vectorzoek-API's. Updates voor de vectorzoekopdrachten-API's zijn een belangrijke wijziging van 2023-07-01-Preview. Zie Vectorvelden toevoegen en Een vectorquery maken voor hulp bij migratie.
Als u van plan bent de nieuwe voorfilterfunctie te gebruiken, moet u een index gebruiken die is gemaakt na 2023-10-01.
vectorSearchheeft definities vooralgorithms,profilesenvectorizers:algorithmsblijfthnswondersteunen en ondersteunt nu ookeknn, in verwijzing naar Hierarchical Navigable Small World (HNSW) en uitgebreide K-dichtstbijzijnde buren (eKNN). In de sectie algoritme kunt u meerdere benoemde combinaties van HNSW- en eKNN-parameters definiëren. Dit vervangtalgorithmConfigurationsin de eigenschapvectorSearchin 2023-07-01-Preview.profilesis een nieuwe definitie waarmee de algoritmeconfiguratie wordt opgegeven. Stel dat u algoritmeconfiguraties hebt met de naam HNSW-1, HSNW-2, eKNN-1. Een profiel kan HNSW-1 opgeven.vectorizersis gedefinieerd in een index, maar wordt gebruikt tijdens het uitvoeren van query's om een tekenreeks voor tekstquery's in te sluiten. Een vectorizer verwijst naar een insluitmodel. De zoekservice roept het insluitmodel aan om de tekenreeks voor tekstquery's te vectoriseren en geeft vervolgens het resultaat door aan de zoekmachine voor een vectorquery.
In vectorvelden vervangt
vectorSearchProfilevectorSearchConfiguration. De eigenschapvectorSearchProfilegeeft aan welk vectorzoekprofiel voor het veld moet worden gebruikt.Bij indexen die vóór deze API-versie zijn gemaakt, moet u bij het aanroepen van 2023-10-01-Preview-API in uw aanvraag het veld wijzigen om een
vectorSearchProfileop te geven zolang het profiel exact hetzelfde algoritme opgeeft dat eerder invectorSearchConfigurationis opgegeven. Als de bestaande velddefinitie bijvoorbeeld"vectorSearchConfiguration": "myHnsw"opgeeft, moet u deze vervangen door"vectorSearchProfile": "your profile name"en moet het profiel worden gedefinieerd om naar dezelfde"algorithm": "myHnsw"te verwijzen.
-
vectorQueriesvervangtvectorsin 2023-07-01-Preview -
vectorQueries.vectorsvervangtvectors.valuesin 2023-07-01-Preview. - De vectorquery is nu een polymorfe structuur.
kindmoet worden opgegeven om het type vectorquery aan te geven dat wordt aangevraagd."kind": "vector"betekent dat de query een vector is, dus de aanroeper moet de tekenreeks van de zoekquery al hebben gevectoriseerd in een vector insluiten. -
"exhaustive": "true"is een nieuwe eigenschap die aangeeft of er een uitgebreide (brute-force) k-dichtstbijzijnde burenzoekactie moet worden uitgevoerd op alle vectoren binnen de vectorindex. -
vectorFilterModeis een nieuwe parameter voor het opgeven van voorfiltering (standaard voor indexen die zijn gemaakt na2023-10-01) of postfiltering (standaard voor eerdere indexen) in de query.
Vanaf 29 maart 2024: GET-antwoorden retourneren geen verbindingsreeksen of sleutels meer. Zie Belangrijke wijziging voor clientcode die verbindingsgegevens leest voor meer informatie.
2023-07-01-preview
Belangrijk
Gebruik deze API-versie niet. Afschaffing van deze preview-versie is aangekondigd op 15 april 2024 en wordt na 8 juli 2024 niet meer ondersteund. Zie REST API's upgraden in Azure AI Searchvoor hulp bij migratie.
In deze versie is vectorondersteuning geïntroduceerd en wordt een vectorconfiguratie gebruikt die niet compatibel is met nieuwere API-versies.
- Er is een
Collection(Edm.Single)gegevenstype toegevoegd voor velden die een matrix met drijvendekommanummers met één precisie bevatten. Dit is het gegevenstype voor vectoren, dat wordt gebruikt voor het opslaan van één gegenereerde insluiting per documentveld. De zoekindex geeft ook vectorconfiguratie-eigenschappen op. - Bijgewerkte indexeringsworkloads om vectorgegevens te accepteren.
- Queryparameters toegevoegd voor vectorzoekopdrachten. Zie Documenten zoeken voor deze parameters.
- Servicestatistieken ophalen: geeft als resultaat vectorindexquotum en gebruik voor de service.
- Indexstatistieken ophalen: geeft als resultaat het quotum en het gebruik van de vectorindex voor de zoekindex.
- Vanaf 29 maart 2024: GET-antwoorden retourneren geen verbindingsreeksen of sleutels meer. Zie Belangrijke wijziging voor clientcode die verbindingsgegevens leest voor meer informatie.
2021-04-30-preview
Deze preview-versie bevat alle functies die zijn geïntroduceerd in 2020-06-30-Preview, plus toevoegingen aan de volgende API's:
- Indexalias voegt een secundaire naam toe die wordt gebruikt voor het verwijzen naar indexen in query- en indexeringsaanvragen. Aliasbewerkingen zijn onder andere maken, bijwerken, verwijderen, ophalen en vermelden.
- beheerde identiteiten voor uitgaande verbindingen. Nieuwe waarden voor verbindingsreeksen in Gegevensbron maken of bijwerken ondersteunen verbindingen met behulp van Microsoft Entra-id-verificatie en rollen in plaats van hardgecodeerde databasereferenties of -sleutels.
- Ondersteuning voor beheerde identiteiten wordt ook ondersteund voor key vault-verbindingen, voor zoekoplossingen die standaardversleuteling aanvullen met door de klant beheerde versleuteling.
- Meer talen voor de cognitieve vaardigheid Tekstvertaling.
- Meer queryTalen voor semantisch zoeken en spelling in Documenten zoeken.
- Een parameter voor ondertiteling om optioneel ondertiteling aan te vragen via semantisch zoeken in Documenten zoeken.
- Semantische configuraties worden gespecificeerd in Index maken of bijwerken. Een semantische configuratie bepaalt welke velden moeten worden gebruikt voor semantische rangschikking, bijschriften, markeringen en antwoorden.
- Een semanticConfiguration-parameter die vereist is voor semantische query's in Documenten zoeken.
- Vanaf 29 maart 2024: GET-antwoorden retourneren geen verbindingsreeksen of sleutels meer. Zie Belangrijke wijziging voor clientcode die verbindingsgegevens leest voor meer informatie.
2020-06-30
Deze versie biedt algemeen beschikbare functies, waaronder:
- Op rollen gebaseerd toegangsbeheer van Azure voor gegevensvlakbewerkingen
- Relevantiescore (BM25)
- Kennisarchieven
- Indexeerfunctiegegevensbron voor Azure Data Lake Storage (ADLS) Gen2
- Vaardigheid voor opzoeken van aangepaste entiteiten
- Indexeerfuncties die worden uitgevoerd onder een door een systeem of door een gebruiker beheerde identiteit via Microsoft Entra-id
- Vanaf 29 maart 2024: GET-antwoorden retourneren geen verbindingsreeksen of sleutels meer. Zie Belangrijke wijziging voor clientcode die verbindingsgegevens leest voor meer informatie.
2020-06-30-preview
Deze preview-versie bevat alle functies die zijn geïntroduceerd in 2019-05-06-Preview, plus de volgende toevoegingen:
- Semantische zoekopdrachten, een Premium-functie die wordt uitgevoerd op services van de Standard-laag en die semantische rangschikking aanroept.
- Indexeerfunctiegegevensbron voor Power Query-connectors
- Indexeerfunctiegegevensbron voor MySQL
- Indexeerfunctiegegevensbron voor Cosmos DB Gremlin-API
- Indexeerfunctiegegevensbron voor SharePoint Online
- Normalizer-eigenschap voor tekstnormalisatie, voor niet-hoofdlettergevoelig filteren, facet en sorteren
- Documenten opnieuw instellen voor indexering op basis van indexeerfuncties om specifieke documenten specifiek te vernieuwen op id
- Cognitieve vaardigheid Entity Linking (v3)
- Cognitieve vaardigheid voor entiteitsherkenning (v3)
- Cognitieve vaardigheid sentimentanalyse (v3)
- Vanaf 29 maart 2024: GET-antwoorden retourneren geen verbindingsreeksen of sleutels meer. Zie Belangrijke wijziging voor clientcode die verbindingsgegevens leest voor meer informatie.
2019-05-06-preview
- Ondersteuning voor indexeerfunctie voor gegevensbronnen voor Cosmos DB MongoDB-API
- Gegevensbron voor indexeerfunctie voor voorlopig verwijderen in Blob Storage
- parameter featuresMode die gedetailleerde informatie retourneert over een relevantiescore
- Cognitieve vaardigheid van Azure Machine Learning (AML)
- Cognitieve vaardigheid voor persoonlijke identificatiedetectie
- Verrijkte documenten in de cache opslaan en hergebruiken van afbeeldingsverwerking (en andere AI-verrijkingen)
- Vanaf 29 maart 2024: GET-antwoorden retourneren geen verbindingsreeksen of sleutels meer. Zie Belangrijke wijziging voor clientcode die verbindingsgegevens leest voor meer informatie.