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

Note

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

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

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

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

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

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