Versiones de la API REST (Azure AI Búsqueda)

Artículo
04/04/2024

En este artículo se enumeran las versiones actuales y anteriores de las API rest de Búsqueda para Azure AI Búsqueda.

Documentos de API con versiones

Ahora se han versionado los documentos de la API REST. Al abrir una página de referencia de API, aparece un selector de versiones encima de la tabla de contenido.

Expanda Plano de datos de referencia>.
Seleccione una página de referencia de API.
Elija una versión de API en el filtro desplegable de la parte superior izquierda.

Versiones estables

Versión de API	Especificación	Actualizaciones de la API
`2023-11-01` (Más reciente)	Especificación de Swagger	Nota de la versión
`2020-06-30`	Especificación de Swagger	Nota de la versión
`2019-05-06`	Especificación de Swagger	Agrega tipos complejos.
`2017-11-11`	Especificación de Swagger	Agrega conjuntos de aptitudes y enriquecimiento con IA.
`2016-09-01`	Especificación de Swagger	Agrega indexadores.
`2015-02-28`	No se admite a partir del 10-10-2020	Primera versión con disponibilidad general.

Versiones preliminares

Las versiones preliminares se publican para probar nuevas funciones, recopilar comentarios, así como detectar y corregir problemas. Las API en versión preliminar están disponibles en Términos de uso complementarios para las versiones preliminares de Microsoft Azure.

Versión de API	Especificación	Actualizaciones de la API
`2024-03-01-Preview` (Más reciente)	Especificación de Swagger	Nota de la versión
`2023-10-01-Preview`	Especificación de Swagger	Nota de la versión
`2023-07-01-Preview`	Especificación de Swagger	Nota de la versión
`2021-04-30-Preview`	Especificación de Swagger	Nota de la versión
`2020-06-30-Preview`	Especificación de Swagger	Nota de la versión
`2019-05-06-Preview`	Especificación de Swagger	Nota de la versión
`2017-11-11-Preview`	Especificación de Swagger	Versión preliminar asociada a la versión estable.
`2016-09-01-Preview`	Especificación de Swagger	Versión preliminar asociada a la versión estable.
`2015-02-28-Preview`	No se admite a partir del 10-10-2020	Versión preliminar asociada a la versión estable.
`2014-10-20-Preview`	No se admite a partir del 10-10-2020	Segunda versión preliminar pública.
`2014-07-31-Preview`	No se admite a partir del 10-10-2020	Primera versión preliminar pública.

Notas de la versión

2024-03-01-Preview

Esta versión preliminar se basa en 2023-10-01-preview agregando las siguientes API en versión preliminar que le ayudan a ahorrar espacio:

Nuevos tipos de datos estrechos para los campos vectoriales si tiene modelos de inserción que los admiten o la lógica de cuantificación que genera vectores más pequeños.
Nuevas propiedades de cuantificación de vectores para la compresión de vectores integrada en un índice de búsqueda.
Nueva propiedad almacenada booleana en un campo vectorial que determina si se almacena una copia adicional del campo. La copia adicional es el contenido recuperable de ese campo. Si no lo almacena, el campo se sigue usando en las consultas, pero no se puede devolver en un resultado de búsqueda. Puede establecer esta propiedad para conservar espacio en el servicio de búsqueda o la cuota de vectores en un índice de búsqueda.

2023-11-01

Esta versión proporciona características disponibles con carácter general, entre las que se incluyen:

Clasificación semántica en solicitudes post de Búsqueda.
Indexación de búsqueda vectorial en solicitudes de creación o actualización de índice y consultas vectoriales en Búsqueda solicitudes Post.

2023-10-01-Preview

Esta versión incluye todas las características introducidas en versiones preliminares anteriores, además de adiciones y modificaciones en las API de búsqueda de vectores. Novedades a las API de búsqueda de vectores son un cambio importante de 2023-07-01-Preview. Consulte Adición de campos vectoriales y Creación de una consulta vectorial para obtener ayuda para la migración.

Si tiene previsto usar la nueva funcionalidad de prefiltro, debe usar un índice creado después de 2023-10-01.

Crear o actualizar índice:

vectorSearch tiene definiciones de algorithms, profilesy vectorizers:
- algorithms sigue admitiendo hnsw y ahora también admite eknn, en referencia a Jerárquicos Navigable Small World (HNSW) y vecinos exhaustivos K-near (eKNN). Dentro de la sección de algoritmo, puede definir varias combinaciones con nombre de los parámetros HNSW y eKNN. Esto reemplaza algorithmConfigurations dentro de la vectorSearch propiedad en 2023-07-01-Preview.
- profiles es una nueva definición que especifica la configuración del algoritmo. Por ejemplo, supongamos que tiene configuraciones de algoritmo denominadas HNSW-1, HSNW-2, eKNN-1. Un perfil puede especificar HNSW-1.
- vectorizers es visible, pero actualmente se omite.
En los campos vectorialesvectorSearchConfiguration, vectorSearchProfile reemplaza a . La vectorSearchProfile propiedad especifica qué perfil de búsqueda vectorial se va a usar en el campo.
En los índices creados antes de esta versión de api, al llamar a la API 2023-10-01-Preview, en la solicitud, debe cambiar el campo para especificar siempre vectorSearchProfile que el perfil especifique el mismo algoritmo exacto especificado anteriormente en vectorSearchConfiguration. Por ejemplo, si la definición de campo existente especifica "vectorSearchConfiguration": "myHnsw", debe reemplazarla por "vectorSearchProfile": "your profile name"y el perfil debe definirse para hacer referencia al mismo "algorithm": "myHnsw".

documentos de Búsqueda:

vectorQueriesvectors reemplaza en 2023-07-01-Preview
vectorQueries.vectorsvectors.values reemplaza en 2023-07-01-Preview.
La consulta vectorial es ahora una estructura polimórfica. kind debe especificarse para indicar el tipo de consulta vectorial que se solicita.
- "kind": "vector" significa que la consulta es un vector, por lo que el autor de la llamada debería haber vectorizado la cadena de consulta de búsqueda en una inserción de vectores.
"exhaustive": "true" es una nueva propiedad que especifica si se debe realizar una búsqueda k-force más cercana (por fuerza bruta) en todos los vectores del índice vectorial.
vectorFilterMode es un nuevo parámetro para especificar el filtrado previo (valor predeterminado para los índices creados después de 2023-10-01) o postfiltro (valor predeterminado en los índices anteriores) en la consulta.

2023-07-01-Preview

Esta versión incluye todas las características introducidas en versiones preliminares anteriores, además de la compatibilidad con la búsqueda vectorial:

En el índice de búsqueda, asigne Collection(Edm.Single) el tipo de datos en los campos que contienen una matriz de números de punto flotante de precisión sencilla. Este es el tipo de datos de la nueva funcionalidad de búsqueda vectorial, que se usa para almacenar una inserción generada por campo de documento. También en el índice de búsqueda, especifique las propiedades de configuración de vectores. Consulte Crear o actualizar índice para estas API.
Las cargas de trabajo de indexación se actualizan para aceptar datos vectoriales. Consulte Agregar, actualizar o eliminar documentos.
Parámetros de consulta para la búsqueda de vectores. Consulte Búsqueda Documentos para ver estos parámetros.
Obtener estadísticas del servicio: devuelve la cuota y el uso del índice vectorial para el servicio.
Obtener estadísticas de índice: devuelve la cuota y el uso del índice de vector para el índice de búsqueda.

2021-04-30-Preview

Esta versión preliminar incluye todas las características introducidas en 2020-06-30-Preview, además de las siguientes API:

El alias de índice agrega un nombre secundario que se usa para hacer referencia a índices en las solicitudes de consulta e indexación. Las operaciones de alias incluyen crear, actualizar, eliminar, obtener y enumerar.
Identidades administradas para conexiones salientes. Los nuevos valores de las cadenas de conexión de Create o Update Data Source admiten conexiones mediante Microsoft Entra ID autenticación y roles en lugar de credenciales o claves de base de datos codificadas de forma rígida.
La compatibilidad con identidades administradas también se admite para las conexiones del almacén de claves, para soluciones de búsqueda que complementan el cifrado predeterminado con el cifrado administrado por el cliente.
Más idiomas para la aptitud cognitiva Traducción de texto.
Más consultasLanguages para la búsqueda semántica y el corrector ortográfico en Búsqueda Documentos (versión preliminar).
Parámetro captions para solicitar de forma opcional subtítulos de la búsqueda semántica en Búsqueda Documentos (versión preliminar).
Las configuraciones semánticas se especifican en Crear o actualizar índice. Una configuración semántica determina qué campos se deben usar para la clasificación semántica, los títulos, los resaltados y las respuestas.
Parámetro semanticConfiguration necesario para consultas semánticas en Búsqueda Documentos (versión preliminar).

2020-06-30