Habilitar o deshabilitar el clasificador semántico

El clasificador semántico es una característica premium que se factura por uso. De manera predeterminada, está deshabilitado en todos los servicios.

Comprobación de la disponibilidad

Compruebe la página Productos disponibles por región en el sitio web de Azure para ver si la región aparece.

Habilitación de la clasificación semántica

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 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 1 000 consultas del plan gratuito, recibirá un mensaje de error indicando que ha agotado la cuota la próxima vez que envíe una consulta semántica. Cuando esto suceda, debe actualizar al plan estándar para seguir usando la clasificación semántica.

REST

Para habilitar la clasificación semántica mediante la API de REST, puede usar la API de creación o actualización del 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 de la clasificación semántica mediante la API de REST

Para anular la habilitación de características, o para tener una protección completa frente al uso accidental y los cargos, puede deshabilitar la clasificación semántica mediante la API de creació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 la clasificación semántica, vuelva a ejecutar la solicitud anterior, estableciendo "semanticSearch" en "gratis" (valor predeterminado) o "estándar".

Pasos siguientes

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