Configurar la recuperación en función de la actualidad en Búsqueda de Azure AI (versión preliminar)

La recuperación basada en la actualización (versión preliminar) permite a una fuente de conocimientos indexada priorizar el contenido más reciente durante la recuperación de agentes. La fuente de conocimiento puede incluir una directiva de actualidad para que Búsqueda de Azure AI dé prioridad en la clasificación a los documentos recientes sin necesidad de que quienes realizan las llamadas envíen lógica de clasificación personalizada en cada solicitud de recuperación.

La frescura es un sesgo de clasificación, no un filtro estricto. Los documentos más antiguos todavía pueden aparecer cuando son muy relevantes para la consulta.

Soporte para el uso

Prerrequisitos

• Una fuente de conocimiento indexada que crea y mantiene un índice de Búsqueda de Azure AI, como una fuente de conocimiento de blobs.

• Base de conocimiento que hace referencia al origen de conocimiento.

• Permiso para actualizar las bases de conocimiento. Configure la autenticación sin clave con el rol Colaborador del servicio de búsqueda asignado a su cuenta de usuario (recomendado) o use una clave de API de administrador.

Cuándo habilitar recuperación basada en la actualización

Active la recuperación de información basada en la actualidad cuando el contenido más reciente sea generalmente más útil o fiable que el contenido más antiguo. Entre los ejemplos comunes se incluyen notas de versión, actualizaciones de políticas, procedimientos operativos, avisos de servicio y directrices operativas.

No use actualización como sustituto del filtrado. Si una consulta solo debe devolver contenido de un intervalo de fechas específico, use un filtro en la configuración de origen de conocimiento o solicitud de recuperación en su lugar.

Configurar la directiva de actualización

Agregue una directiva de actualización a la definición del origen de conocimiento indexado. El contrato de versión preliminar utiliza la directiva para aplicar una señal de clasificación basada en la recencia, al tiempo que preserva el resto de la canalización de recuperación.

En el ejemplo siguiente se muestra un origen de conocimiento de blobs con una directiva de actualización.

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 política de actualización forma parte de los parámetros de ingesta del origen. Se modifica el esquema del índice para admitir un campo de actualización generado que es compatible con las funciones de actualización del perfil de puntuación de Búsqueda de Azure AI. El valor boostingDuration usa el mismo formato de duración ISO 8601 que las funciones de actualización del perfil de puntuación, como P90D para 90 días. La actualización agrega una señal de recencia a la clasificación, pero siguen aplicándose la relevancia de la consulta, la configuración de recuperación establecida, la reordenación semántica y otras señales de clasificación.

Puede cambiar boostingDuration en un origen de conocimiento existente mediante el envío de otra solicitud de creación o actualización con el nuevo valor. El perfil de puntuación se actualiza directamente sin necesidad de volver a ingerir los datos.

No se puede quitar la directiva de actualización de un origen de conocimiento existente. Para deshabilitar la recuperación basada en la actualización, elimine la fuente de conocimientos y cree una nueva sin freshnessPolicy.

Validación del comportamiento de clasificación

El campo de actualización se genera en el momento de la ingesta, por lo que la directiva se aplica al contenido que se ingiere después de que la directiva esté en vigor. Una vez ingerido el contenido, ejecute las solicitudes de recuperación que pueden devolver contenido reciente y anterior. Una configuración correcta muestra los documentos pertinentes más recientes anteriormente sin convertir la recuperación en una ordenación de fecha simple.

Si la clasificación no refleja la actualidad como cabría esperar, inspeccione el campo last_modified en el índice subyacente. Los valores de fecha ausentes, obsoletos o incoherentes reducen la calidad de la señal de actualización.

Contenido relacionado

• ¿Qué es un origen de conocimiento?
• Creación de una base de conocimiento
• Consulta de una base de conocimiento
• Adición de perfiles de puntuación para aumentar las puntuaciones de búsqueda