Konfigurieren des aktualitätsbasierten Abrufs in Azure KI-Suche (Vorschau)

Aktualitätsbewusster Abruf (Vorschau) ermöglicht es einer indizierten Wissensquelle, beim agentischen Abruf neuere Inhalte zu bevorzugen. Die Wissensquelle kann eine Aktualitätsrichtlinie enthalten, sodass Azure KI-Suche beim Ranking aktuelle Dokumente bevorzugt, ohne dass Aufrufer bei jeder Abrufanfrage benutzerdefinierte Rankinglogik senden müssen.

Aktualität ist ein Ranking-Bias, kein strenger Filter. Ältere Dokumente können weiterhin angezeigt werden, wenn sie für die Abfrage stark relevant sind.

Nutzungssupport

Voraussetzungen

• Eine indexierte Wissensquelle, die einen Azure KI-Suche Index erstellt und verwaltet, z. B. eine Blob-Wissensquelle.

• Eine Wissensbasis , die auf die Wissensquelle verweist.

• Berechtigung zum Aktualisieren von Wissensdatenbanken. Konfigurieren Sie die schlüssellose Authentifizierung mit der Rolle "Mitwirkender des Suchdiensts ", die Ihrem Benutzerkonto zugewiesen ist (empfohlen), oder verwenden Sie einen Administrator-API-Schlüssel.

Wann der aktualitätsbewusste Abruf aktiviert werden sollte

Aktivieren Sie den aktualitätsbasierten Abruf, wenn neuere Inhalte im Allgemeinen nützlicher oder vertrauenswürdiger sind als ältere Inhalte. Zu den allgemeinen Beispielen gehören Versionshinweise, Richtlinienupdates, Runbooks, Serviceratgeber und betriebstechnische Anleitungen.

Verwenden Sie Aktualität nicht als Ersatz für das Filtern. Wenn eine Abfrage nur Inhalte aus einem bestimmten Datumsbereich zurückgeben darf, verwenden Sie stattdessen einen Filter in der Anforderungs- oder Wissensquellenkonfiguration.

Konfigurieren der Aktualitätsrichtlinie

Fügen Sie der definition der indizierten Wissensquelle eine Aktualitätsrichtlinie hinzu. Der Vertrag der Vorschauversion verwendet die Richtlinie, um ein aktualitätsbasiertes Rankingsignal anzuwenden und dabei die übrige Abrufpipeline beizubehalten.

Das folgende Beispiel zeigt eine BLOB-Wissensquelle mit einer Aktualitätsrichtlinie.

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

Die Aktualitätsrichtlinie ist Teil der Quellenerfassungsparameter. Das Indexschema wird geändert, um ein generiertes Aktualitätsfeld zu unterstützen, das mit Azure KI-Suche scoring profile Aktualitätsfunktionen kompatibel ist. Der Wert boostingDuration verwendet dasselbe ISO 8601-Dauerformat wie Aktualitätsfunktionen von Bewertungsprofilen, wie z. B. P90D für 90 Tage. Aktualität fügt dem Ranking ein Aktualitätssignal hinzu, wobei die Abfragerelevanz, konfigurierte Abrufeinstellungen, semantisches Reranking und andere Rankingsignale weiterhin gelten.

Sie können boostingDuration bei einer vorhandenen Wissensquelle ändern, indem Sie eine weitere Anforderung zum Erstellen oder Aktualisieren mit dem neuen Wert übermitteln. Das Bewertungsprofil wird direkt ohne erneute Erfassung aktualisiert.

Sie können die Aktualitätsrichtlinie nicht aus einer vorhandenen Wissensquelle entfernen. Um den aktualitätsbasierten Abruf zu deaktivieren, löschen Sie die Wissensquelle und erstellen Sie eine neue ohne freshnessPolicy.

Rankingverhalten validieren

Das Aktualitätsfeld wird zum Zeitpunkt der Erfassung generiert, sodass die Richtlinie für Inhalte gilt, die nach dem Konfigurieren der Richtlinie erfasst werden. Nachdem Inhalte aufgenommen wurden, führen Sie Abrufanforderungen aus, die sowohl aktuelle als auch ältere Inhalte zurückgeben können. Eine erfolgreiche Konfiguration zeigt früher neuere relevante Dokumente an, ohne den Abruf in eine einfache Datumssortierung zu verwandeln.

Wenn die Rangfolge die Aktualität nicht wie erwartet widerspiegelt, prüfen Sie das last_modified Feld im zugrunde liegenden Index. Fehlende, veraltete oder inkonsistente Datumswerte reduzieren die Qualität des Frischesignals.

Verwandte Inhalte

• Was ist eine Wissensquelle?
• Erstellen einer Wissensbasis
• Abfragen einer Wissensbasis
• Hinzufügen von Bewertungsprofilen zum Erhöhen von Suchergebnissen