Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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
Eine indizierte Wissensquelle , die einen Foundry IQ-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.
Das neueste
Azure.Search.DocumentsVorschaupaket:dotnet add package Azure.Search.Documents --prereleaseFür die schlüssellose Authentifizierung das Paket
Azure.Identity:dotnet add package Azure.Identity
Das neueste
azure-search-documentsVorschaupaket:pip install --pre azure-search-documentsFür die schlüssellose Authentifizierung das Paket
azure-identity:pip install azure-identity
Die 2026-11-01-preview-Version der REST-API des Suchdiensts.
Fügen Sie für die schlüssellose Authentifizierung ein Microsoft Entra ID-Token in den
AuthorizationHeader jeder HTTP-Anforderung ein.
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"
}
}
}
}
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.