Semantische classificatiecode migreren uit eerdere versies

Als uw semantische classificatiecode is geschreven op basis van vroege preview-API's, worden in dit artikel de codewijzigingen geïdentificeerd die nodig zijn voor migratie naar nieuwere API-versies. Belangrijke wijzigingen voor semantische rangschikking zijn beperkt tot querylogica in recente API's, maar als uw code is geschreven in de eerste preview-versie, moet u mogelijk ook uw semantische configuratie wijzigen.

Wijzigingen die fouten veroorzaken

Er zijn twee belangrijke wijzigingen voor semantische ranker in REST API-versies:

• searchFields is vervangen door semanticConfiguration 2021-04-30-preview
• queryLanguage werd genegeerd vanaf 2023-07-01-preview, maar opnieuw ingesteld voor het herschrijven van query's in 2024-11-01-preview

Andere versiespecifieke updates hebben betrekking op nieuwe mogelijkheden, maar breken bestaande code niet en veroorzaken daarom geen wijzigingen die fouten veroorzaken.

Als u Azure SDK's gebruikt, zijn er in de loop van de tijd meerdere API's gewijzigd. De SDK-wijzigingslogboeken bevatten de details.

API-versies die semantische classificatie bieden

Controleer uw code voor de REST API-versie of SDK-pakketversie om te bevestigen welke versie semantische classificatie biedt. De volgende API-versies hebben enige ondersteuning voor semantische classificatie.

Releasetype	REST API-versie	Semantische ranker-updates
initiaal	2020-06-30-preview-	Toevoegen queryType=semantic aan zoekdocumenten
voorvertoning	2021-04-30-preview-	Wordt toegevoegd semanticConfiguration aan het maken of bijwerken van index
voorvertoning	2023-07-01-preview-	Bijwerken semanticConfiguration. Vanaf 14 juli 2023 worden de door Microsoft gehoste semantische modellen semantische taalagnostisch gemaakt, waardoor de queryLanguage eigenschap effectief buiten gebruik wordt gesteld voor semantische classificatie. Er is geen belangrijke wijziging in code, maar de eigenschap wordt genegeerd. Klanten werden aangeraden deze eigenschap uit code te verwijderen.
voorvertoning	2023-10-01-preview-	Voegt toe semanticQuery om een query te verzenden die alleen wordt gebruikt voor herrankeringsdoeleinden.
stal	2023-11-01	Algemeen verkrijgbaar. Er zijn wijzigingen aangebracht in semanticConfiguration de stabiele versie. Als uw code is gericht op deze versie of hoger, is deze compatibel met nieuwere API-versies, tenzij u nieuwe preview-functies gebruikt.
voorvertoning	2024-05-01-preview	Geen wijziging
stal	2024-07-01	Geen wijziging
voorvertoning	2024-09-01-preview-	Geen wijziging
voorvertoning	2024-11-01-preview	Hiermee voegt u het herschrijven van query's toe. De queryLanguage eigenschap is nu vereist als u het herschrijven van query's (preview) gebruikt.
voorvertoning	2025-03-01-preview	Hiermee voegt u opt-in toe aan voorlopige versies van semantische modellen.
voorvertoning	2025-05-01-voorbeeld	Er zijn geen API-updates in deze preview, maar semantische classificatie heeft nu betere integratie met scoreprofielen.
voorvertoning	2025-08-01-preview	Geen wijziging

Logboeken wijzigen voor Azure SDK's

Azure SDK's bevinden zich op een onafhankelijk releaseschema. Controleer de wijzigingslogboeken om te bepalen welke pakketten semantische functies bieden en of er API's zijn gewijzigd.

• Azure SDK voor .NET-wijzigingenlogboek
• Azure SDK voor Python-wijzigingslogboek
• Azure SDK voor Java-wijzigingslogboek
• Azure SDK voor JavaScript-wijzigingslogboek

2024-11-01-preview

• Hiermee voegt u het herschrijven van query's toe aan zoekdocumenten.
• Vereist queryLanguage voor het herschrijven van queryworkloads. Zie de REST API voor een lijst met geldige waarden.

2024-09-01-voorbeeld

Er worden geen wijzigingen aangebracht in de semantische classificatiesyntaxis van de stabiele versie 2024-07-01.

1 juli 2024

Er worden geen wijzigingen aangebracht in de semantische classificatiesyntaxis van de preview-versie 2024-05-01.

Gebruik deze API-versie niet. Hiermee wordt een vectorquerysyntaxis geïmplementeerd die niet compatibel is met een nieuwere API-versie.

2024-05-01-preview

Er worden geen wijzigingen aangebracht in de semantische classificatiesyntaxis van de preview-versie 2024-03-01.

2024-03-01-voorbeeld

Er worden geen wijzigingen aangebracht in de semantische classificatiesyntaxis van de preview-versie 2023-10-01, maar vectorquery's worden geïntroduceerd. Semantische classificatie is nu van toepassing op reacties van hybride en vectorquery's. U kunt rerankering toepassen op alle tekstvelden die door mensen kunnen worden gelezen in het antwoord, ervan uitgaande dat de velden worden vermeld in prioritizedFields.

2023-11-01

• SemanticDebug Sluit ensemanticQuery, anders hetzelfde als de preview-versie 2023-10-01.

2023-10-01-voorbeeld

• Voegt semanticQuery

2023-07-01-voorbeschouwing

• Voegt toe semanticErrorHandling, semanticMaxWaitInMilliseconds.
• Voegt talloze semantische gerelateerde velden toe aan het antwoord, zoals SemanticDebug en SemanticErrorMode.
• Negeert queryLanguage, het wordt niet meer gebruikt in semantische rangschikking.

Vanaf 14 juli 2023 is semantische ranker taalneutraal. In preview-versies zou semantische classificatie deprioritiseren van resultaten die afwijken van de querylanguage opgegeven door de veldanalyse. De queryLanguage eigenschap is echter nog steeds van toepassing op spellingcorrectie en de korte lijst met talen die door deze functie worden ondersteund.

2021-04-30-voorbeschouwing

• Semantische ondersteuning vindt plaats via zoekdocumenten en API-aanroepen voor het maken of bijwerken van indexvoorbeelden.
• Voegt toe semanticConfiguration aan een zoekindex. Een semantische configuratie heeft een naam en een lijst met velden met prioriteit.
• Voegt ''prioritizedFields' toe.

De searchFields eigenschap wordt niet meer gebruikt om velden te prioriteren. In alle versies die vooruitgaan, semanticConfiguration.prioritizedFields vervangt searchFields u als het mechanisme voor het opgeven van de velden die moeten worden gebruikt voor L2-classificatie.

2020-06-30-voorbeeld

• Semantische ondersteuning vindt plaats via een preview-API-aanroep voor zoekdocumenten .
• Wordt toegevoegd queryType=semantic aan de queryaanvraag.
• Past zich zo searchFields aan dat als het querytype semantisch is, de searchFields eigenschap de prioriteitsvolgorde van veldinvoer bepaalt in de semantische rangschikking.
• Voegt captions, answersen highlights toe aan het antwoord van de query.

Volgende stappen

Test uw semantische configuratiemigratie door een semantische query uit te voeren.

Een semantische query maken