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

Если код семантического ранжирования был написан для 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-превью Обновляет semanticConfiguration. Начиная с 14 июля 2023 г. обновления семантических моделей, размещённых на платформе Майкрософт, сделали ранжировщик независимым от языка, фактически выводя из эксплуатации свойство queryLanguage для семантического ранжирования. В коде нет изменения, нарушающего совместимость, но свойство игнорируется. Клиентам рекомендуется удалить это свойство из кода.
предварительный просмотр 2023-10-01-превью Добавляется semanticQuery для отправки запроса, используемого исключительно для повторного ранжирования.
стабильный 2023-11-01 Доступно для всех. Представлены изменения в semanticConfiguration, которые привели к стабильной версии. Если код предназначен для этой версии или более поздней версии, он совместим с более новыми версиями API, если вы не используете новые функции предварительной версии.
предварительный просмотр 2024-05-01-preview Без изменений
стабильный 2024-07-01 Без изменений
предварительный просмотр 2024-09-01-превью Без изменений
предварительный просмотр 2024-11-01-preview Добавляет функцию переписывания запросов. Теперь queryLanguage это свойство необходимо, если вы используете переформулировку запроса (предварительный просмотр).
предварительный просмотр 2025-03-01-preview Добавляет возможность согласия на предрелизные версии семантических моделей.
предварительный просмотр 2025-05-01-превью В этой предварительной версии обновления API отсутствуют, но семантическое ранжирование теперь имеет лучшую интеграцию с профилями оценки.
предварительный просмотр 2025-08-01-preview Без изменений
предварительный просмотр 2025-11-01-превью Доступно на бесплатных уровнях.

Изменения в SDK Azure

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

2024-11-01-предварительный просмотр

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

2024-09-01-предварительный просмотр

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

01.07.2024

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

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

2024-05-01-preview

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

2024-03-01-предварительная версия

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

2023-11-01

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

2023-10-01-preview

  • Добавляет semanticQuery

2023-07-01-предварительный просмотр

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

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

2021-04-30-предварительная версия

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

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

2020-06-30-предварительный просмотр

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

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

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

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

  • Last updated on