Activer ou désactiver le ranker sémantique

Le ranker sémantique est une fonctionnalité Premium facturée par l’utilisation. Par défaut, le ranker sémantique est désactivé sur tous les services.

Vérifier la disponibilité

Consultez la page Produits disponibles par région sur le site web Azure pour voir si votre région est répertoriée.

Activer le classement 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. 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 Recherche 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 1 000 premières requêtes du plan gratuit, vous recevrez un message d'erreur vous indiquant que vous avez épuisé votre quota la prochaine fois que vous lancerez une requête sémantique. Dans ce cas, vous devez passer au plan standard pour continuer à utiliser le classement sémantique.

REST

Pour activer le classement 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 Search 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

Créer ou Mettre à jour 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 classement 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 classement 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 classement 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 classement sémantique afin de pouvoir tester le classement sémantique sur votre contenu.