Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Note
Wyszukiwanie AI platformy Azure jest dostępna za pośrednictwem portalu Azure, interfejsów API REST i Azure SDKs. Jest także podstawą Foundry IQ — zarządzanej warstwy wiedzy, która przekształca treści przedsiębiorstwa w bazy wiedzy wielokrotnego użytku z uwzględnieniem uprawnień dla agentów w portalu Microsoft Foundry.
Ważna
Funkcje, możliwości lub właściwości oznaczone (wersja zapoznawcza) nie są objęte umową dotyczącą poziomu usług, nie są zalecane w przypadku obciążeń produkcyjnych i mogą ulec zmianie lub ograniczeniu, zanim staną się one ogólnie dostępne. Warunki Wyszukiwanie AI platformy Azure wersji zapoznawczej mają zastosowanie do wszystkich funkcji w wersji zapoznawczej, niezależnie od tego, czy jest ona autonomiczna, czy częścią ogólnie dostępnej funkcji.
Wyszukiwanie uwzględniające aktualność (wersja zapoznawcza) pozwala indeksowanemu źródłu wiedzy preferować nowsze treści podczas wyszukiwania przez agenta. Źródło wiedzy może zawierać zasady aktualności, dzięki czemu usługa Wyszukiwanie AI platformy Azure faworyzuje w rankingu nowsze dokumenty bez konieczności wysyłania przez wywołujących niestandardowej logiki ustalania rankingu w każdym żądaniu pobrania.
Świeżość jest czynnikiem wpływającym na ranking, a nie sztywnym filtrem. Starsze dokumenty mogą być nadal wyświetlane, gdy są one silnie istotne dla zapytania.
Wsparcie użytkowania
| Portal Azure | Portal Microsoft Foundry | .NET SDK | SDK języka Python | SDK Java | JavaScript SDK | API REST |
|---|---|---|---|---|---|---|
| ❌ | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
Wymagania wstępne
Indeksowane źródło wiedzy, które tworzy i utrzymuje indeks usługi Wyszukiwanie AI platformy Azure, takie jak źródło wiedzy obiektów blob.
Baza wiedzy, która odwołuje się do źródła wiedzy.
Uprawnienie do aktualizowania baz wiedzy. Skonfiguruj uwierzytelnianie bez klucza przy użyciu roli Współautor usługi wyszukiwania przypisanej do konta użytkownika (zalecane) lub użyj klucza interfejsu API administratora.
Najnowszy pakiet
Azure.Search.Documentswersji zapoznawczej:dotnet add package Azure.Search.Documents --prereleaseW przypadku uwierzytelniania bezkluczowego pakiet
Azure.Identity:dotnet add package Azure.Identity
Najnowszy pakiet
azure-search-documentswersji zapoznawczej:pip install --pre azure-search-documentsW przypadku uwierzytelniania bezkluczowego pakiet
azure-identity:pip install azure-identity
Interfejs API REST usługi Search w wersji 2026-08-01-preview.
W przypadku uwierzytelniania bez klucza dołącz token Microsoft Entra ID w nagłówku
Authorizationkażdego żądania HTTP.
Kiedy włączyć pobieranie uwzględniające aktualność danych
Włącz pobieranie z rozpoznawaniem aktualności, gdy nowsza zawartość jest ogólnie bardziej przydatna lub godna zaufania niż starsza zawartość. Typowe przykłady obejmują informacje o wydaniu, aktualizacje zasad, procedury operacyjne, komunikaty dotyczące usług i wskazówki operacyjne.
Nie używaj świeżości jako zamiennika do filtrowania. Jeśli zapytanie musi zwracać zawartość tylko z określonego zakresu dat, użyj filtru w konfiguracji żądania pobierania lub źródła wiedzy.
Konfigurowanie zasad aktualności
Dodaj zasady świeżości do indeksowanej definicji źródła wiedzy. Umowa w wersji zapoznawczej wykorzystuje politykę, aby zastosować sygnał rankingowy uwzględniający aktualność, przy zachowaniu pozostałych elementów potoku pobierania.
Poniższy przykład przedstawia źródło wiedzy dla obiektów blob z zasadą aktualności.
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);
Dokumentacja: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)
Dokumentacja: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"
}
}
}
}
Dokumentacja:Źródła wiedzy — tworzenie lub aktualizowanie
Zasady świeżości są częścią parametrów pozyskiwania źródła. Schemat indeksu został zmodyfikowany tak, aby obsługiwać wygenerowane pole aktualności zgodne z funkcjami aktualności w profilu oceniania Wyszukiwanie AI platformy Azure scoring profile. Wartość boostingDuration ma ten sam format czasu trwania zgodny z normą ISO 8601 co funkcje świeżości profilu oceniania, na przykład P90D dla 90 dni. Świeżość dodaje do rankingu sygnał aktualności, ale nadal są stosowane istotność zapytania, skonfigurowane ustawienia pobierania, semantyczne ponowne porządkowanie wyników i inne sygnały rankingowe.
Możesz zmienić boostingDuration istniejące źródło wiedzy, wysyłając kolejne żądanie tworzenia lub aktualizacji przy użyciu nowej wartości. Profil oceniania jest aktualizowany na miejscu bez konieczności ponownego pozyskiwania danych.
Nie można usunąć zasad aktualności z istniejącego źródła wiedzy. Aby wyłączyć pobieranie zależne od aktualności, usuń źródło wiedzy i utwórz nowe bez freshnessPolicy.
Weryfikacja działania rankingu
Pole Freshness jest generowane podczas pozyskiwania danych, więc ta zasada ma zastosowanie do treści pozyskanych po jej wprowadzeniu. Po pozyskaniu treści uruchom żądania pobierania, które mogą zwracać zarówno nowsze, jak i starsze treści. Właściwa konfiguracja sprawia, że nowsze, trafne dokumenty pojawiają się na wcześniejszych pozycjach, nie sprowadzając wyszukiwania do zwykłego sortowania według daty.
Jeśli ranking nie odzwierciedla świeżości w oczekiwanym stopniu, sprawdź pole last_modified w indeksie źródłowym. Brakujące, nieaktualne lub niespójne wartości daty zmniejszają jakość sygnału świeżości.