Frissességet figyelembe vevő lekérdezés konfigurálása az Azure AI Keresésben (előzetes verzió)

A frissesség-tudatos lekérés (előzetes verzió) lehetővé teszi, hogy az indexelt tudásbázisok az ügynöki lekérés során az újabb tartalmakat részesítik előnyben. A tudásforrás tartalmazhat egy frissességi szabályzatot, így az Azure AI Keresés a frissebb dokumentumok felé tereli a rangsorolást anélkül, hogy a hívóknak minden egyes lekérési kérésnél egyéni rangsorolási logikát kelljen küldeniük.

A frissesség egy rangsorolási torzítás, nem pedig egy kemény szűrő. A régebbi dokumentumok akkor is megjelenhetnek, ha azok erősen relevánsak a lekérdezés szempontjából.

Használat támogatása

Prerequisites

• Egy indexelt tudásbázis amely létrehoz és tart fenn egy Azure AI Keresés indexet, például egy blob tudásbázist.

• Egy tudásbázis , amely a tudásbázisra hivatkozik.

• Tudásbázisok frissítésének engedélye. Konfigurálja a kulcs nélküli hitelesítést a keresési szolgáltatás közreműködői szerepkörével a felhasználói fiókjához rendelve (ajánlott), vagy használjon rendszergazdai API-kulcsot.

Mikor érdemes engedélyezni a frissességet figyelembe vevő lekérést?

Frissesség-figyelő lekérés engedélyezése, ha az újabb tartalmak általában hasznosabbak vagy megbízhatóbbak, mint a régebbi tartalmak. Ilyenek például a kibocsátási megjegyzések, a szabályzatfrissítések, a runbookok, a szolgáltatástanácsadások és az üzemeltetési útmutatók.

Ne használja a frissességet a szűrés helyettesítésére. Ha egy lekérdezésnek csak egy adott dátumtartományból kell tartalmat visszaadnia, használjon szűrőt a lekérési kérelemben vagy a tudásbázis konfigurációjában.

A frissességi szabályzat konfigurálása

Frissességi szabályzat hozzáadása az indexelt tudásforrás-definícióhoz. Az előzetes szerződés a szabályzatot használja egy frissességet figyelembe vevő rangsorolási jel alkalmazására, miközben megőrzi a visszakeresési folyamat többi részét.

Az alábbi példa egy frissességi szabályzattal rendelkező blob-tudásbázist mutat be.

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);

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)

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

A frissességi szabályzat a forrásbetöltési paraméterek része. Az indexséma úgy módosul, hogy támogassa az Azure AI Keresés scoring profile frissességi függvényeivel kompatibilis generált frissességi mezőt. Az boostingDuration érték ugyanazt az ISO 8601 időtartamformátumot használja, mint a pontozási profil frissességi függvényei, például P90D 90 napig. A frissesség egy pontossági jelet ad a rangsoroláshoz, de a lekérdezés relevanciája, a konfigurált lekérési beállítások, a szemantikai reranking és más rangsorolási jelek továbbra is érvényesek.

Egy meglévő tudásbázison módosíthatja boostingDuration , ha egy másik létrehozási vagy frissítési kérést küld az új értékkel. A pontozási profil helyben frissül, anélkül hogy újbóli betöltésre lenne szükség.

A frissességi szabályzat nem távolítható el egy meglévő tudásbázisból. A frissességet figyelembe vevő lekérés letiltásához törölje a tudásforrást, majd hozzon létre egy újat freshnessPolicy nélkül.

Rangsorolási viselkedés ellenőrzése

A frissesség mező a betöltési időpontban jön létre, így a szabályzat a szabályzat életbelépése után betöltött tartalmakra vonatkozik. A tartalom betöltése után futtassa azokat a lekéréses kérelmeket, amelyek a legutóbbi és a régebbi tartalmakat is vissza tudják küldeni. A sikeres konfigurációk korábban újabb releváns dokumentumokat tárnak fel anélkül, hogy a beolvasást egyszerű dátumsorrendbe alakítanák.

Ha a rangsorolás nem a várt frissességet tükrözi, vizsgálja meg a last_modified mögöttes index mezőjét. A hiányzó, elavult vagy inkonzisztens dátumértékek csökkentik a frissesség-jel minőségét.

Kapcsolódó tartalom

• Mi az a tudásforrás?
• Tudásbázis létrehozása
• Tudásbázis lekérdezése
• Pontozási profilok hozzáadása a keresési pontszámok növeléséhez