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 en un nuevo servicio de búsqueda, pero cualquiera 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

Compruebe la lista de regiones para ver si aparece la región.

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 servicio es un nivel facturable, Básico o superior.

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

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 1000 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 anular 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, estableciendo "semanticSearch" en "free" (valor predeterminado) o "estándar".

Pasos siguientes

Configure el clasificador semántico para poder probar la clasificación semántica en el contenido.