Настройте извлечение с учетом актуальности данных в Поиск с использованием ИИ Azure (предварительная версия)

Note

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

Important

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

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

Свежесть — это предвзятость ранжирования, а не жесткий фильтр. Старые документы по-прежнему могут отображаться, когда они сильно относятся к запросу.

Поддержка использования

Портал Azure Портал Microsoft Foundry Пакет SDK для .NET Пакет SDK для Python SDK для Java Пакет SDK для JavaScript REST API
❌ ❌ ✔️ ✔️ ✔️ ✔️ ✔️

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

  • Последний пакет предварительной версии Azure.Search.Documents: dotnet add package Azure.Search.Documents --prerelease

  • Для аутентификации без использования ключа пакет Azure.Identity: dotnet add package Azure.Identity

  • Последний пакет предварительной версии azure-search-documents: pip install --pre azure-search-documents

  • Для аутентификации без использования ключа пакет azure-identity: pip install azure-identity

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

  • Для проверки подлинности без ключа добавьте маркер Microsoft Entra ID в Authorization заголовок каждого HTTP-запроса.

Когда включать поиск с учетом актуальности

Включите получение с учетом свежести, когда более новое содержимое обычно является более полезным или надежным, чем старое содержимое. Распространённые примеры включают примечания к выпуску, обновления политик, эксплуатационные инструкции, служебные уведомления и операционные рекомендации.

Не используйте свежесть в качестве замены для фильтрации. Если запрос должен возвращать содержимое только из определенного диапазона дат, используйте фильтр в конфигурации источника знаний или запроса извлечения.

Настройка политики свежести

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

В следующем примере показан источник знаний для больших двоичных объектов с политикой свежести.

var knowledgeSource = new AzureBlobKnowledgeSource(
    name: "news-articles-ks",
    azureBlobParameters: new AzureBlobKnowledgeSourceParameters(connectionString: blobConnectionString, containerName: "news")
    {
        IngestionParameters = new IngestionParameters
        {
            FreshnessPolicy = new FreshnessPolicy
            {
                BoostingDuration = TimeSpan.FromDays(90)
            }
        }
    }
)
{
    Description = "A knowledge source for recent news articles."
};

await indexClient.CreateOrUpdateKnowledgeSourceAsync(knowledgeSource);

Справочник:AzureBlobKnowledgeSourceParameters

knowledge_source = AzureBlobKnowledgeSource(
    name="news-articles-ks",
    description="A knowledge source for recent news articles.",
    azure_blob_parameters=AzureBlobKnowledgeSourceParameters(
        connection_string=blob_connection_string,
        container_name="news",
        ingestion_parameters=IngestionParameters(
            freshness_policy=FreshnessPolicy(boosting_duration="P90D"),
        ),
    ),
)

index_client.create_or_update_knowledge_source(knowledge_source)

Справочник:AzureBlobKnowledgeSourceParameters

PUT {{search-endpoint}}/knowledgesources/news-articles-ks?api-version=2026-08-01-preview
Content-Type: application/json
Authorization: Bearer {{search-access-token}}

{
  "name": "news-articles-ks",
  "kind": "azureBlob",
  "description": "A knowledge source for recent news articles.",
  "azureBlobParameters": {
    "connectionString": "{{blob-connection-string}}",
    "containerName": "news",
    "ingestionParameters": {
      "freshnessPolicy": {
        "boostingDuration": "P90D"
      }
    }
  }
}

Справочник:Источники знаний — создание или обновление

Политика актуальности входит в состав параметров приёма данных из источника. Схема индекса изменена для поддержки генерируемого поля freshness, совместимого с функциями freshness в профилях оценки Поиск с использованием ИИ Azure. Значение boostingDuration использует тот же формат длительности ISO 8601, что и функции свежести профиля оценки, например P90D для 90 дней. Фактор свежести добавляет в ранжирование сигнал актуальности, но релевантность запроса, настроенные параметры извлечения, семантическое переранжирование и другие сигналы ранжирования по-прежнему учитываются.

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

Политику свежести нельзя удалить из существующего источника знаний. Чтобы отключить получение с учетом свежести, удалите источник знаний и создайте новый без freshnessPolicy.

Проверка поведения ранжирования

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

Если ранжирование не отражает свежесть, как ожидалось, проверьте last_modified поле в базовом индексе. Отсутствующие, устаревшие или несогласованные значения дат снижают качество сигнала свежести.