Настройка семантического рангера и возвращаемых подписей в результатах поиска

Семантическое ранжирование осуществляет итерацию по начальному результирующему набору, применяя метод L2 ранжирования, который способствует выводу наиболее семантически релевантных результатов на верх стека. Кроме того, вы можете получить семантические заголовки с выделением наиболее релевантных терминов и фраз, а также семантических ответов.

В этой статье объясняется, как настроить индекс поиска для семантического перепорядочивания.

Необходимые условия

• Поиск с использованием ИИ Azure в любом регионе, обеспечивающем семантический рейтинг.

• Существующий индекс поиска с форматированным текстовым содержимым. Семантический ранжирование применяется к полям строк (невектора) и лучше всего подходит для содержимого, который является информационным или описательным.

• Разрешение на создание и использование объектов в Поиск с использованием ИИ Azure. Рекомендуется использовать доступ на основе ролей, но можно использовать ключи API, если назначение роли невозможно. Дополнительные сведения см. в разделе "Подключение к службе поиска".

• 2026-08-01-preview — версия REST API службы поиска.

Выбор клиента

Вы можете указать семантику конфигурации для новых или существующих индексов с помощью любого из следующих средств и пакетов SDK для добавления семантической конфигурации:

• В портале Azure используйте конструктор индексов для добавления семантической конфигурации.
• Visual Studio Code с REST-клиентом и API для создания или обновления индекса (REST).
• Azure SDK для .NET
• Azure SDK для Python
• Azure SDK для Java
• Azure SDK для JavaScript

Добавление семантической конфигурации

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

Для других рабочих нагрузок можно настроить семантику самостоятельно. Семантическая конфигурация — это раздел в индексе, который устанавливает входные данные поля, используемые для семантического ранжирования. Вы можете добавлять или обновлять семантическую конфигурацию в любое время, перестроение не требуется. При создании нескольких конфигураций можно указать значение по умолчанию. Во время запроса укажите семантику конфигурации запроса или оставьте ее пустой, чтобы использовать значение по умолчанию.

Вы можете создать до 100 семантических конфигураций в одном индексе.

Семантическая конфигурация имеет имя и следующие свойства:

Можно указать только одно поле заголовка, но вы можете иметь столько полей содержимого и ключевых слов, сколько вам нравится. Для полей содержимого и ключевых слов выведите список полей в порядке приоритета, так как поля с низким приоритетом могут быть усечены.

Во всех свойствах семантической конфигурации назначаемые вами поля должны быть:

• Указано как searchable и retrievable
• Строки типа Edm.String, Collection(Edm.String), и строковые подфилды Edm.ComplexType

string indexName = "hotel";
SearchIndex searchIndex = new(indexName)
{
    Fields =
    {
        new SimpleField("HotelId", SearchFieldDataType.String) { IsKey = true, IsFilterable = true, IsSortable = true, IsFacetable = true },
        new SearchableField("HotelName") { IsFilterable = true, IsSortable = true },
        new SearchableField("Description") { IsFilterable = true },
        new SearchableField("Category") { IsFilterable = true, IsSortable = true, IsFacetable = true },
    },
    SemanticSearch = new()
    {
        Configurations =
        {
            new SemanticConfiguration("my-semantic-config", new()
            {
                TitleField = new SemanticField("HotelName"),
                ContentFields =
                {
                    new SemanticField("Description")
                },
                KeywordsFields =
                {
                    new SemanticField("Category")
                }
            })
        }
    }
};

Подписаться на предварительную версию модели семантического ранжирования

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

Свойство конфигурации имеет значение "flightingOptIn": true, и оно задано в разделе семантической конфигурации индекса. Свойство имеет значение NULL или false по умолчанию. Вы можете установить значение true в запросе на создание или обновление в любое время, и это влияет на семантические запросы в будущем, при условии, что запрос предусматривает конфигурацию семантики, которая включает это свойство.

PUT https://myservice.search.windows.net/indexes('hotels')?allowIndexDowntime=False&api-version=2026-08-01-preview

{
  "name": "hotels",
  "fields": [ ],
  "scoringProfiles": [ ],
  "defaultScoringProfile": "geo",
  "suggesters": [ ],
  "analyzers": [ ],
  "corsOptions": { },
  "encryptionKey": { },
  "similarity": { },
  "semantic": {
    "configurations": [
      {
        "name": "semanticHotels",
        "prioritizedFields": {
          "titleField": {
            "fieldName": "hotelName"
          },
        "prioritizedContentFields": [
            {
              "fieldName": "description"
            },
            {
              "fieldName": "description_fr"
            }
          ],
        "prioritizedKeywordsFields": [
            {
              "fieldName": "tags"
            },
            {
              "fieldName": "category"
            }
          ],
        "flightingOptIn": true
        }
      }
    ]
  },
  "vectorSearch": {  }
}

Дальнейшие действия

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