Configurer une recherche basée sur la fraîcheur dans Recherche Azure AI (version préliminaire)

La récupération tenant compte de la fraîcheur (version préliminaire) permet à une source de connaissances indexée de privilégier les contenus les plus récents lors de la récupération par l’agent. La source de connaissances peut inclure une stratégie de fraîcheur afin que Recherche Azure AI biaise le classement vers les documents récents sans exiger que les appelants envoient une logique de classement personnalisée sur chaque demande de récupération.

La fraîcheur est un biais de classement, pas un filtre strict. Les documents plus anciens peuvent toujours apparaître lorsqu’ils sont fortement pertinents pour la requête.

Assistance à l'utilisation

Prerequisites

• Source de connaissances indexée qui crée et gère un index Recherche Azure AI, tel qu’une source de connaissances blob.

• Base de connaissances qui fait référence à la source de connaissances.

• Autorisation de mettre à jour les bases de connaissances. Configurez l’authentification sans clé avec le rôle Contributeur de service de recherche affecté à votre compte d’utilisateur (recommandé) ou utilisez une clé API d’administration.

Quand activer la récupération tenant compte de la fraîcheur

Activez la récupération sensible à la fraîcheur lorsque le contenu plus récent est généralement plus utile ou fiable que le contenu plus ancien. Les exemples courants incluent des notes de publication, des mises à jour de stratégie, des runbooks, des avis de service et des conseils opérationnels.

N’utilisez pas de fraîcheur comme remplacement du filtrage. Si une requête ne doit retourner du contenu qu’à partir d’une plage de dates spécifique, utilisez un filtre dans la configuration de la demande de récupération ou de la source de connaissances à la place.

Configurer la stratégie d’actualisation

Ajoutez une stratégie de fraîcheur à la définition de la source de connaissances indexée. Le contrat de préversion utilise la stratégie pour appliquer un signal de classement tenant compte de la récence tout en préservant le reste du pipeline de récupération.

L’exemple suivant montre une source de connaissances Blob avec une stratégie d’actualisation.

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

La stratégie de fraîcheur fait partie des paramètres d’ingestion de la source. Le schéma d’index est modifié pour prendre en charge un champ de fraîcheur généré compatible avec les fonctions de fraîcheur des profils de score d’Recherche Azure AI. La boostingDuration valeur utilise le même format de durée ISO 8601 que les fonctions d’actualisation du profil de scoring, telles que P90D pendant 90 jours. L’actualisation ajoute un signal de récurrence au classement, mais la pertinence des requêtes, les paramètres de récupération configurés, la reclassement sémantique et d’autres signaux de classement s’appliquent toujours.

Vous pouvez modifier boostingDuration une source de connaissances existante en envoyant une autre demande de création ou mise à jour avec la nouvelle valeur. Le profil de notation est mis à jour en place sans nécessiter une nouvelle ingestion.

Vous ne pouvez pas supprimer la stratégie d’actualisation d’une source de connaissances existante. Pour désactiver la récupération tenant compte de la fraîcheur, supprimez la source de connaissances et créez-en une nouvelle sans freshnessPolicy.

Valider le comportement de classement

Le champ de fraîcheur est généré au moment de l’ingestion, de sorte que la stratégie s’applique au contenu ingéré après la mise en place de la stratégie. Une fois le contenu ingéré, exécutez les demandes de récupération qui peuvent retourner du contenu récent et plus ancien. Une configuration réussie expose les documents pertinents plus récents plus tôt sans transformer la récupération en un tri de date simple.

Si le classement ne reflète pas la fraîcheur comme prévu, inspectez le last_modified champ dans l’index sous-jacent. Les valeurs de date manquantes, obsolètes ou incohérentes réduisent la qualité du signal de fraîcheur.

Contenu connexe

• Qu’est-ce qu’une source de connaissances ?
• Créer une base de connaissances
• Interroger une base de connaissances
• Ajouter des profils de scoring pour améliorer les scores de recherche