Activer ou désactiver le ranker sémantique

Le classeur sémantique est une fonctionnalité Premium facturée à l’utilisation. Par défaut, le classement sémantique est désactivé lorsque vous créez un nouveau service de recherche, mais toute personne ayant des droits de contributeur peut l'activer. Si vous ne souhaitez pas que quelqu’un l’active par inadvertance, vous pouvez le désactiver à l’aide de l’API REST.

Vérifier la disponibilité

Pour vérifier si l’éditeur de classement sémantique est disponible dans votre région, consultez la liste des régions Recherche Azure AI.

Activer un classeur sémantique

Suivez ces étapes pour activer de classement sémantique au niveau du service. Une fois activé, il est disponible pour tous les index. Vous ne pouvez pas l’activer ou la désactiver pour des index spécifiques.

  1. Ouvrez le portail Azure.

  2. Accéder à votre service de recherche. Sur la page de présentation, assurez-vous que le niveau de tarification est défini sur De base ou supérieur.

  3. Dans le volet de navigation de gauche, sélectionnez Paramètres>Classeur sémantique.

  4. Sélectionnez le plan Gratuit ou le plan Standard. Vous pouvez passer du plan gratuit au plan standard à tout moment.

    Capture d’écran de l’activation du classement sémantique dans le portail Azure.

L'offre gratuite est plafonnée à 1 000 requêtes par mois. Après les 1000 premières requêtes du plan gratuit, un message d’erreur indique que vous avez épuisé votre quota lors de la requête sémantique suivante. Lorsque le quota est épuisé, vous devez passer au plan standard pour continuer à utiliser le classeur sémantique.

Désactiver le classeur sémantique à l’aide de l’API REST

Pour désactiver l’activation d’une fonctionnalité, ou pour une protection complète contre l’utilisation accidentelle et les frais, vous pouvez désactiver le classeur sémantique à l’aide de l’option Créer ou mettre à jour l’API de service sur votre service de recherche. Une fois la fonctionnalité désactivée, toutes les demandes qui incluent le type de requête sémantique sont rejetées.

Les appels d’API REST de gestion sont authentifiés avec Microsoft Entra ID. Consultez Gérer votre service Recherche Azure AI avec des API REST pour obtenir des instructions sur l’authentification.

PATCH https://management.azure.com/subscriptions/{{subscriptionId}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2023-11-01
    {
      "properties": {
        "semanticSearch": "disabled"
      }
    }

Pour réactiver le classement sémantique, relancez la requête précédente et réglez semanticSearch sur Libre (par défaut) ou Standard.

Étape suivante