Migrera semantisk rangordningskod från tidigare versioner

Om din semantiska rangordningskod skrevs mot API:er för tidig förhandsversion identifierar den här artikeln de kodändringar som krävs för att migrera till nyare API-versioner. Icke-bakåtkompatibla ändringar för semantisk rankning är begränsade till frågelogik i de senaste API:erna, men om koden skrevs mot den första förhandsversionen kan du också behöva ändra din semantiska konfiguration.

Icke-bakåtkompatibla ändringar

Det finns två icke-bakåtkompatibla ändringar för semantisk rankning i REST API-versioner:

• searchFields ersattes av semanticConfiguration 2021-04-30-preview
• queryLanguage ignorerades från och med 2023-07-01-preview, men återställdes för omskrivning av frågor 2024-11-01-preview

Andra versionsspecifika uppdateringar gäller nya funktioner, men bryter inte befintlig kod och bryter därför inte ändringar.

Om du använder Azure SDK:er har flera API:er bytt namn över tid. SDK-ändringsloggarna innehåller informationen.

API-versioner som tillhandahåller semantisk rangordning

Kontrollera koden för REST API-versionen eller SDK-paketversionen för att bekräfta vilken som tillhandahåller semantisk rangordning. Följande API-versioner har viss stödnivå för semantisk rangordning.

Versionstyp	REST API-version	Uppdateringar av semantisk rankning
initial	Förhandsversion 2020-06-30	Lägger queryType=semantic till i sökdokument
preview	Förhandsversion 2021-04-30	Lägger semanticConfiguration till i Skapa eller uppdatera index
preview	Förhandsversion 2023-07-01	Uppdaterar semanticConfiguration. Från och med den 14 juli 2023 gjordes semantiska rankningsspråksagnostiska uppdateringar av Microsoft-värdbaserade semantiska modeller, vilket effektivt inaktiverade queryLanguage egenskapen för semantisk rangordning. Det finns ingen icke-bakåtkompatibel kodändring, men egenskapen ignoreras. Kunder uppmanades att ta bort den här egenskapen från koden.
preview	Förhandsversion 2023-10-01	Lägger semanticQuery till för att skicka en fråga som endast används för att ändra rangordning.
stall	2023-11-01	Allmänt tillgänglig. Introducerade ändringar av semanticConfiguration som gick vidare till den stabila versionen. Om koden riktar sig mot den här versionen eller senare är den kompatibel med nyare API-versioner om du inte använder nya förhandsversionsfunktioner.
preview	Förhandsversion 2024-05-01	Ingen ändring
stall	2024-07-01	Ingen ändring
preview	2024-09-01-preview	Ingen ändring
preview	Förhandsversion 2024-11-01	Lägger till frågeomskrivning. Egenskapen queryLanguage krävs nu om du använder frågeomskrivning (förhandsversion).

Ändra loggar för Azure SDK:er

Azure SDK:er är enligt ett oberoende versionsschema. Du bör kontrollera ändringsloggarna för att avgöra vilka paket som tillhandahåller semantiska funktioner och om några API:er har bytt namn.

• Azure SDK för .NET-ändringslogg
• Azure SDK för Python-ändringslogg
• Azure SDK för Java-ändringslogg
• Azure SDK för JavaScript-ändringslogg

Förhandsversion 2024-11-01

• Lägger till frågeomskrivning i Sök dokument.
• Kräver queryLanguage omskrivning av frågearbetsbelastningar. En lista över giltiga värden finns i REST-API:et.

2024-09-01-preview

Inga ändringar av semantisk rangordningssyntax från den stabila versionen 2024-07-01.

2024-07-01

Inga ändringar i semantisk rangordningssyntax från förhandsversionen 2024-05-01.

Använd inte den här API-versionen. Den implementerar en vektorfrågassyntax som inte är kompatibel med nyare API-versioner.

Förhandsversion 2024-05-01

Inga ändringar av semantisk rangordningssyntax från förhandsversionen 2024-03-01.

2024-03-01-preview

Inga ändringar av semantisk rangordningssyntax från förhandsversionen 2023-10-01, men vektorfrågor introduceras. Semantisk rangordning gäller nu för svar från hybrid- och vektorfrågor. Du kan tillämpa omvärdering på alla textfält som kan läsas av människor i svaret, förutsatt att fälten visas i prioritizedFields.

2023-11-01

• Exkluderar SemanticDebug och semanticQuery, i övrigt samma som 2023-10-01-förhandsversionen.

Förhandsversion 2023-10-01

• Lägger semanticQuery

Förhandsversion 2023-07-01

• Lägger till semanticErrorHandling, semanticMaxWaitInMilliseconds.
• Lägger till flera semantiska fält i svaret, till exempel SemanticDebug och SemanticErrorMode.
• queryLanguageIgnorerar , den används inte längre i semantisk rangordning.

Från och med den 14 juli 2023 är semantisk ranker språkagnostisk. I förhandsversioner skulle semantisk rangordning deprioritera resultat som skiljer sig från de querylanguage som anges av fältanalysatorn. Egenskapen gäller dock queryLanguage fortfarande för stavningskorrigering och den korta listan över språk som stöds av den funktionen.

Förhandsversion 2021-04-30

• Semantisk support sker via API-anrop för förhandsgranskning av sökdokument och Skapa eller uppdatera index .
• Lägger semanticConfiguration till i ett sökindex. En semantisk konfiguration har ett namn och en prioriterad fältlista.
• Lägger till ''prioritizedFields'.

Egenskapen searchFields används inte längre för att prioritera fält. I alla versioner framöver semanticConfiguration.prioritizedFields ersätter searchFields som mekanism för att ange vilka fält som ska användas för L2-rangordning.

Förhandsversion 2020-06-30

• Semantisk support sker via ett API-anrop för förhandsgranskning av sökdokument .
• Lägger queryType=semantic till i frågebegäran.
• searchFields Anpassar så att om frågetypen är semantisk searchFields avgör egenskapen prioritetsordningen för fältindata till den semantiska rankaren.
• Lägger till captions, answersoch highlights till frågesvaret.

Nästa steg

Testa din semantiska konfigurationsmigrering genom att köra en semantisk fråga.

Skapa en semantisk fråga