Versión 2.6.0#

Ya está disponible una nueva versión de Sherpa AI Server: Versión 2.6.0.

Fecha de publicación: 18 de noviembre de 2026.

1. Antes de actualizar#

Antes de actualizar, es necesario leer las notas de todas las versiones intermedias y cumplir sus requisitos. Si la versión actual es anterior a la 2.5.0, acuerde el procedimiento de actualización con el equipo de soporte.

Para utilizar las habilidades, es necesario actualizar la imagen Docker del servicio de interpretación de código junto con el servidor. Las compilaciones propias requieren una base actualizada con packaging==24.0. Esta biblioteca comprueba los requisitos de los paquetes Python. Una base antigua sin ella no permite compilar el nuevo servicio.

Los componentes de procesamiento de datos actualizan sus dependencias para corregir vulnerabilidades. Las correcciones se distribuyen en las imágenes Docker correspondientes, que deben aplicarse durante la actualización.

2. Catálogo de habilidades y asignación a asistentes#

El menú de navegación incorpora Skills. Ahora permite crear una habilidad o importar un ZIP con SKILL.md, scripts Python, plantillas y otros recursos. La carga de un directorio de recursos conserva las rutas relativas de las subcarpetas. La búsqueda, los filtros del menú de columnas, la ordenación y la paginación ayudan a encontrar y reutilizar el paquete.

Ahora una habilidad puede asignarse a varios asistentes. Basta con actualizar las instrucciones y los archivos del catálogo para que los cambios estén disponibles para los asistentes asignados. "All agents" abarca los asistentes actuales y futuros de la cuenta y se configura al iniciar sesión como la cuenta.

La pestaña "Skills" de la ventana de edición del asistente incorpora "Connect skill" y la búsqueda de paquetes disponibles. Las habilidades conectadas aparecen en tarjetas compactas con un interruptor de disponibilidad. Las asignaciones para toda la cuenta se indican por separado. Los usuarios con permiso de lectura pueden consultar las instrucciones y descargar recursos. Para editar y conectar se requiere permiso de actualización de asistentes. Así pueden reutilizarse las instrucciones sin modificar las restricciones de las carpetas de objetos.

Ventana de edición del asistente, pestaña Skills con paquetes conectados e interruptor, interfaz en inglés

Ventana Edit assistant, pestaña Skills, interfaz en inglés

No se requiere activar la función mediante otra variable de entorno. La preparación del paquete y los permisos se describen en la guía de habilidades de asistentes.

3. Habilidades en el chat#

Los chats con un asistente incorporan la selección automática de habilidades según la tarea en los modos "Agent" y "Code interpreter". Para el uso habitual basta con enviar una solicitud. Para elegir una habilidad manualmente, abra el menú de herramientas de la parte inferior izquierda del campo de entrada, seleccione "Skills" y haga clic en el título del paquete en la ventana independiente. Una etiqueta compacta muestra la habilidad seleccionada. Al quitarla, vuelve la selección automática y se conserva el borrador. Ya no hay un campo independiente encima de la entrada, y el modo del chat no cambia.

Entrada del chat en modo Agent con la etiqueta Monthly report seleccionada, interfaz en inglés

Chat, entrada en modo Agent, Monthly report seleccionada, interfaz en inglés

Las instrucciones se envían completas al modelo. Si el catálogo y las instrucciones superan el contexto disponible, el servidor informa del límite. Es necesario acortar las descripciones o las instrucciones, o elegir un modelo con un contexto adecuado. Los requisitos de paquetes Python se comprueban antes de ejecutar. Los nombres de paquetes y requisitos de versión no válidos se rechazan antes de guardar la habilidad. Si falta una biblioteca, aparece una advertencia. Si la comprobación no está disponible, aparece "Compatibility not checked". Las habilidades no instalan bibliotecas automáticamente. Los paquetes instalados desde wheels locales o URL directas se reconocen por su nombre y versión reales.

En el primer uso correcto, la ejecución conserva una versión de las instrucciones y los recursos. Los archivos de la habilidad son de solo lectura para Python. Editar el paquete no sustituye los materiales ya cargados por la ejecución actual. El acceso al asistente y a la habilidad vuelve a comprobarse, incluso tras un cambio de carpeta de objetos o la desactivación de una asignación. Al finalizar o cancelar, las copias temporales se eliminan en segundo plano, conservando los recursos de las ejecuciones activas y los documentos generados en el chat.

4. Capacidades y asignaciones predeterminadas de modelos#

La pantalla Models incorpora capacidades independientes de OCR de documentos, análisis de imágenes, vídeo y otras operaciones. En la ficha del modelo, el administrador puede comprobar las capacidades mediante una instancia activa guardada y seleccionar las operaciones para las que el modelo será predeterminado. De esta forma pueden configurarse por separado el OCR de documentos y el procesamiento de imágenes.

Diálogo "Edit Model", capacidades independientes y asignaciones predeterminadas

Diálogo "Edit Model", capacidades independientes y asignaciones predeterminadas

Las comprobaciones de capacidades son coherentes en el chat, Chat Completions y Responses, incluidas las respuestas transmitidas progresivamente. Las solicitudes utilizan modelos de la cuenta actual. Si falta una asignación predeterminada o se especifica una instancia no disponible, el servidor devuelve un error claro en lugar de elegir una conexión del entorno de forma oculta.

En un chat nuevo sin asistente, ahora puede elegirse el modelo antes del primer mensaje. Esto permite iniciar la conversación con el modelo deseado.

5. Migración de la indexación del entorno a Models#

Al actualizar una cuenta con una conexión de indexación antigua definida en el entorno, el servidor la transfiere a un modelo de indexación predeterminado. Se conservan los vectores y las transiciones pendientes. Esta migración no requiere reindexar. La asignación puede revisarse en la configuración de Documents. Los secretos del servidor no se copian a las fichas de modelos.

Se ha añadido el script de administración scripts/import-account-models-from-env.php para importar otras conexiones del entorno a una cuenta seleccionada explícitamente. Por defecto muestra un plan sin modificar datos. Para aplicarlo, se utiliza --apply con el --account-guid requerido. Así puede revisarse el contenido de la migración antes de guardar la configuración.

El cambio del modelo de indexación sigue siendo una operación independiente que requiere confirmación, según la guía de indexación. Quitar la asignación predeterminada conserva los vectores existentes, pero detiene las nuevas operaciones de indexación hasta seleccionar otro modelo. Esto distingue la migración de una conexión existente del cambio a un modelo diferente.

6. Separación de hablantes en grabaciones#

La opción "Also perform diarization" de la ficha del modelo de transcripción ahora controla la separación de hablantes también cuando se selecciona explícitamente un modelo. Aparece debajo de la transcripción activada y se guarda por instancia, independientemente de la asignación predeterminada.

Diálogo "Edit Model", diarización activada

Diálogo "Edit Model", diarización activada

Las grabaciones con varios hablantes se procesan mediante WhisperX aunque Whisper esté seleccionado para la transcripción habitual. Si la diarización no está disponible, el servidor devuelve un error en lugar de entregar silenciosamente texto sin identificar hablantes. Así se obtiene la transcripción esperada o se identifica qué configuración debe comprobarse.

7. Carga de carpetas y ZIP en Documents#

La pantalla Documents incorpora la carga de carpetas y la importación de ZIP como carpeta. Ambas conservan la estructura anidada. Los archivos de la raíz del ZIP se colocan directamente en la carpeta seleccionada. La importación comprueba las rutas y los límites de extracción. Esto permite importar una estructura preparada sin crear cada carpeta manualmente.

Para conservar el ZIP como un solo archivo sin extraerlo, es necesario utilizar la carga habitual de archivos.

8. Columnas adicionales de Documents#

La tabla Documents ahora admite columnas "Text", "Number" y "List". Los valores introducidos en la ficha de un archivo aparecen junto al documento en la tabla y los resultados de búsqueda. Por ejemplo, puede guardarse el número y el departamento de cada contrato para verlos al seleccionar el archivo.

9. Presentación de archivos, carpetas y etiquetas#

Las listas de archivos y carpetas incorporan más espacio entre el icono del archivo o la carpeta y su nombre. Al editar una etiqueta, el campo de nombre activo tiene un fondo claro. Esto ayuda a distinguir nombres adyacentes y localizar el campo que se está editando.

10. Exportación de eventos de Audit a SIEM#

Se ha añadido un exportador Syslog independiente y opcional para enviar eventos de Audit a SIEM. El administrador puede activar el perfil siem y configurar un destinatario para reunir los eventos de Sherpa AI Server con los de otros sistemas. El progreso de lectura se guarda por separado. Las comprobaciones repetidas incluyen registros de transacciones que finalizaron con retraso.

Los pasos de conexión, los permisos de base de datos y la configuración TLS se describen en la guía de exportación. Deben tenerse en cuenta los límites del protocolo: el envío por TCP/TLS no confirma el almacenamiento en SIEM, y UDP no confirma la entrega.

11. Conservación de borradores y recuperación de habilidades#

El editor de habilidades ahora gestiona correctamente la edición simultánea. Si cambia la versión guardada, el borrador local permanece en la ventana y se bloquea la sobrescritura. Para continuar, es necesario guardar aparte el texto necesario, cargar la versión actual con "Reopen skill" y repetir los cambios. Actualizar la lista y realizar operaciones con archivos ya no elimina esta protección.

Cuando se confirma que la importación de un ZIP ha fallado, se eliminan los archivos creados para esa importación. También se corrige el recuento de archivos en ZIP con directorios anidados.

La recarga tras un fallo del intérprete restaura los recursos de la ejecución actual. Al reanudar un agente se comprueban de nuevo las asignaciones y los permisos. Las habilidades desactivadas o desvinculadas se excluyen de las instrucciones actuales. Así puede continuarse sin instrucciones obsoletas ni recursos de otra ejecución.

El reintento tras un error de envío a la cola restaura el borrador original sin repetir el comando de habilidad. Un error tardío ya no sustituye el texto de otro chat, modo o ejecución.

12. Diagnóstico de capacidades del modelo#

La pantalla Models ahora muestra correctamente los errores de detección de capacidades. La causa y el código HTTP pueden copiarse directamente de la ventana "Edit Model". La lista es más compacta y los botones largos se distribuyen en varias líneas en pantallas estrechas. Esto permite consultar el resultado y continuar la configuración sin buscar una notificación que desapareció.

Error de detección de capacidades en el diálogo Edit Model

Diálogo "Edit Model", detalles del error y código HTTP

Tras confirmar un modelo de indexación, cerrar su ficha actualiza la lista Models, incluso con Cancel o Escape. El administrador ve la asignación predeterminada actual sin recargar la página.

13. Guardado y visualización de columnas adicionales#

Documents ahora actualiza correctamente las columnas adicionales tras la respuesta del servidor y muestra los valores guardados en los resultados de búsqueda. Tras un error de guardado, el valor puede enviarse otra vez. Cambiar "List" a "Text" o "Number" ya no queda bloqueado por una opción vacía oculta.

Cerrar la ventana de eliminación de columnas cancela la acción. Tras un error se libera el estado pendiente. Esto permite continuar trabajando con la tabla y repetir la acción deseada.

14. Descarga de adjuntos y herramientas del agente#

La descarga de XLSX y otros adjuntos del chat elimina los espacios sobrantes al final del nombre. Se conserva el inicio del nombre. Los archivos se descargan con el nombre esperado, sin aumentar artificialmente su longitud.

Si no puede recuperarse un archivo de los resultados del intérprete, los demás archivos disponibles se guardan en el chat. Un fallo ya no interrumpe el guardado de todos los resultados.

En modo "Agent" se han corregido la transmisión del token API seleccionado a las herramientas internas y el formato del cuerpo de sus solicitudes. Las llamadas utilizan ese token para ejecutar las solicitudes con los permisos configurados.

15. Autorización de Chat API y páginas de API#

Chat Completions y Responses ahora clasifican correctamente las solicitudes sin datos de autorización. En lugar de un error de estructura JSON, devuelven 403 access_denied con una indicación sobre Bearer o una sesión. La integración debe enviar una clave API válida en Authorization: Bearer … o utilizar una sesión válida. Esto permite corregir la autenticación sin cambiar un cuerpo de solicitud correcto. Se mantienen las comprobaciones de autenticidad de la clave y de permisos para la operación.

Se ha corregido la apertura de la página de tokens API, Swagger y ReDoc en instalaciones donde sus archivos se procesaban como solicitudes a la API. La selección habitual de la entrada del menú vuelve a abrir la página.