Configurar a recuperação com reconhecimento de atualização na Pesquisa de IA do Azure (versão prévia)

Recuperação sensível à atualização (versão prévia) permite que uma fonte de conhecimento indexada priorize conteúdo mais recente durante a recuperação agêntica. A fonte de conhecimento pode incluir uma política de atualidade para que o Pesquisa de IA do Azure  favoreça, na classificação, documentos recentes, sem exigir que os chamadores enviem uma lógica de classificação personalizada em cada solicitação de recuperação.

A atualização é 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 uso

Pré-requisitos

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

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

• Permissão para atualizar bases de dados de conhecimento. Configure a autenticação sem chave com a função Colaborador do Serviço de Pesquisa atribuída à sua conta de usuário (recomendada) ou use uma chave de API de administrador.

Quando habilitar a recuperação com reconhecimento de atualização

Habilite a recuperação sensível à atualidade quando conteúdo mais recente geralmente é mais útil ou confiável do que conteúdo mais antigo. Exemplos comuns incluem notas de versão, atualizações de política, manuais operacionais, avisos sobre o serviço e orientações operacionais.

Não use a atualização como substituto da filtragem. Se uma consulta precisar retornar apenas o conteúdo de um intervalo de datas específico, use um filtro na configuração da solicitação de recuperação ou da fonte de conhecimento.

Configurar a política de atualidade

Adicione uma política de atualização à definição de fonte de dados de conhecimento indexada. O contrato de pré-visualização usa a política para aplicar um sinal de classificação sensível à recência, preservando o restante do pipeline de recuperação.

O exemplo a seguir mostra uma fonte de conhecimento de blob com uma política de atualização.

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 atualização faz parte dos parâmetros de ingestão de origem. O esquema de índice é modificado para dar suporte a um campo de atualização gerado compatível com a funções de atualização do perfil de pontuação da Pesquisa de IA do Azure. O valor boostingDuration usa o mesmo formato de duração ISO 8601 que as funções de atualização temporal do perfil de pontuação, como P90D para 90 dias. A atualização adiciona um sinal de atualidade à classificação, mas a relevância da consulta, as configurações de recuperação definidas, a reclassificação semântica e outros sinais de classificação ainda se aplicam.

Você pode alterar boostingDuration em uma fonte de conhecimento existente enviando outra solicitação de criação ou atualização com o novo valor. O perfil de pontuação é atualizado no local, sem exigir reingestão.

Você não pode remover a política de atualização de uma fonte de conhecimento existente. Para desabilitar a recuperação sensível à atualização, exclua a fonte de conhecimento e crie uma nova sem freshnessPolicy.

Validar o comportamento do ranqueamento

O campo de atualização é gerado no momento da ingestão, de modo que a política se aplica ao conteúdo que é ingerido depois que a política está em vigor. Depois que o conteúdo for ingerido, execute as solicitações de recuperação que podem retornar conteúdo recente e antigo. Uma configuração bem-sucedida faz com que documentos relevantes mais recentes apareçam mais cedo, sem transformar o processo de recuperação em uma mera ordenação por data.

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

Conteúdo relacionado

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