Версии API в Поиск с использованием ИИ Azure

Note

Поиск с использованием ИИ Azure доступна через портал Azure, REST API и Azure SDKs. Он также лежит в основе Foundry IQ — управляемого слоя знаний, который преобразует корпоративный контент в многократно используемые базы знаний с учетом разрешений доступа для агентов на портале Microsoft Foundry.

Поиск с использованием ИИ Azure регулярно выпускает обновления возможностей. Иногда (но не всегда) для сохранения обратной совместимости для этих обновлений требуется новая версия API. Публикация новой версии позволяет вам выбирать, когда и как интегрировать обновления службы поиска в код.

Как правило, версии для интерфейсов REST API и библиотек определяются только при необходимости, так как это может потребовать некоторых усилий по обновлению вашего кода для использования новой версии API. Новая версия требуется только в том случае, если изменился какой-то аспект API и такое изменение нарушает обратную совместимость. Это может быть связано с исправлением имеющихся сбоев или с тем, что новые функции затрагивают имеющуюся контактную зону API.

Дополнительные сведения о процессе устаревания см. в разделе жизненный цикл и политика поддержки Azure SDK.

Устаревшие версии

Предварительная версия 2023-07-01-preview стала устаревшей 8 апреля 2024 года и больше не поддерживается с 8 июля 2024 года.

Это был первый REST API, который предложил поддержку поиска векторов. Более новые версии API имеют другую конфигурацию вектора. Вы должны перейти на более новую версию как можно скорее.

Неподдерживаемые версии

Некоторые версии API прекращены и больше не документируются или не поддерживаются:

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

Все пакеты SDK основаны на версиях REST API. Если версия REST прекращена, пакеты SDK, основанные на этой версии, также прекращены. Все пакеты SDK Поиск с использованием ИИ Azure .NET старше 3.0.0-rc теперь устарели.

Поддержка перечисленных выше версий закончилась 15 октября 2020 г. Если у вас есть код, использующий устаревшую версию, вы можете мигрировать существующий код на более новую версию REST API или более новую версию Azure SDK.

REST API

REST API Ссылка
Служба поиска (плоскость данных) См. сведения о версиях API в справочнике по REST API.
Управление поиском (контрольная плоскость) См. сведения о версиях API в справочнике по REST API.

Azure SDK для .NET

В следующей таблице приведены ссылки на более новые версии пакета SDK.

Версия пакета SDK Состояние Журнал изменений Описание
Azure. Search.Documents 11 Активен Журнал изменений API для операций плоскости данных в сервисе, таких как операции чтения и записи содержимого и объектов.
Azure. ResourceManager.Search Активен Журнал изменений API для операций на уровне управления в службе поиска.

Azure SDK для Java

Версия пакета SDK Состояние Журнал изменений Описание
azure-search-documents 11 Активен Change Log Использование клиентской библиотеки azure-search-documents для операций плоскости данных.
azure-resourcemanager-search 2 Активен Журнал изменений Используйте клиентскую библиотеку azure-resourcemanager-search для операций управляющей плоскости.

Azure SDK для JavaScript

Версия пакета SDK Состояние Журнал изменений Описание
@azure/search-documents 12 Активен Журнал изменений Используйте библиотеку клиента @azure/search-documents для операций с управлением данными.
@azure/arm-search 4 Активен Журнал изменений Используйте пакет @azure/arm-search для операций на управляющей плоскости.

Azure SDK для Python

Версия пакета SDK Состояние Журнал изменений Описание
azure-search-documents 11 Активен Журнал изменений Используйте библиотеку клиента azure-search-documents для операций с управлением данными.
azure-mgmt-search 9 Активен Журнал изменений Используйте клиентскую библиотеку azure-mgmt-search для операций управляющей плоскости.

Все Azure SDKs

Если вы ищете бета-библиотеки и документацию, эта страница содержит ссылки на все пакеты библиотек Azure SDK, код и документацию.