Partager via

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

  • Article

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.

Dernières modifications

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.

Type de version Version de l’API REST Mises à jour de l’éditeur de classement sémantique
initiale 2020-06-30-preview Ajoute queryType=semantic à Recherche dans des documents
préversion 2021-04-30-preview Ajoute semanticConfiguration à Créer ou mettre à jour l’index
préversion 2023-07-01-preview Met à jour semanticConfiguration. À partir du 14 juillet 2023, les mises à jour des modèles sémantiques hébergés par Microsoft ont rendu le classeur sémantique indépendant de la langue, désaffectant efficacement la propriété queryLanguage pour le classeur sémantique. Il n’y a aucun changement cassant dans le code, mais la propriété est ignorée. Les clients ont été invités à supprimer cette propriété du code.
préversion 2023-10-01-preview Ajoute semanticQuery pour envoyer une requête utilisée uniquement à des fins de reclassement.
stable 2023-11-01 En disponibilité générale. Introduit les modifications apportées à semanticConfiguration qui ont progressé vers la version stable. Si votre code cible cette version ou une version ultérieure, il est compatible avec les versions d’API plus récentes, sauf si vous adoptez de nouvelles fonctionnalités en préversion.
préversion 2024-05-01-preview Aucun changement
stable 2024-07-01 Aucun changement
préversion 2024-09-01-preview Aucun changement
préversion 2024-11-01-preview Ajoute la réécriture de requête. La propriété queryLanguage est désormais requise si vous utilisez réécriture de requête (préversion).

Journaux des modifications des SDK Azure

Les SDK Azure suivent une planification de mises en production distincte. Vous devez vérifier les journaux des modifications pour déterminer quels packages fournissent des fonctionnalités sémantiques et si des API ont été renommées.

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 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.

Créer une requête sémantique