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.

Últimos cambios

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.

Cambios en los registros de los SDK de Azure

Para determinar qué características semánticas están disponibles en un paquete específico del SDK de Azure y si se ha cambiado el nombre de las API, consulte el registro de cambios del SDK:

• 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.

01-07-2024

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-vista previa

• 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.