Konfigurowanie pobierania z rozpoznawaniem aktualności w Wyszukiwanie AI platformy Azure (wersja zapoznawcza)

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

  • 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-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.