Konfigurowanie pobierania z uwzględnieniem aktualności w Foundry IQ (Wyszukiwanie AI platformy Azure) (wersja zapoznawcza)

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

  • Najnowszy pakiet Azure.Search.Documents wersji zapoznawczej: dotnet add package Azure.Search.Documents --prerelease

  • W przypadku uwierzytelniania bezkluczowego pakiet Azure.Identity: dotnet add package Azure.Identity

  • Najnowszy pakiet azure-search-documents wersji zapoznawczej: pip install --pre azure-search-documents

  • W przypadku uwierzytelniania bezkluczowego pakiet azure-identity: pip install azure-identity

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"
      }
    }
  }
}

Odwołanie:Źródła wiedzy — tworzenie lub aktualizowanie

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.