Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
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, например источник знаний для BLOB-объектов.
База знаний, ссылающаяся на источник знаний.
Разрешение на обновление баз знаний. Настройте проверку подлинности без ключа с помощью роли участника службы поиска , назначенной учетной записи пользователя (рекомендуется) или используйте ключ 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 поле в базовом индексе. Отсутствующие, устаревшие или несогласованные значения дат снижают качество сигнала свежести.