Agent Framework y Redis: cómo migrar el índice y comprobar el aislamiento entre sesiones

La versión 1.24.0 de Microsoft Agent Framework para Python cambia el esquema del índice utilizado por el proveedor beta RedisContextProvider. Si la aplicación usa ese proveedor, actualizar el paquete no basta: hay que reconstruir el contexto y verificar qué recupera cada sesión.

Índices Redis que separan la memoria por sesión

Qué cambia en el índice

El proveedor conserva la identidad exacta de los ámbitos de aplicación, agente, usuario y sesión, incluso cuando los identificadores difieren en mayúsculas o signos de puntuación. Los índices heredados incompatibles se rechazan. La opción overwrite_index=True no convierte el esquema ni migra los documentos.

Ensayar la migración

  1. Inventariar índice, claves de contexto y fuente de reingesta. Preparar una copia aislada y verificar que el respaldo se puede restaurar.
  2. En esa copia, retirar el índice antiguo y los hashes de contexto asociados. Permitir que el proveedor cree el índice nuevo y volver a cargar los documentos desde la fuente verificada.
  3. Comparar recuentos y resultados de búsqueda. La versión declara Python 3.11 o superior como base soportada; revisar los límites de cada dependencia.

Una prueba que detecta cruces

Guardar dos documentos con marcadores distintos bajo sesiones llamadas Caso-A y caso-a. Buscar ambos marcadores desde cada sesión: solo debe aparecer el propio. Repetir con puntuación y con consultas sin coincidencias. Una prueba que solo cuenta documentos puede pasar aunque el contexto se devuelva al usuario equivocado.

Cambio de implementación y pruebas en GitHub.

Fuente primaria: notas de la versión en GitHub.

Deja un comentario

Scroll al inicio