Configurare la ricerca basata sulla freschezza in Azure AI Search (anteprima)

Il recupero sensibile alla freschezza (anteprima) consente a una fonte di conoscenza indicizzata di privilegiare i contenuti più recenti durante il recupero agentico. L'origine di conoscenza può includere un criterio di aggiornamento, in modo che Azure AI Search favorisca nel ranking i documenti più recenti senza richiedere ai chiamanti di inviare una logica di ranking personalizzata a ogni richiesta di recupero.

La freschezza è una distorsione di classificazione, non un filtro rigido. I documenti meno recenti possono comunque essere visualizzati quando sono fortemente rilevanti per la query.

Supporto per l'utilizzo

Prerequisiti

• Una fonte di conoscenza indicizzata che crea e gestisce un indice di Azure AI Search, come ad esempio una fonte di conoscenza di tipo blob.

• Una base di conoscenza che fa riferimento alla fonte di conoscenza.

• Autorizzazione per aggiornare le knowledge base. Configurare l'autenticazione senza chiave con il ruolo Collaboratore servizio di ricerca assegnato all'account utente (scelta consigliata) o usare una chiave API amministratore.

Quando attivare il recupero basato sulla freschezza

Abilitare il recupero con riconoscimento dell'aggiornamento quando il contenuto più recente è in genere più utile o affidabile rispetto al contenuto meno recente. Esempi comuni includono note di rilascio, aggiornamenti delle politiche, procedure operative, avvisi di servizio e linee guida operative.

Non sostituire il filtraggio con la freschezza. Se una query deve restituire solo contenuti relativi a uno specifico intervallo di date, utilizza invece un filtro nella richiesta di recupero o nella configurazione dell’origine della knowledge base.

Configura il criterio di freschezza

Aggiungere un criterio di aggiornamento alla definizione dell'origine delle informazioni indicizzata. Il contratto di anteprima utilizza questa strategia per applicare un segnale di ranking che tiene conto della recency, mantenendo inalterata il resto della pipeline di recupero.

L'esempio seguente mostra una fonte delle informazioni di tipo blob con una politica di aggiornamento.

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 politica sulla freschezza fa parte dei parametri di acquisizione dei dati. Lo schema dell'indice viene modificato per supportare un campo di freschezza generato compatibile con le funzioni di freschezza del scoring profile di Azure AI Search. Il valore boostingDuration usa lo stesso formato di durata ISO 8601 delle funzioni di freschezza del profilo di assegnazione dei punteggi, ad esempio P90D per 90 giorni. La freschezza aggiunge un segnale di attualità al ranking, ma la pertinenza della query, le impostazioni di ricerca configurate, il riordino semantico e altri segnali di ranking continuano a essere applicati.

È possibile modificare boostingDuration in un'origine di conoscenza esistente inviando un'altra richiesta di creazione o aggiornamento con il nuovo valore. Il profilo di punteggio viene aggiornato direttamente senza richiedere una nuova acquisizione dei dati.

Non è possibile rimuovere il criterio di aggiornamento da una fonte di conoscenza esistente. Per disattivare il recupero basato sull'aggiornamento dei dati, eliminare la fonte di conoscenza e crearne una nuova senza il tag freshnessPolicy.

Convalidare il comportamento di classificazione

Il campo "freschezza" viene generato al momento dell'acquisizione, pertanto la politica si applica ai contenuti acquisiti dopo la sua entrata in vigore. Dopo l'inserimento del contenuto, eseguire le richieste di recupero che possono restituire contenuto recente e precedente. Una configurazione corretta visualizza i documenti pertinenti più recenti in precedenza senza trasformare il recupero in un ordinamento di data semplice.

Se la classificazione non riflette la freschezza come previsto, esaminare il last_modified campo nell'indice sottostante. I valori di data mancanti, non aggiornati o incoerenti riducono la qualità del segnale di aggiornamento.

Contenuti correlati

• Che cos'è un'origine delle conoscenze?
• Creare una knowledge base
• Interrogare una base di conoscenza
• Aggiungere profili di punteggio per incrementare i punteggi di ricerca