Версии REST API (поиск в Azure AI)

  • Статья

В этой статье перечислены текущие и последние версии REST API поиска для поиска ИИ Azure.

Документация по API с версиями

Документация ПО REST API теперь версии. При открытии справочной страницы API селектор версий отображается над оглавлением. Убедитесь, что ссылка на API находится в папке Reference>Data Plane.

снимок экрана селектора версий.

Стабильные версии

Версия API Спецификация Обновления API
2024-07-01 (последняя версия) спецификация Swagger заметка о выпуске
2023-11-01 спецификация Swagger заметка о выпуске
2020-06-30 спецификация Swagger заметка о выпуске
2019-05-06 спецификация Swagger Добавляет сложные типы.

Предварительные версии

Предварительные версии выпускаются для тестирования новых функциональных возможностей, сбора отзывов и обнаружения и устранения проблем. Api предварительной версии доступны в дополнительных условиях использования для предварительных версий Microsoft Azure.

Версия API Спецификация Обновления API
2024-05-01-preview (последняя версия) спецификация Swagger заметка о выпуске
2024-03-01-preview спецификация Swagger заметка о выпуске
2023-10-01-preview спецификация Swagger заметка о выпуске
2023-07-01-preview (не рекомендуется) спецификация Swagger заметка о выпуске
2021-04-30-preview спецификация Swagger заметка о выпуске
2020-06-30-preview спецификация Swagger заметка о выпуске
2019-05-06-preview спецификация Swagger заметка о выпуске

Заметки о выпуске

2024-07-01

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

Обновлять Применимый REST API
Общедоступная версия — типы векторных данных создание или обновление индекса
Общедоступная версия — свойства квантизации векторов для встроенной скалярной или двоичной квантизации в индексе поиска. создание или обновление индекса
Общедоступен — хранимое свойство в поле вектора , определяющее, хранится ли дополнительная копия поля. Дополнительная копия — это извлекаемое содержимое этого поля. Если вы не храните его, поле по-прежнему используется в запросах, но не может быть возвращено в результатах поиска. Это свойство можно задать для экономии места в службе поиска или квоте вектора в индексе поиска. создание или обновление индекса
Общедоступная версия — параметры VectorizableTextQuery для настройки релевантности. Параметры гибридного запроса (MaxTextSizeRecall) по-прежнему находятся в предварительной версии. поиска документов
Общедоступная версия — навык azureOpenAIEmbedding для поддержки больше моделей, чем просто text-embedding-ada-002 для интегрированной векторизации во время индексирования. Задайте свойства имени и измерений модели для конкретной модели. создание или обновление набора навыков
Общедоступная версия — встраивающий векторизатор Azure OpenAI для интегрированной векторизации во время запросов. Свойства векторизатора поддерживают больше моделей. создание или обновление индекса
С 29 марта 2024 г. ответы GET больше не возвращают строки подключения или ключи. Дополнительные сведения см. в критическом изменении клиентского кода, который считывает сведения о подключении. Все версии

2024-05-01-preview

Эта предварительная версия добавляет поддержку индексирования OneLake, настройки релевантности и более глубокой интеграции с более внедренными моделями во время индексирования и запросов. Он строится на 2024-03-01-preview, поэтому он также имеет скалярную квантизацию, узкие типы данных и варианты хранения, представленные в этой версии.

Чтобы обновить 2024-03-01-preview или 2023-10-01-preview, обновите навык или векторизатор AzureOpenAIEmbedding, чтобы включить имя и измерения модели. Инструкции по обновлению с (не рекомендуется) или пошаговые инструкции см. в REST API обновления.

Ниже приведены обновления в этой предварительной версии. Мы также рекомендуем новые возможностипоиска ИИ Azure.

Обновлять Применимый REST API
Источник данных индексатора для файлов и ярлыков OneLake. создание или обновление источника данных
Collection(Edm.Byte)— двоичный тип данных для внедрения моделей, поддерживающих их. Определения полей векторов поддерживают этот тип данных. создание или обновление индекса
Несколько параметров вектора и гибридного запроса для настройки релевантности. Задайте пороговые значения, чтобы исключить результаты низкой оценки. Запросы вектора веса. Для гибридных запросов задайте максимальное количество документов для получения в текстовой части гибридного запроса. поиска документов
Новый навык распознавания искусственного интеллекта Azure для многомодальной интегрированной векторизации во время индексирования. Этот навык вызывает многомодальный API Azure AI Vision. создание или обновление набора навыков
Новый векторизатор распознавания искусственного интеллекта Azure для многомодальных запросов. Векторизатор указан в определениях индекса, но используется во время выполнения запроса. создание или обновление индекса
Обновлен навык azureOpenAIEmbedding для поддержки больше моделей, чем просто text-embedding-ada-002 для интегрированной векторизации во время индексирования. Задайте свойства имени и измерений модели для конкретной модели. создание или обновление набора навыков
Обновлен векторизатор Azure OpenAI для встроенной векторизации во время запросов. Свойства векторизатора поддерживают больше моделей. создание или обновление индекса
С 29 марта 2024 г. ответы GET больше не возвращают строки подключения или ключи. Дополнительные сведения см. в критическом изменении клиентского кода, который считывает сведения о подключении. Все версии

2024-03-01-preview

Эта предварительная версия основана на 2023-10-01-preview путем добавления API предварительной версии, которые улучшают хранилище векторов. Дополнительные сведения см. в новых возможностях поиска ИИ Azure.

Обновлять Применимый REST API
Новые узкие типы данных для полей векторов при внедрении моделей, поддерживающих их или логику квантизации, которая выводит меньшие векторы. создание или обновление индекса
Новые свойства векторной квантизации для встроенного сжатия векторов в индексе поиска. создание или обновление индекса
Новое логическое хранимое свойство в поле вектора , определяющее, хранится ли дополнительная копия поля. Дополнительная копия — это извлекаемое содержимое этого поля. Если вы не храните его, поле по-прежнему используется в запросах, но не может быть возвращено в результатах поиска. Это свойство можно задать для экономии места в службе поиска или квоте вектора в индексе поиска. создание или обновление индекса
С 29 марта 2024 г. ответы GET больше не возвращают строки подключения или ключи. Дополнительные сведения см. в критическом изменении клиентского кода, который считывает сведения о подключении. Все версии

2023-11-01

Эта версия предоставляет общедоступные функции. Дополнительные сведения см. в новых возможностях поиска ИИ Azure.

Обновлять Применимый REST API
Семантический ранжирование в запросах post поиска. поиска документов
Конфигурация векторного поиска для индексирования полей векторов создание или обновление индекса
Векторные запросы в запросах post поиска. поиска документов
С 29 марта 2024 г. ответы GET больше не возвращают строки подключения или ключи. Дополнительные сведения см. в критическом изменении клиентского кода, который считывает сведения о подключении. Все версии

2023-10-01-preview

Эта версия включает все функции, представленные в предыдущих предварительных версиях, а также дополнения и изменения в API векторного поиска. Обновления API векторного поиска являются критическим изменением с 2023-07-01-Preview. Сведения о добавлении полей векторов и создании векторного запроса для справки по миграции.

Если вы планируете использовать новую функцию префильтрации, необходимо использовать индекс, созданный после 2023-10-01.

создание или обновление индекса:

  • vectorSearch содержит определения для algorithms, profilesи vectorizers:

    • algorithms продолжает поддерживать hnsw, а теперь также поддерживает eknn, в связи с иерархическим навигационный малый мир (HNSW) и исчерпывающим K-ближайшим соседям (eKNN). В разделе алгоритма можно определить несколько именованных сочетаний параметров HNSW и eKNN. Это заменяет algorithmConfigurations в свойстве vectorSearch в 2023-07-01-Preview.

    • profiles — это новое определение, указывающее конфигурацию алгоритма. Например, предположим, что у вас есть конфигурации алгоритмов с именем HNSW-1, HSNW-2, eKNN-1. Профиль может указывать HNSW-1.

    • vectorizers определяется в индексе, но используется во время запроса для внедрения строки текстового запроса. Векторизатор ссылается на модель внедрения. Служба поиска вызывает модель внедрения, чтобы векторизировать строку текстового запроса, а затем передает результат поисковой системе для векторного запроса.

  • В векторных полях vectorSearchProfile заменяет vectorSearchConfiguration. Свойство vectorSearchProfile указывает, какой профиль векторного поиска следует использовать в поле.

  • В индексах, созданных до этой версии API, при вызове API 2023-10-01-Preview в запросе необходимо изменить поле, чтобы указать vectorSearchProfile, если профиль указывает точный алгоритм, указанный ранее в vectorSearchConfiguration. Например, если существующее определение поля указывает "vectorSearchConfiguration": "myHnsw", необходимо заменить его "vectorSearchProfile": "your profile name", а профиль должен быть определен для ссылки на тот же "algorithm": "myHnsw".

поиск документов:

  • vectorQueries заменяет vectors в 2023-07-01-Preview
  • vectorQueries.vectors заменяет vectors.values в 2023-07-01-Preview.
  • Теперь запрос вектора является полиморфной структурой. kind необходимо указать, чтобы указать тип запрашиваемого векторного запроса. "kind": "vector" означает, что запрос является вектором, поэтому вызывающий объект должен уже векторизировать строку поискового запроса в вектор внедрения.
  • "exhaustive": "true" — это новое свойство, указывающее, следует ли выполнять исчерпывающий поиск (метод подбора) k-ближайших соседей по всем векторам в индексе векторов.
  • vectorFilterMode — это новый параметр для указания префильтрации (по умолчанию для индексов, созданных после 2023-10-01) или послефильтрации (по умолчанию для предыдущих индексов) в запросе.

С 29 марта 2024 г. ответы GET больше не возвращают строки подключения или ключи. Дополнительные сведения см. в критическом изменении клиентского кода, который считывает сведения о подключении.

2023-07-01-preview

Важный

не используйте эту версию API. О прекращении использования этой предварительной версии было объявлено 15 апреля 2024 г. и больше не поддерживается после 8 июля 2024 г. Сведения о миграции см. в статье Обновление REST API впоиска ИИ Azure.

Эта версия представила поддержку векторов и использует конфигурацию вектора, несовместимую с более новыми версиями API.

2021-04-30-preview

Эта предварительная версия включает все функции, представленные в версии 2020-06-30-Preview, а также дополнения к следующим API:

2020-06-30

Эта версия предоставляет общие возможности, в том числе:

  • Управление доступом на основе ролей Azure для операций плоскости данных
  • Оценка релевантности (BM25)
  • Хранилища знаний
  • Источник данных индексатора для Azure Data Lake Storage (ADLS) 2-го поколения
  • Навык поиска пользовательских сущностей
  • Индексаторы, работающие под системным или управляемым пользователем удостоверением с помощью идентификатора Microsoft Entra
  • С 29 марта 2024 г. ответы GET больше не возвращают строки подключения или ключи. Дополнительные сведения см. в критическом изменении клиентского кода, который считывает сведения о подключении.

2020-06-30-preview

Эта предварительная версия включает все функции, представленные в 2019-05-06-Preview, а также следующие дополнения:

  • Семантический поиск, функция уровня "Премиум", которая выполняется в службах уровня "Стандартный" и вызывает семантический ранжирование.
  • Источник данных индексатора для соединителей Power Query
  • Источник данных индексатора для MySQL
  • Источник данных индексатора для API Gremlin Для Cosmos DB
  • Источник данных индексатора для SharePoint Online
  • Свойство нормализатора для нормализации текста для фильтрации без учета регистра, фасетирования и сортировки
  • Сброс документов для индексирования на основе индексатора для конкретного обновления определенных документов по идентификатору
  • Связывание сущностей когнитивного навыка (версия 3)
  • Когнитивный навык распознавания сущностей (версия 3)
  • Когнитивный навык анализа тональности (версия 3)
  • С 29 марта 2024 г. ответы GET больше не возвращают строки подключения или ключи. Дополнительные сведения см. в критическом изменении клиентского кода, который считывает сведения о подключении.

2019-05-06-preview

  • Поддержка источника данных индексатора для API MongoDB Cosmos DB
  • Источник данных индексатора для обратимого удаления в хранилище BLOB-объектов
  • параметр featuresMode, возвращающий подробные сведения о оценке релевантности
  • Когнитивный навык машинного обучения Azure (AML)
  • Когнитивный навык обнаружения личных идентификаций
  • Кэшированные обогащенные документы для сохранения и повторного использования обработки изображений (и других обогащений ИИ)
  • С 29 марта 2024 г. ответы GET больше не возвращают строки подключения или ключи. Дополнительные сведения см. в критическом изменении клиентского кода, который считывает сведения о подключении.

См. также