Versiones de API en Búsqueda de Azure AI

Note

Búsqueda de Azure AI está disponible a través del portal de Azure, las API REST y los SDK de Azure. También respalda Foundry IQ, la capa de conocimiento administrada que transforma el contenido empresarial en bases de conocimiento reutilizables y compatibles con permisos para agentes en el portal de Microsoft Foundry.

Búsqueda de Azure AI implementa periódicamente las actualizaciones de características. A veces, aunque no siempre, estas actualizaciones requieren una nueva versión de la API para mantener la compatibilidad con versiones anteriores. La publicación de una nueva versión le permite controlar cuándo y cómo integrar en su código las actualizaciones del servicio de búsqueda.

Como regla, las API REST y las bibliotecas cliente de SDK de Azure solo se versionan cuando es necesario, ya que puede implicar algún esfuerzo por actualizar el código para usar una nueva versión de API. Solo se necesita una versión nueva si es necesario cambiar algún aspecto de la API de tal manera que se interrumpe la compatibilidad con versiones anteriores. Estos cambios pueden deberse a correcciones en las características existentes o a características nuevas que cambian el área expuesta de la API.

Para más información sobre la ruta de acceso de desuso, consulte la Directiva de soporte técnico y ciclo de vida del SDK de Azure.

Versiones en desuso

2023-07-01-preview quedó en desuso el 8 de abril de 2024 y ya no se admite a partir del 8 de julio de 2024. Esta versión fue la primera API REST que ofrecía compatibilidad con la búsqueda vectorial. Las versiones más recientes de API tienen una configuración de vector diferente. Migre a una versión de API más reciente o a una versión más reciente del SDK lo antes posible.

Versiones descontinuadas

A partir del 15 de octubre de 2020, las siguientes versiones de API se descontinuan y ya no se documentan ni admiten:

  • 2015-02-28
  • 2015-02-28-Preview
  • 2014-07-31-Preview
  • 2014-10-20-Preview

Todos los SDK se basan en versiones de las API REST. Si se interrumpe una versión de la API REST, también se descontinuan los paquetes del SDK en función de ella. Todos los SDK de Búsqueda de Azure AI .NET anteriores a 3.0.0-rc ahora están obsoletos.

Si tiene código que usa una versión discontinua, migre a una versión de API más reciente o a una versión más reciente del SDK.

API de REST

API DE REST Vínculo
Servicio de búsqueda (plano de datos) Consulte Versiones de API en la referencia de la API de REST.
Administración de búsquedas (plano de control) Consulte Versiones de API en la referencia de la API de REST.

SDK de Azure para .NET

Versión del SDK Estado Registro de cambios Descripción
Azure. Search.Documents 12 Active Registro de cambios API para operaciones de plano de datos en un servicio, como operaciones de lectura y escritura en contenido y objetos.
Azure. ResourceManager.Search Active Registro de cambios API para las operaciones del plano de control en el servicio de búsqueda.

SDK de Azure para Java

Versión del SDK Estado Registro de cambios Descripción
azure-search-documents 12 Active Registro de cambios Use la biblioteca cliente de azure-search-documents para las operaciones del plano de datos.
azure-resourcemanager-search 2 Active Registro de cambios Use la biblioteca cliente de azure-resourcemanager-search para las operaciones del plano de control.

SDK de Azure para JavaScript

Versión del SDK Estado Registro de cambios Descripción
@azure/search-documents 13 Active Registro de cambios Use la biblioteca cliente de @azure/search-documents para las operaciones del plano de datos.
@azure/arm-search 4 Active Registro de cambios Use el paquete @azure/arm-search para las operaciones del plano de control.

SDK de Azure para Python

Versión del SDK Estado Registro de cambios Descripción
azure-search-documents 12 Active Registro de cambios Use la biblioteca cliente de azure-search-documents para las operaciones del plano de datos.
azure-mgmt-search 9 Active Registro de cambios Use la biblioteca cliente de azure-mgmt-search para las operaciones del plano de control.

Todos los SDK de Azure

Si busca bibliotecas y documentación de cliente beta, este página contiene vínculos a todos los paquetes de biblioteca, código y documentos de SDK de Azure.