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

Note

Foundry IQ (Azure KI-Suche) bietet direkte Indizierungs- und Abfrage-APIs zusammen mit Wissensquellen- und Knowledge Base-APIs auf höherer Ebene für den verwalteten Abruf. Verwenden Sie das Azure Portal, REST-APIs oder Azure SDKs, um diese Funktionen zu konfigurieren, oder verbinden Sie Agents mit Wissensdatenbanken im Microsoft Foundry-Portal.

Important

Die aktualitätsbewusste Abrufung ist in der öffentlichen Vorschau enthalten und unterliegt den ergänzenden Nutzungsbedingungen für Microsoft Azure Previews.

Die für dieses Feature geltenden Vorschaubedingungen finden Sie unter Previewfunktionalität.

Aktualitätsbewusster Abruf (Vorschau) kann eine indizierte Wissensquelle während des agentischen Abrufs neuere Inhalte bevorzugen. Die Wissensquelle kann eine Aktualitätsrichtlinie enthalten, sodass Foundry IQ (Azure KI-Suche) die Rangfolge zugunsten neuerer Dokumente gewichtet, ohne dass Aufrufer benutzerdefinierte Bewertungslogik für jede Abrufanforderung 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

Azure Portal Microsoft Foundry-Portal .NET SDK Python SDK Java SDK JavaScript SDK REST-API
❌ ❌ ✔️ ✔️ ✔️ ✔️ ✔️

Voraussetzungen

  • Das neueste Azure.Search.Documents Vorschaupaket: dotnet add package Azure.Search.Documents --prerelease

  • Für die schlüssellose Authentifizierung das Paket Azure.Identity: dotnet add package Azure.Identity

  • Das neueste azure-search-documents Vorschaupaket: pip install --pre azure-search-documents

  • Für die schlüssellose Authentifizierung das Paket azure-identity: pip install azure-identity

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

Referenz: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)

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

Referenz:Wissensquellen – Erstellen oder Aktualisieren

Die Aktualitätsrichtlinie ist Teil der Quellenerfassungsparameter. Das Indexschema wird so geändert, dass ein generiertes Frischefeld unterstützt wird, das mit den Aktualitätsfunktionen des Foundry IQ-Bewertungsprofils 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.