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’échelle du service à l’aide de l’API REST de gestion.

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.

Azure portal

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.

   

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.

REST

Pour activer le classeur sémantique à l’aide de l’API REST, vous pouvez utiliser l’API de création ou de mise à jour de services.

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.

• L’API REST de gestion version 2023-11-01 fournit la propriété de configuration.

• Des autorisations de propriétaire ou de contributeur sont nécessaires pour activer ou désactiver les fonctionnalités.

Remarque

Create or Update prend en charge deux méthodes HTTP : PUT et PATCH. PUT et PATCH peuvent être utilisés pour mettre à jour les services existants, mais seuls PUT peuvent être utilisés pour créer un service. Si PUT est utilisé pour mettre à jour un service existant, il remplace toutes les propriétés du service par leurs valeurs par défaut s’ils ne sont pas spécifiés dans la requête. Lorsque PATCH est utilisé pour mettre à jour un service existant, il ne remplace que les propriétés spécifiées dans la requête. Lorsque vous utilisez PUT pour mettre à jour un service existant, il est possible d’introduire accidentellement une mise à l’échelle ou une modification de configuration inattendue. Lors de l’activation du classement sémantique sur un service existant, il est recommandé d’utiliser PATCH au lieu de PUT.

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

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

Configurer le classeur sémantique