Поделиться через

Перенос семантического ранжирования кода из предыдущих версий

  • Статья

Если код семантического ранжирования был написан для api ранних предварительных версий, эта статья определяет изменения кода, необходимые для миграции на более новые версии API. Критические изменения для семантического рангера ограничены логикой запросов в последних API, но если код был написан в начальной предварительной версии, может потребоваться также изменить семантику конфигурации.

Критические изменения

Существует два критических изменения для семантического ранджера в версиях REST API:

  • searchFields заменен на semanticConfiguration 2021-04-30-preview
  • queryLanguage был проигнорирован начиная с 2023-07-01-preview, но восстановлен для перезаписи запросов в 2024-11-01-preview

Другие обновления, относящиеся к версии, относятся к новым возможностям, но не прерывают существующий код и поэтому не нарушают изменения.

Если вы используете пакеты SDK Azure, несколько API были переименованы со временем. Журналы изменений пакета SDK предоставляют сведения.

Версии API, обеспечивающие семантический ранжирование

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

Тип выпуска Версия API REST Обновления семантического ранга
начальный 2020-06-30-preview Добавляется queryType=semantic в документы поиска
предварительный просмотр 2021-04-30-preview Добавляется semanticConfiguration в индекс создания или обновления
предварительный просмотр 2023-07-01-preview Обновляет semanticConfiguration. Начиная с 14 июля 2023 г. обновления для семантических моделей, размещенных корпорацией Майкрософт, сделали семантику языка рангировщика без учета, эффективно выводя queryLanguage свойство для семантического ранжирования. В коде нет критического изменения, но свойство игнорируется. Клиентам рекомендуется удалить это свойство из кода.
предварительный просмотр 2023-10-01-preview Добавляется semanticQuery для отправки запроса, используемого только для повторного использования.
stable 2023-11-01 Общедоступная версия. Внесены изменения, внесенные в semanticConfiguration стабильную версию. Если код предназначен для этой версии или более поздней версии, он совместим с более новыми версиями API, если вы не используете новые функции предварительной версии.
предварительный просмотр 2024-05-01-preview Без изменений
stable 2024-07-01 Без изменений
предварительный просмотр 2024-09-01-preview Без изменений
предварительный просмотр 2024-11-01-preview Добавляет перезапись запросов. Теперь queryLanguage это свойство необходимо, если вы используете перезапись запросов (предварительная версия).

Журналы изменений для пакетов SDK Azure

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

2024-11-01-preview

  • Добавляет перезапись запросов в документы поиска.
  • Требуется queryLanguage для перезаписи рабочих нагрузок запроса. Список допустимых значений см. в REST API.

2024-09-01-preview

Никаких изменений в синтаксисе семантического ранжирования из стабильной версии 2024-07-01.

2024-07-01

Никаких изменений в синтаксисе семантического ранжирования с версии 2024-05-01-preview.

Не используйте эту версию API. Он реализует синтаксис векторного запроса, несовместимый с любой новой версией API.

2024-05-01-preview

Никаких изменений в синтаксисе семантического ранжирования с версии 2024-03-01-preview.

2024-03-01-preview

Никаких изменений в синтаксисе семантического ранжирования с версии 2023-10-01-preview, но векторные запросы представлены. Семантический ранжирование теперь применяется к ответам из гибридных и векторных запросов. Вы можете применить повторную настройку для любых текстовых полей, доступных для чтения пользователем, в ответе, при условии, что в них перечислены prioritizedFieldsполя.

2023-11-01

  • Исключает и semanticQueryв противном случае совпадает SemanticDebug с версией 2023-10-01-preview.

2023-10-01-preview

  • Добавляет semanticQuery

2023-07-01-preview

  • Добавляет semanticErrorHandling, semanticMaxWaitInMilliseconds.
  • Добавляет в ответ многочисленные семантические поля, такие как SemanticDebug и SemanticErrorMode.
  • Игнорирует queryLanguage, он больше не используется в семантическом ранжировании.

Начиная с 14 июля 2023 г., семантический рангер является неуклюжным языком. В предварительных версиях семантический ранжирование будет отменять результаты, отличающиеся от querylanguage заданных анализатором полей. queryLanguage Однако свойство по-прежнему применимо к исправлению орфографии и краткому списку языков, поддерживаемых этой функцией.

2021-04-30-preview

  • Семантическая поддержка осуществляется с помощью вызовов API поиска документов и создания или обновления индекса предварительной версии API.
  • Добавляется semanticConfiguration в индекс поиска. Семантическая конфигурация имеет имя и список полей с приоритетом.
  • Добавляет "'приоритетыfields".

Свойство searchFields больше не используется для определения приоритета полей. Во всех версиях перемещается searchFields вперед, semanticConfiguration.prioritizedFields заменяется механизмом указания полей, используемых для ранжирования L2.

2020-06-30-preview

  • Семантическая поддержка — это вызов API предварительной версии поиска документов .
  • Добавляется queryType=semantic в запрос запроса.
  • Адаптируется searchFields таким образом, чтобы если тип запроса был семантикой, searchFields свойство определяет порядок приоритета входных данных поля для семантического рангера.
  • Добавляет и answershighlights в captionsответ запроса.

Следующие шаги

Проверьте миграцию семантической конфигурации, выполнив семантический запрос.

Создание семантического запроса