Versión 2.5.4#

Se ha publicado Sherpa AI Server 2.5.4.

Fecha de lanzamiento: 22 de octubre de 2026.

1. Antes de actualizar#

2. Página de Inicio: acceso rápido a Chats y Asistentes#

Después de iniciar sesión aparece la nueva página de Inicio, con enlaces a las secciones accesibles, Chats recientes y un resumen de Asistentes y carpetas de prompts. Ahora se puede abrir un Chat reciente o elegir un Asistente directamente desde la página de Inicio para continuar el trabajo. Los Usuarios nuevos reciben una breve introducción. El botón "How to get started" permite volver a abrirla. Las tarjetas y acciones respetan los permisos del Rol y las Carpetas de objetos seleccionadas.

El menú lateral ya no limita a cinco los Asistentes fijados. Ahora se pueden ordenar los Asistentes necesarios con las acciones "Move up" y "Move down". La página de Inicio conserva el mismo orden, por lo que los Asistentes más utilizados permanecen en posiciones conocidas. El administrador puede configurar las tarjetas de la página de Inicio mediante el archivo de apariencia del cliente branding.json para adaptarlas a su instalación.

El procedimiento y las condiciones de acceso figuran en la guía de la página de Inicio.

3. Consumo de Modelos y llamadas a herramientas#

La página de Inicio ahora muestra estadísticas del uso de Modelos en Chats y escenarios de agentes. Se puede seleccionar un período y consultar el consumo propio. El acceso a las estadísticas de la Cuenta también permite ver el desglose por iniciador. Las herramientas más utilizadas se muestran por separado. Así se puede identificar a qué solicitudes corresponde el consumo y qué herramientas se invocan con mayor frecuencia.

Las solicitudes antiguas y las operaciones fuera de estos escenarios no se recalculan por completo. La interfaz indica que los datos son incompletos para distinguirlos del total confirmado del período seleccionado.

4. Procesamiento de documentos Word y PDF grandes#

La pantalla Documentos y los archivos adjuntos a Chats ahora admiten la indexación de archivos Word 97–2003 con extensión .doc. Los documentos cargados en este formato antiguo se pueden procesar sin guardarlos antes en otro formato. Los archivos no admitidos y los fallos de conversión muestran causas distintas, lo que ayuda a identificar qué se debe corregir antes de volver a procesarlos.

Las páginas e imágenes grandes de PDF ahora se reducen automáticamente antes del reconocimiento, conservando sus proporciones. Así se preparan estos archivos sin reducir manualmente sus páginas. Si después de la reducción todavía superan el límite, se muestra un error específico.

En la tabla de la pantalla Documentos, la columna "Extension" ahora puede reducirse hasta la anchura mínima estándar. Esto deja más espacio para las demás columnas al revisar los archivos. Consulte la guía de Documentos y la guía para cambiar el Modelo de indexación.

5. Selección del formato de la API de embeddings#

En la pantalla Modelos, el formulario de la instancia local de un Modelo de tipo "Indexing" o "Multimodal" ahora incluye el campo "Embeddings API format". El administrador puede seleccionar el formato que admite el servidor al que se conecta: OpenAI, vLLM, API v2 o Cohere. El valor seleccionado se conserva al guardar y volver a abrir el formulario. Así se puede configurar la conexión con el servidor de embeddings mediante el formulario y comprobar qué formato se utilizará. Consulte la guía para cambiar el Modelo de indexación.

6. Permisos para etiquetas y acciones del agente#

Los ajustes del Rol ahora incluyen permisos independientes para crear, leer, modificar y eliminar etiquetas de Documentos. El administrador puede definir por separado qué acciones sobre etiquetas están permitidas. Durante la actualización, el acceso existente se migra desde los permisos de Documentos, por lo que no es necesario volver a asignarlo solo por la separación de permisos.

Las acciones del agente en el menú lateral ahora se ocultan si faltan los permisos necesarios. Un menú abierto se cierra cuando cambian los permisos. El Usuario ve las acciones permitidas por sus permisos actualizados, en lugar de un conjunto de opciones desactualizado.

7. Instalación con Modelos externos#

El instalador ahora ofrece una opción con servicios LLM y Embedding externos. El administrador introduce las direcciones de los servicios, especifica HTTP o HTTPS para LLM y selecciona un Modelo. El instalador guarda estos ajustes sin descargar imágenes ni Modelos locales. Las actualizaciones conservan el modo elegido, por lo que no es necesario sustituir los servicios externos por servicios locales para actualizar la instalación. Siguen disponibles las opciones locales con GPU y CPU. Consulte la guía de instalación.

Si se utiliza un Modelo de indexación externo, ahora se puede establecer EMBED_LOCAL_MODEL_ENABLED=false en la configuración del entorno. Después del cambio, es necesario volver a crear el contenedor. Esto desactiva la carga del Modelo local dentro de Embed cuando no se necesita para el Modelo externo seleccionado. El contenedor aiserver-embed sigue siendo necesario para procesar Documentos y realizar búsquedas. El Modelo local permanece activado de forma predeterminada. Consulte la guía para cambiar el Modelo de indexación.

8. Conservación de copias de seguridad de Sherpa AI Server y comprobación de la actualización#

El script de actualización de Sherpa AI Server ahora permite eliminar automáticamente las copias de seguridad antiguas de los datos y la configuración del servidor. La copia de seguridad de una actualización incluye archivos de configuración, entre ellos .env y docker-compose.yml, archivos de instalación, una copia de la base de datos PostgreSQL y archivos comprimidos de los volúmenes Docker que contienen datos. Estos archivos son necesarios para restaurar los datos y la configuración del servidor si falla una actualización.

El administrador ahora puede indicar cuántas copias de seguridad completas más recientes se conservan. Las copias antiguas solo se eliminan tras una actualización correcta y la comprobación de que la nueva copia está completa. De forma predeterminada, se conservan todas las copias. Antes de actualizar, el administrador debe comprobar que la copia de seguridad de los datos y la configuración del servidor esté completa.

También se ha añadido un diagnóstico del servidor instalado que comprueba el estado de los contenedores, la disponibilidad de PostgreSQL, el espacio libre y la respuesta de la API. El administrador puede activar una invitación para ejecutar el diagnóstico tras una actualización correcta con SHERPA_DIAGNOSTICS_OFFER=true y comprobar así el resultado de la actualización. En el modo de Embedding externo, el diagnóstico omite la comprobación del contenedor local de ese servicio. La configuración de conservación de copias de seguridad y los pasos del diagnóstico figuran en la guía de actualización.

9. Aislamiento de archivos del intérprete de código#

Al ejecutar código Python, los archivos de sesión del intérprete ahora están aislados del volumen compartido de la aplicación. Su API interna requiere un token de servicio independiente, y una política del sistema Landlock limita el acceso a los archivos. Si Landlock no está disponible, el intérprete no se inicia: no se permite ejecutar el código sin protección.

Antes de actualizar, el administrador debe comprobar la compatibilidad del kernel y la configuración del contenedor según la guía de aislamiento de archivos del intérprete. Así se puede preparar el entorno con antelación para que el intérprete funcione con la protección obligatoria.

También se han actualizado las dependencias vulnerables de los componentes del servidor y se han eliminado las claves privadas compartidas de la distribución. Al instalar la distribución actualizada, estas claves ya no se copian al servidor desde sus archivos actuales.

10. Continuación de la eliminación y de los cambios de indexación#

En la pantalla Documentos se corrigió la limpieza al eliminar una carpeta: también se eliminan las carpetas anidadas, los archivos y los datos de indexación relacionados. Si la limpieza se interrumpe, ahora se puede volver a eliminar la misma carpeta para continuar la operación pendiente. No es necesario eliminar los objetos anidados restantes uno por uno.

Durante un cambio incompleto de los ajustes de indexación, ahora se muestran los fragmentos guardados y una acción para continuar. Una vez resuelta la causa del fallo, se puede continuar la transición. Los ajustes de reconocimiento se guardan por separado de los de indexación, por lo que un fallo parcial no sustituye los valores confirmados. Esto ayuda a completar el cambio de ajustes y permite comprobar la configuración que ya se ha guardado.

11. Indexación de archivos en paralelo#

Se corrigieron los conflictos al indexar simultáneamente archivos con el mismo nombre y durante la primera indexación de una Cuenta nueva. Los Usuarios pueden procesar estos archivos en paralelo sin esos errores y bloqueos. Al volver a una dimensión anterior de los embeddings, ahora se aplican los ajustes actuales de indexación para evitar el uso de una configuración desactualizada.

12. Errores y repetición de acciones en Chat#

Se corrigió un error en un escenario de agente con un Modelo externo que hacía que el Agente repitiera una llamada a Python que el sistema había rechazado por no contener código ejecutable, sin devolver una respuesta. Ahora, después de dos intentos de este tipo, la ejecución termina con un error claro. El Usuario ve la causa de la detención en lugar de esperar indefinidamente una respuesta.

Una segunda transcripción en el mismo Chat ahora se sigue como una ejecución nueva. Esto permite seguir el intento de reconocimiento actual. Si se interrumpe el flujo de respuesta o el Modelo devuelve una respuesta vacía, la ejecución ya no se marca como correcta sin un mensaje. El Usuario ve un error y puede volver a intentarlo. Consulte la guía de Chat.