Habilitar o deshabilitar el clasificador semántico

El clasificador semántico es una característica premium que se factura por uso. De forma predeterminada, el clasificador semántico está desactivado al crear un nuevo servicio de búsqueda, pero cualquier persona con permisos de Colaborador puede habilitarlo. Si no desea que nadie lo habilite involuntariamente, puede deshabilitarlo mediante la API de REST.

Comprobación de la disponibilidad

Para comprobar si el clasificador semántico está disponible en su región, consulte la lista de regiones de Búsqueda de Azure AI.

Habilitación del clasificador semántico

Siga estos pasos para habilitar el clasificador semántico a nivel de servicio. Una vez habilitada, está disponible para todos los índices. No se puede activar ni desactivar para índices específicos.

Azure Portal

1. Abra Azure Portal.

2. Vaya al servicio de búsqueda. En la página Información general, asegúrese de que el plan de tarifa esté establecido en Básico o superior.

3. En el panel de navegación izquierdo, seleccione Configuración>Clasificador semántico.

4. Seleccione el Plan gratuito o el Plan estándar. Puede cambiar entre el plan gratuito y el plan estándar en cualquier momento.

   

El plan gratuito está limitado a 1 000 consultas al mes. Después de las primeras 1 000 consultas del plan gratuito, un mensaje de error indica que ha agotado la cuota en la siguiente consulta semántica. Cuando se agote la cuota, debe actualizar al plan estándar para seguir usando la clasificación semántica.

REST

Para habilitar el clasificador semántico mediante la API de REST, puede usar la API de creación o actualización o actualización de servicio.

Las llamadas API de REST de administración se autentican a través de Microsoft Entra ID. Consulte Administración del servicio Search de Azure AI con las API de REST para obtener instrucciones sobre cómo autenticarse.

• La versión 2023-11-01 de la API de REST de administración proporciona la propiedad de configuración.

• Se requieren permisos de propietario o colaborador para habilitar o deshabilitar características.

Nota:

Create o Update admiten dos métodos HTTP: PUT y PATCH. Tanto PUT como PATCH se pueden usar para actualizar los servicios existentes, pero solo se puede usar PUT para crear un nuevo servicio. Si PUT se usa para actualizar un servicio existente, reemplaza todas las propiedades del servicio por sus valores predeterminados si no se especifican en la solicitud. Cuando PATCH se usa para actualizar un servicio existente, solo reemplaza las propiedades especificadas en la solicitud. Al usar PUT para actualizar un servicio existente, es posible introducir accidentalmente un cambio inesperado de escalado o configuración. Al habilitar la clasificación semántica en un servicio existente, se recomienda usar PATCH en lugar 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"
      }
    }

Deshabilitación del clasificador semántico mediante la API de REST

Para desactivar la habilitación de características o para una protección completa contra el uso y los cargos accidentales, puede deshabilitar el clasificador semántico mediante la API de creación o actualización o actualización de servicio en el servicio de búsqueda. Una vez deshabilitada la característica, se rechazan las solicitudes que incluyen el tipo de consulta semántica.

Las llamadas API de REST de administración se autentican a través de Microsoft Entra ID. Consulte Administración del servicio Search de Azure AI con las API de REST para obtener instrucciones sobre cómo autenticarse.

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"
      }
    }

Para volver a habilitar el clasificador semántico, vuelva a ejecutar la solicitud anterior y establezca semanticSearch en Gratis (valor predeterminado) o Estándar.

Paso siguiente

Configuración del clasificador semántico