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

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. Asegúrese de que la referencia de API se encuentra en la carpeta Planode datosde referencia>.

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 (en desuso)	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 (retirado)	No se admite a partir del 10-10-2020	Versión preliminar asociada a la versión estable.
2014-10-20-Preview (retirado)	No se admite a partir del 10-10-2020	Segunda versión preliminar pública.
2014-07-31-Preview (retirado)	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.
• A partir del 29 de marzo de 2024: las respuestas GET ya no devuelven cadenas de conexión ni claves. Consulte Cambio importante para el código de cliente que lee la información de conexión para obtener más información.

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 Create o Actualizar índice y consultas vectoriales en Búsqueda solicitudes Post.
• A partir del 29 de marzo de 2024: las respuestas GET ya no devuelven cadenas de conexión ni claves. Consulte Cambio importante para el código de cliente que lee la información de conexión para obtener más información.

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

Create 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 se define en un índice, pero se usa en el momento de la consulta para insertar una cadena de consulta de texto. Un vectorizador hace referencia a un modelo de inserción. El servicio de búsqueda realiza una llamada al modelo de inserción para vectorizar la cadena de consulta de texto y, a continuación, pasa el resultado al motor de búsqueda para una consulta vectorial.

• 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 se debe especificar 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 ya 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 de vecinos más cercana a k (fuerza bruta) en todos los vectores del índice vectorial.
• vectorFilterMode es un nuevo parámetro para especificar el prefiltro (valor predeterminado para los índices creados después de 2023-10-01) o postfiltro (predeterminado en los índices anteriores) en la consulta.

A partir del 29 de marzo de 2024: las respuestas GET ya no devuelven cadenas de conexión ni claves. Consulte Cambio importante para el código de cliente que lee la información de conexión para obtener más información.

2023-07-01-Preview

Importante

El 15 de abril de 2024 se anunció el desuso de esta versión preliminar y se retirará el 8 de julio de 2024. Para obtener ayuda con la migración, consulte Actualización de las API REST en Azure AI Búsqueda.

Esta versión tiene características de versiones preliminares anteriores, además de compatibilidad con la búsqueda de vectores:

• 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 de vectores, 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 Create 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.
• A partir del 29 de marzo de 2024: las respuestas GET ya no devuelven cadenas de conexión ni claves. Consulte Cambio importante para el código de cliente que lee la información de conexión para obtener más información.

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 en Create o Actualizar origen de datos 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 Create o índice de actualización. 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).
• A partir del 29 de marzo de 2024: las respuestas GET ya no devuelven cadenas de conexión ni claves. Consulte Cambio importante para el código de cliente que lee la información de conexión para obtener más información.

2020-06-30

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

• Control de acceso basado en rol de Azure para las operaciones del plano de datos
• Puntuación por relevancia (BM25)
• Almacenes de conocimiento
• Origen de datos del indexador para Azure Data Lake Storage (ADLS) Gen2
• Aptitud de búsqueda de entidades personalizadas
• Indizadores que se ejecutan en una identidad administrada por el usuario o del sistema a través de Microsoft Entra ID
• A partir del 29 de marzo de 2024: las respuestas GET ya no devuelven cadenas de conexión ni claves. Consulte Cambio importante para el código de cliente que lee la información de conexión para obtener más información.

2020-06-30-Preview

Esta versión preliminar incluye todas las características introducidas en 2019-05-06-Preview, además de las siguientes adiciones:

• Búsqueda semántica, una característica premium que se ejecuta en los servicios de nivel Estándar y que invoca la clasificación semántica.
• Origen de datos del indexador para conectores de Power Query
• Origen de datos del indexador para MySQL
• Origen de datos del indexador para Gremlin API de Cosmos DB
• Origen de datos del indexador para SharePoint Online
• Propiedad Normalizador para la normalización de texto, para el filtrado sin distinción entre mayúsculas y minúsculas, la faceta y la ordenación
• Restablecer documentos para la indexación basada en indexador para actualizar específicamente documentos específicos por identificador
• Aptitud cognitiva para la vinculación de entidad (v3)
• Aptitud cognitiva de reconocimiento de entidades (v3)
• Aptitud cognitiva análisis de sentimiento (v3)
• A partir del 29 de marzo de 2024: las respuestas GET ya no devuelven cadenas de conexión ni claves. Consulte Cambio importante para el código de cliente que lee la información de conexión para obtener más información.

06-05-2019-versión preliminar

• Compatibilidad del origen de datos del indexador con la API de MongoDB de Cosmos DB
• Origen de datos del indexador para la eliminación temporal de blobs nativos en Blob Storage
• parámetro featuresMode que devuelve información detallada sobre una puntuación de relevancia
• Aptitud cognitiva de Azure Machine Learning (AML)
• Aptitud cognitiva de detección de identificación personal
• Almacenar en caché documentos enriquecidos para conservar y reutilizar el procesamiento de imágenes (y otros enriquecimientos con IA)
• A partir del 29 de marzo de 2024: las respuestas GET ya no devuelven cadenas de conexión ni claves. Consulte Cambio importante para el código de cliente que lee la información de conexión para obtener más información.

Consulte también

• Creación de una instancia de Search Service
• Inicio rápido: Create un índice de Azure AI Búsqueda mediante las API REST