Migración del código de clasificación semántica de versiones anteriores

Si el código de clasificación semántica se escribió utilizando API en versiones preliminares, este artículo identifica los cambios de código necesarios para migrar a versiones más recientes de las API. Los cambios importantes para el clasificador semántico se limitan a la lógica de consulta de las API recientes, pero si el código se escribió utilizando la versión preliminar inicial, es posible que también tenga que cambiar la configuración semántica.

Cambios importantes

Hay dos cambios importantes para el clasificador semántico en las versiones de la API de REST:

• searchFields se reemplazó por semanticConfiguration en 2021-04-30-preview.
• queryLanguage se omitió a partir de 2023-07-01-preview, pero se restableció para la reescritura de consultas en 2024-11-01-preview.

Otras actualizaciones específicas de la versión pertenecen a nuevas funcionalidades, pero no afectan al código existente y, por lo tanto, no son cambios importantes.

Si usa SDK de Azure, hay varias API cuyos nombres han cambiado a lo largo del tiempo. Los registros de cambios del SDK proporcionan los detalles.

Versiones de API que proporcionan clasificación semántica

Compruebe el código de la versión de la API de REST o la versión del paquete del SDK para confirmar cuál proporciona la clasificación semántica. Las siguientes versiones de API tienen cierto nivel de compatibilidad con la clasificación semántica.

Tipo de versión	Versión de API de REST	Actualizaciones del clasificador semántico
initial	2020-06-30-preview	Agrega queryType=semantic a los documentos de búsqueda
Vista previa	2021-04-30-preview	Agrega semanticConfiguration para crear o actualizar el índice
Vista previa	2023-07-01-preview	Actualiza semanticConfiguration. A partir del 14 de julio de 2023, las actualizaciones a los modelos semánticos alojados por Microsoft hicieron que el clasificador semántico fuera independiente del idioma, eliminando efectivamente la propiedad queryLanguage para la clasificación semántica. No hay ningún cambio importante en el código, pero se omite la propiedad. Se recomienda a los clientes quitar esta propiedad del código.
Vista previa	2023-10-01-preview	Agrega semanticQuery para enviar una consulta que solo se usa con fines de reclasificación.
Estable	2023-11-01	Disponible con carácter general. Se introdujeron cambios en semanticConfiguration que progresan hacia la versión estable. Si el código tiene como destino esta versión o una posterior, significa que es compatible con las versiones más recientes de la API a menos que adopte nuevas características en versión preliminar.
Vista previa	2024-05-01-preview	Sin cambios
Estable	2024-07-01	Sin cambios
Vista previa	2024-09-01-preview	Sin cambios
Vista previa	2024-11-01-preview	Agrega reescritura de consultas. La propiedad queryLanguage ahora es necesaria si usa la reescritura de consultas (versión preliminar).

Cambios en los registros de los SDK de Azure

Los SDK de Azure están en una programación de versión independiente. Debe comprobar los registros de cambios para determinar qué paquetes proporcionan características semánticas y si se ha cambiado el nombre de las API.

• Registro de cambios del SDK de Azure para .NET
• Registro de cambios del SDK de Azure para Python
• Registro de cambios del SDK de Azure para Java
• Registro de cambios del SDK de Azure para JavaScript

2024-11-01-preview

• Agrega la reescritura de consultas a la búsqueda de documentos.
• Requiere queryLanguage para las cargas de trabajo de reescritura de consultas. Para obtener una lista de valores válidos, consulte la API de REST.

2024-09-01-preview

No hay cambios en la sintaxis de clasificación semántica desde la versión estable 2024-07-01.

2024-07-01

No hay cambios en la sintaxis de clasificación semántica desde la versión 2024-05-01-preview.

No usar esta versión de API. Implementa una sintaxis de consulta vectorial incompatible con cualquier versión de API más reciente.

2024-05-01-preview

No hay cambios en la sintaxis de clasificación semántica desde la versión 2024-03-01-preview.

2024-03-01-preview

No hay cambios en la sintaxis de clasificación semántica desde la versión 2023-10-01-preview, pero se han introducido consultas vectoriales. La clasificación semántica ahora se aplica a las respuestas de consultas híbridas y vectoriales. Puede aplicar la reclasificación en cualquier campo de texto legible por una persona, suponiendo que los campos se muestran en prioritizedFields.

2023-11-01

• Excluye SemanticDebug y semanticQuery; de lo contrario, igual que la versión 2023-10-01-preview.

2023-10-01-preview

• Agrega semanticQuery.

2023-07-01-preview

• Agrega semanticErrorHandling, semanticMaxWaitInMilliseconds.
• Agrega numerosos campos relacionados con la semántica a la respuesta, como SemanticDebug y SemanticErrorMode.
• Omite queryLanguage, ya no se usa en la clasificación semántica.

A partir del 14 de julio de 2023, el clasificador semántico es independiente del idioma. En las versiones preliminares, la clasificación semántica desclasificaría los resultados que difieren del valor querylanguage especificado por el analizador de campos. Sin embargo, la propiedad queryLanguage sigue siendo aplicable a la corrección ortográfica y a la corta lista de idiomas admitidos por esa característica.

2021-04-30-preview

• La compatibilidad semántica es a través de las llamadas API en versión preliminar Buscar documentos y Crear o actualizar el índice.
• Agrega semanticConfiguration a un índice de búsqueda. Una configuración semántica tiene un nombre y una lista de campos clasificados.
• Agrega "prioritizedFields".

La propiedad searchFields ya no se usa para clasificar los campos. En todas las versiones futuras, semanticConfiguration.prioritizedFields reemplaza a searchFields como mecanismo para especificar qué campos se usarán para la clasificación L2.

2020-06-30-preview

• La compatibilidad semántica es a través de una llamada API en versión preliminar Buscar documentos.
• Agrega queryType=semantic a la solicitud de consulta.
• Adapta searchFields para que si el tipo de consulta es semántico, la propiedad searchFields determine el orden de prioridad de las entradas de campo al clasificador semántico.
• Agrega captions, answers y highlights a la respuesta de la consulta.

Pasos siguientes

Pruebe la migración de la configuración semántica mediante la ejecución de una consulta semántica.

Creación de consultas semánticas