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
Foundry IQ (Wyszukiwanie AI platformy Azure) udostępnia bezpośrednie interfejsy API indeksowania i zapytań, a także interfejsy API wyższego poziomu dla źródeł wiedzy i baz wiedzy do zarządzanego pobierania. Użyj portalu Azure, interfejsów API REST lub Azure SDKs, aby skonfigurować te możliwości lub połączyć agentów z bazami wiedzy w portalu Microsoft Foundry.
Ważna
Pobieranie uwzględniające aktualność jest w publicznej wersji zapoznawczej i podlega Dodatkowym warunkom korzystania z wersji zapoznawczych Microsoft Azure. Aby zapoznać się z terminami wersji zapoznawczej specyficznymi dla tej funkcji, zobacz Funkcjonalność w wersji zapoznawczej.
Pobieranie ze świadomością aktualności (wersja zapoznawcza) umożliwia indeksowanemu źródłu wiedzy preferowanie nowszej zawartości podczas pobierania agentowego. Źródło wiedzy może zawierać zasady świeżości, dzięki czemu usługa Foundry IQ (Wyszukiwanie AI platformy Azure) uprzedza klasyfikację w stosunku do ostatnich dokumentów bez konieczności wysyłania niestandardowej logiki klasyfikacji dla każdego żądania pobierania.
Ś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
| Azure portal | portal Microsoft Foundry | zestaw SDK .NET | Python SDK | Java SDK | JavaScript SDK | REST API |
|---|---|---|---|---|---|---|
| ❌ | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
Wymagania wstępne
Indeksowane źródło wiedzy, które tworzy i utrzymuje indeks IQ usługi Foundry, taki jak źródło wiedzy obiektu 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
Wersja 2026-11-01-preview interfejsu API REST usługi wyszukiwania.
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-11-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"
}
}
}
}
Zasady świeżości są częścią parametrów pozyskiwania źródła. Schemat indeksu jest modyfikowany w celu obsługi wygenerowanego pola świeżości zgodnego z funkcjami świeżości profilu oceniania IQ rozwiązania Foundry. 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.