Версии REST API (azure AI Поиск)
В этой статье перечислены текущие и предыдущие версии Поиск REST API для azure AI Поиск.
Документация по API с управлением версиями
Документация по REST API теперь является версией. При открытии страницы справочника по API над оглавлением отображается селектор версии. Убедитесь, что ссылка на API находится в папке Плоскость ссылочных>данных .
Стабильные версии
| Версия API | Спецификация | Обновления API |
|---|---|---|
2023-11-01 (Последняя версия) |
Спецификация Swagger | Заметки о выпуске |
2020-06-30 |
Спецификация Swagger | Заметки о выпуске |
2019-05-06 |
Спецификация Swagger | Добавляет сложные типы. |
2017-11-11 |
Спецификация Swagger | Добавляет наборы навыков и обогащение с помощью ИИ. |
2016-09-01 |
Спецификация Swagger | Добавляет индексаторы. |
2015-02-28 |
Не поддерживается после 10-10-2020 | Первый общедоступный выпуск. |
Предварительные версии
Выпущены предварительные версии для тестирования новых функций, сбора отзывов, обнаружения и устранения проблем. Предварительные версии API доступны в разделе Дополнительные условия использования предварительных версий Microsoft Azure.
| Версия API | Спецификация | Обновления API |
|---|---|---|
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 | Заметки о выпуске |
2017-11-11-Preview |
Спецификация Swagger | Предварительная версия, связанная со стабильной версией. |
2016-09-01-Preview |
Спецификация Swagger | Предварительная версия, связанная со стабильной версией. |
2015-02-28-Preview (прекращено) |
Не поддерживается после 10-10-2020 | Предварительная версия, связанная со стабильной версией. |
2014-10-20-Preview (прекращено) |
Не поддерживается после 10-10-2020 | Вторая общедоступная предварительная версия. |
2014-07-31-Preview (прекращено) |
Не поддерживается после 10-10-2020 | Первая общедоступная предварительная версия. |
Заметки о выпуске
2024-03-01-Preview
Эта предварительная версия используется 2023-10-01-preview путем добавления следующих api предварительной версии, которые помогают сэкономить место:
- Новые узкие типы данных для векторных полей , если у вас есть модели внедрения, поддерживающие их, или логика квантования, которая выводит небольшие векторы.
- Новые свойства квантования векторов для встроенного сжатия векторов в индексе поиска.
- Новое логическое хранимое свойство в векторном поле , которое определяет, хранится ли дополнительная копия поля. Дополнительная копия — это извлекаемое содержимое этого поля. Если вы не храните его, поле по-прежнему используется в запросах, но не может быть возвращено в результатах поиска. Это свойство можно задать для экономии места в службе поиска или квоте вектора в индексе поиска.
- Начиная с 29 марта 2024 г. ответы GET больше не возвращают строки подключения или ключи. Дополнительные сведения см. в статье Критическое изменение клиентского кода, который считывает сведения о подключении .
2023-11-01
Эта версия предоставляет общедоступные функции, в том числе:
- Семантический ранжирование в запросах Поиск Post.
- Индексирование векторного поиска в запросах Create или Обновления индекса и векторные запросы в запросах Поиск Post.
- Начиная с 29 марта 2024 г. ответы GET больше не возвращают строки подключения или ключи. Дополнительные сведения см. в статье Критическое изменение клиентского кода, который считывает сведения о подключении .
2023-10-01-Preview
Эта версия включает все функции, представленные в предыдущих предварительных версиях, а также дополнения и изменения в API векторного поиска. Обновления API векторного поиска являются критическим изменением по версии 2023-07-01-Preview. Сведения о миграции см. в статье Добавление векторных полей и Create векторного запроса.
Если вы планируете использовать новую возможность предварительной фильтрации, необходимо использовать индекс, созданный после 01.10.2023.
Create или обновление индекса:
vectorSearchсодержит определения дляalgorithms,profilesиvectorizers:algorithmsпродолжает поддерживатьhnswи теперь также поддерживаетeknn, в отношении иерархической навигации Small World (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".
vectorQueriesvectorsзаменяет в 2023-07-01-PreviewvectorQueries.vectorsзаменяетvectors.valuesв 2023-07-01-Preview.- Векторный запрос теперь является полиморфной структурой.
kindнеобходимо указать для обозначения типа запрашиваемого векторного запроса."kind": "vector"означает, что запрос является вектором, поэтому вызывающий объект уже должен векторизировать строку поискового запроса в векторное внедрение. "exhaustive": "true"— это новое свойство, указывающее, следует ли выполнять исчерпывающий (метод подбора) k-ближайший поиск по соседству по всем векторам в индексе вектора.vectorFilterMode— это новый параметр для указания предварительной фильтрации (по умолчанию для индексов, созданных после 2023-10-01) или постфильтрации (по умолчанию для предыдущих индексов) в запросе.
Начиная с 29 марта 2024 г. ответы GET больше не возвращают строки подключения или ключи. Дополнительные сведения см. в статье Критическое изменение клиентского кода, который считывает сведения о подключении .
2023-07-01-Preview
Важно!
Об устаревании этой предварительной версии было объявлено 15 апреля 2024 г. и она будет прекращена 8 июля 2024 г. Справку по миграции см. в статье Обновление REST API в azure AI Поиск.
Эта версия имеет функции из предыдущих предварительных версий, а также поддержку векторного поиска:
- В индексе поиска назначьте
Collection(Edm.Single)тип данных полям, содержащим массив чисел с плавающей запятой одной точности. Это тип данных для новой возможности поиска векторов, используемой для хранения одного созданного внедрения для каждого поля документа. Кроме того, в индексе поиска укажите свойства конфигурации вектора. Эти API см. в разделе Create или Индекс обновления. - Рабочие нагрузки индексирования обновляются для приема векторных данных. См. статью Добавление, обновление и удаление документов.
- Параметры запроса для поиска векторов. Эти параметры см. в разделе Документы Поиск.
- Получение статистики службы. Возвращает квоту и использование векторного индекса для службы.
- Получение статистики индекса. Возвращает квоту и использование векторного индекса для индекса поиска.
- Начиная с 29 марта 2024 г. ответы GET больше не возвращают строки подключения или ключи. Дополнительные сведения см. в статье Критическое изменение клиентского кода, который считывает сведения о подключении .
2021-04-30 (предварительная версия)
Эта предварительная версия включает все функции, появившиеся в 2020-06-30-Preview, а также дополнения к следующим API:
- Псевдоним индекса добавляет дополнительное имя, используемое для ссылок на индексы в запросах и запросах индексирования. Операции псевдонимов включают создание, обновление, удаление, получение и перечисление.
- Управляемые удостоверения для исходящих подключений. Новые значения для строк подключения в Create или обновлении источника данных поддерживают подключения с использованием Microsoft Entra ID проверки подлинности и ролей вместо жестко заданных учетных данных или ключей базы данных.
- Поддержка управляемых удостоверений также поддерживается для подключений к хранилищу ключей для решений поиска, которые дополняют шифрование по умолчанию с помощью шифрования, управляемого клиентом.
- Дополнительные языки для когнитивного навыка перевода текста.
- Дополнительные запросыLanguages для семантического поиска и средства проверки орфографии в документах Поиск (предварительная версия).
- Параметр субтитров, который при необходимости запрашивает субтитры из семантического поиска в Поиск Documents (предварительная версия).
- Семантические конфигурации указываются в Create или Update Index. Семантическая конфигурация определяет, какие поля следует использовать для семантического ранжирования, субтитров, выделения и ответов.
- Параметр semanticConfiguration, необходимый для семантических запросов в Поиск Documents (предварительная версия).
- Начиная с 29 марта 2024 г. ответы GET больше не возвращают строки подключения или ключи. Дополнительные сведения см. в статье Критическое изменение клиентского кода, который считывает сведения о подключении .
2020-06-30
Эта версия предоставляет общедоступные функции, в том числе:
- Управление доступом на основе ролей Azure для операций плоскости данных
- Оценка релевантности (BM25)
- Хранилища знаний
- Источник данных индексатора для Azure Data Lake Storage (ADLS) 2-го поколения
- Навык поиска настраиваемой сущности
- Индексаторы, работающие в системе или управляемом пользователем удостоверении через Microsoft Entra ID
- Начиная с 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 больше не возвращают строки подключения или ключи. Дополнительные сведения см. в статье Критическое изменение клиентского кода, который считывает сведения о подключении .
06.05.2019 г.
- Поддержка источника данных индексатора для API MongoDB Cosmos DB
- Источник данных индексатора для обратимого удаления собственных BLOB-объектов в хранилище BLOB-объектов
- параметр featuresMode, возвращающий подробные сведения о оценке релевантности
- Когнитивный навык Машинного обучения Azure (AML)
- Когнитивный навык обнаружения личной идентификации
- Кэшировать обогащенные документы для сохранения и повторного использования обработки изображений (и других обогащений СИ)
- Начиная с 29 марта 2024 г. ответы GET больше не возвращают строки подключения или ключи. Дополнительные сведения см. в статье Критическое изменение клиентского кода, который считывает сведения о подключении .