Configurar a recuperação sensível à frescura no Pesquisa de IA do Azure (pré-visualização)

Recuperação sensível à atualidade (versão preliminar) permite que uma fonte de conhecimento indexada dê preferência a conteúdos mais recentes durante a recuperação por agentes. A fonte de conhecimento pode incluir uma política de atualidade para que o Pesquisa de IA do Azure favoreça os documentos mais recentes na classificação, sem exigir que os chamadores enviem lógica de classificação personalizada em cada pedido de obtenção.

A frescura é um viés de classificação, não um filtro rígido. Documentos mais antigos ainda podem aparecer quando são fortemente relevantes para a consulta.

Suporte de utilização

Pré-requisitos

• Uma fonte de conhecimento indexada que cria e mantém um índice do Pesquisa de IA do Azure, como uma fonte de conhecimento de blobs.

• Uma base de conhecimento que faz referência à fonte de conhecimento.

• Permissão para atualizar bases de conhecimento. Configure a autenticação sem chave com o papel de Contribuidor do Serviço de Pesquisa atribuído à sua conta de utilizador (recomendado) ou utilize uma chave API de administrador.

Quando permitir a recuperação consciente da frescura

Ative a recuperação sensível à atualidade quando o conteúdo mais recente for geralmente mais útil ou fiável do que o conteúdo mais antigo. Exemplos comuns incluem notas de release, atualizações de políticas, runbooks, avisos de serviço e orientações operacionais.

Não uses frescura como substituto do filtro. Se uma consulta tiver de devolver apenas conteúdo de um intervalo de datas específico, use um filtro na configuração de pedido de recuperação ou na fonte de conhecimento.

Configurar a política de frescura

Adicione uma política de frescura à definição de fonte de conhecimento indexada. O contrato de visualização prévia utiliza a política para aplicar um sinal de classificação sensível à atualidade, preservando o restante processo de recuperação.

O exemplo seguinte mostra uma fonte de conhecimento de blob com uma política de frescura.

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

A política de frescura faz parte dos parâmetros de ingestão de origem. O esquema do índice é alterado para suportar um campo de atualização gerado compatível com as funções de atualização do scoring profile do Pesquisa de IA do Azure. O valor boostingDuration utiliza o mesmo formato de duração ISO 8601 que as funções de atualidade do perfil de pontuação, como, por exemplo, P90D para 90 dias. A frescura acrescenta um sinal de recência à classificação, mas a relevância da consulta, definições de recuperação configuradas, reclassificação semântica e outros sinais de classificação continuam a aplicar-se.

Pode alterar boostingDuration numa fonte de conhecimento existente enviando outro pedido de criação ou atualização com o novo valor. O perfil de pontuação é atualizado no local sem necessidade de nova ingestão.

Não podes remover a política de frescura de uma fonte de conhecimento existente. Para desativar a recuperação sensível à atualidade, elimine a fonte de conhecimento e crie uma nova sem freshnessPolicy.

Validar o comportamento de classificação

O campo de frescura é gerado no momento da ingestão, por isso a política aplica-se ao conteúdo ingerido depois de a política estar em vigor. Depois de o conteúdo ser ingerido, execute pedidos de recuperação que possam devolver tanto conteúdo recente como antigo. Uma configuração bem-sucedida destaca documentos mais recentes e relevantes mais cedo, sem transformar a recuperação numa simples ordenação de datas.

Se a classificação não refletir a frescura esperada, inspecione o last_modified campo no índice subjacente. Valores de data ausentes, obsoletos ou inconsistentes reduzem a qualidade do sinal de frescura.

Conteúdo relacionado

• O que é uma fonte de conhecimento?
• Crie uma base de conhecimento
• Consultar uma base de conhecimento
• Adicionar perfis de pontuação para aumentar as pontuações de pesquisa