Activer ou désactiver le ranker sémantique

  • Article

Le ranker sémantique est une fonctionnalité Premium facturée par l’utilisation. Par défaut, le classeur sémantique est désactivé sur un nouveau service de recherche, mais il peut être activé par toute personne disposant d’ autorisations de contributeur. 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é

Vérifiez la liste des régions pour voir si votre région est répertoriée.

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. Dans la page vue d’ensemble vue d’ensemble, vérifiez que le service est un niveau facturable, De base ou supérieur.

  3. Dans le volet de navigation de gauche, sélectionnez Paramètres>Classement 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 1 000 premières requêtes du plan gratuit, un message d’erreur indique que vous avez épuisé votre quota sur 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 annuler 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 Search 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 classeur sémantique, réexécutez la requête ci-dessus en donnant à « semanticSearch » la valeur « free » (par défaut) ou « standard ».

Étapes suivantes

Configurer le classeur sémantique afin de pouvoir tester le classement sémantique sur votre contenu.