Migrer le code de classement sémantique des versions précédentes

Si votre code de classement sémantique a été écrit sur des API en préversion anticipée, cet article identifie les modifications de code nécessaires à la migration vers des versions d’API plus récentes. Les changements cassants pour le classeur sémantique sont limités à la logique de requête dans les API récentes, mais si votre code a été écrit sur la version préliminaire initiale, vous devrez peut-être également modifier votre configuration sémantique.

Changements cassants

Il existe deux changements cassants pour le classeur sémantique dans les versions de l’API REST :

• searchFields a été remplacé par semanticConfiguration dans 2021-04-30-preview
• queryLanguage a été ignoré à partir de 2023-07-01-preview, mais rétabli pour la réécriture des requêtes dans 2024-11-01-preview

Les autres mises à jour spécifiques à la version concernent de nouvelles fonctionnalités, mais n’interrompent pas le code existant et ne sont donc pas des modifications cassantes.

Si vous utilisez des SDK Azure, plusieurs API ont été renommées au fil du temps. Les détails sont fournis dans les journaux des modifications du SDK.

Versions d’API proposant un classement sémantique

Vérifiez votre code pour la version de l’API REST ou la version du package SDK pour confirmer celle qui fournit un classement sémantique. Les versions d’API suivantes prennent en charge le classement sémantique jusqu’à un certain point.

Journaux des modifications des SDK Azure

Pour déterminer quelles fonctionnalités sémantiques sont disponibles dans un package de SDK Azure spécifique et si des API ont été renommées, consultez le journal des modifications du Kit de développement logiciel (SDK) :

• Journal des modifications pour le SDK Azure pour .NET
• Journal des modifications pour le SDK Azure pour Python
• Journal des modifications pour le SDK Azure pour Java
• Journal des modifications pour le SDK Azure pour JavaScript

2024-11-01-preview

• Ajoute réécriture de requête à Recherche dans des documents.
• Nécessite queryLanguage pour les charges de travail de réécriture des requêtes. Pour obtenir la liste des valeurs valides, consultez l’API REST.

2024-09-01-preview

Aucune modification de la syntaxe de classement sémantique de la version stable 2024-07-01.

2024-07-01

Aucune modification de la syntaxe de classement sémantique de la version 2024-05-01-preview.

N’utilisez pas cette version d’API. Elle implémente une syntaxe de requête vectorielle incompatible avec une version d’API plus récente.

2024-05-01-preview

Aucune modification de la syntaxe de classement sémantique de la version 2024-03-01-preview.

2024-03-01-preview

Aucune modification de la syntaxe de classement sémantique de la version 2023-10-01-preview, mais les requêtes vectorielles ont été introduites. Le classement sémantique s’applique désormais aux réponses des requêtes hybrides et vectorielles. Vous pouvez appliquer un reclassement sur tous les champs de texte lisibles par l’homme dans la réponse, tant que les champs sont répertoriés dans prioritizedFields.

2023-11-01

• Exclut SemanticDebug et semanticQuery, sinon identique à la version 2023-10-01-preview.

2023-10-01-preview

• Ajoute semanticQuery

2023-07-01-preview

• Ajoute semanticErrorHandling, semanticMaxWaitInMilliseconds.
• Ajoute de nombreux champs sémantiques à la réponse, tels que SemanticDebug et SemanticErrorMode.
• Ignore queryLanguage, il n’est plus utilisé dans le classement sémantique.

À partir du 14 juillet 2023, le classeur sémantique est indépendant de la langue. Dans les préversions, le classement sémantique diminuait la priorité des résultats qui différaient de la valeur querylanguage spécifiée par l’analyseur de champs. Toutefois, la propriété queryLanguage s’applique toujours à correction orthographique et à la courte liste des langues prises en charge par cette fonctionnalité.

2021-04-30-preview

• La prise en charge sémantique se fait via les appels d’API en préversion Recherche dans des documents et Créer ou mettre à jour l’index.
• Ajoute semanticConfiguration à un index de recherche. Une configuration sémantique a un nom et une liste de champs hiérarchisée.
• Ajoute ``prioritizedFields`.

La propriété searchFields n’est plus utilisée pour hiérarchiser les champs. Dans toutes les nouvelles versions, semanticConfiguration.prioritizedFields remplace searchFields comme mécanisme permettant de spécifier les champs à utiliser dans le classement L2.

2020-06-30-preview

• La prise en charge sémantique se fait via l’appel d’API en préversion Recherche dans des documents.
• Ajoute queryType=semantic à la demande de requête.
• Adapte searchFields de sorte que si le type de requête est sémantique, la propriété searchFields détermine l’ordre de priorité des entrées de champ au classeur sémantique.
• Ajoute captions, answers et highlights à la réponse de la requête.

Étapes suivantes

Testez votre migration de configuration sémantique en exécutant une requête sémantique.