12.8 Notas de la versión de Harmony

Versión 12.8 Harmony

La versión 12.8 Harmony se implementa de forma escalonada según las fechas y horas que se enumeran a continuación por componente y región. Para obtener una explicación más detallada de la cadencia de lanzamiento por categoría de componente, consulta el cronograma de lanzamiento.

App Builder 4.64 y Wevo iPaaS tienen notas de la versión separadas.

También están disponibles compilaciones de notas de la versión para Grupos de agentes en la nube de producción, Grupos de agentes en la nube de espacio aislado y agentes privados.

Puedes suscribirte a notificaciones de mantenimiento para componentes basados en web en Jitterbit Trust. Los componentes instalados localmente están disponibles en la página Descargas. Las imágenes del agente privado Docker, la puerta de enlace de API privada y App Builder están disponibles en Docker Hub de Jitterbit. La fecha de fin de vida útil de estos componentes (excepto App Builder) es un año después de la fecha de lanzamiento.

Nuevas funciones

Agentes de IA

• Agente de cumplimiento de documentos (Azure)
  El Agente de cumplimiento de documentos (Azure), accesible desde la categoría Agente de IA del Marketplace, extrae automáticamente texto de archivos PDF mediante el reconocimiento óptico de caracteres (OCR) de Azure Document Intelligence y aplica análisis de Azure AI Foundry para detectar y eliminar información de identificación personal (PII), ayudando a las organizaciones a cumplir con los requisitos de privacidad de datos sin revisión manual de documentos. Para agregarlo a tu licencia, contáctanos.

• Agente de Cumplimiento de Documentos (Google)
  El Agente de Cumplimiento de Documentos (Google), accesible desde la categoría Agente de IA del Marketplace, extrae automáticamente texto de PDFs usando OCR de Google Document AI y aplica análisis de Google Vertex AI para detectar y eliminar PII, ayudando a las organizaciones a cumplir con los requisitos de privacidad de datos sin revisión manual de documentos. Para agregarlo a tu licencia, contáctanos.

Conectores

• Conector ServiceNow v2 (Beta)
  El conector ServiceNow v2 (Beta) se puede usar con agentes en la nube o privados para consultar, crear, actualizar o eliminar registros en ServiceNow. Para acceso beta y proporcionar retroalimentación, contacta al Equipo de Producto de Jitterbit.

Mejoras

Agente

• Mejoras en la validación del instalador de agentes privados
  La instalación de una versión de agente privado 12.8 o posterior ahora incluye validación adicional y orientación durante el proceso de instalación:

  • Solicitud de requisitos del sistema: Los instaladores de Windows y Linux ahora muestran una solicitud con los requisitos del sistema del agente durante la instalación.
  • Validación de contraseña de PostgreSQL: En Windows, el instalador ahora valida la contraseña de la cuenta de servicio de PostgreSQL (jitterbitpostgres) contra las restricciones de caracteres en el momento de la entrada y te solicita que la corrijas antes de que continúe la instalación. Anteriormente, una contraseña inválida no se detectaba hasta después de que PostgreSQL había sido instalado, causando que la instalación fallara con Error 1722.

Gestor de API

• Soporte de credenciales multicliente para perfiles de seguridad OAuth 2.0 de 2 patas
  Un perfil de seguridad OAuth 2.0 que usa Flujo OAuth de 2 patas (Microsoft Entra ID u Okta) ahora puede almacenar múltiples entradas de credenciales de cliente bajo Credenciales de cliente, cada una con su propio Nombre de consumidor, ID de cliente, Secreto de cliente y Estado (Activo o Inactivo). Esto permite que múltiples consumidores distintos se autentiquen en la misma API usando sus propias credenciales, sin requerir un perfil de seguridad o API separado por consumidor.

Conectores

• Memoria a corto plazo del conector Amazon Bedrock y recuperación de base de conocimiento
  El conector Amazon Bedrock tiene las siguientes mejoras:

  • Contexto de chat entre operaciones: Una conexión de Amazon Bedrock tiene una nueva configuración Almacenar contexto de chat entre operaciones que habilita memoria a corto plazo para grupos de agentes en la nube, reteniendo el contexto de chat más allá de una sola operación usando un chatId compartido. Cuando está habilitado, usa las nuevas configuraciones TTL de contexto de chat, Máximo de mensajes guardados en contexto y Cuando no se encuentra contexto de chat para configurar el comportamiento de retención y respaldo. Los agentes privados ya retienen el contexto de chat en memoria para operaciones en la misma cadena y no se ven afectados por esta configuración.
  • Fuentes adicionales de recuperación de base de conocimiento: La actividad Prompt de Amazon Bedrock ahora admite bases de conocimiento que usan Amazon S3 Vectors (un almacén de vectores) o Amazon Redshift (un almacén de datos estructurados) como fuentes de recuperación, habilitadas con la nueva casilla Usar Base de Conocimiento.

• Conector Anthropic Claude (Beta)
  El conector Anthropic Claude (Beta) ahora está disponible para todas las organizaciones. Se puede usar con agentes en la nube o privados para enviar solicitudes y registrar herramientas con modelos Claude alojados por Anthropic directamente o a través de Amazon Bedrock. Para proporcionar retroalimentación beta, contacta al Equipo de Producto de Jitterbit.

• Anulación de conexión de la actividad Enviar documento de EDI for Cloud v2
  La actividad Enviar documento de EDI for Cloud v2 tiene una nueva configuración opcional, Usar método de comunicación alternativo. Cuando se habilita, puedes seleccionar una conexión EDI específica de la lista de conexiones disponibles para usar en esa operación, anulando la conexión del socio comercial asignada en la configuración de Comunicación de EDI.

• Compatibilidad del conector OpenAI con la API de respuestas y herramientas del servidor MCP
  El conector OpenAI tiene tres nuevas actividades basadas en la API de respuestas de OpenAI:

  • La actividad Prompt V2 crea una respuesta para un prompt y puede llamar herramientas registradas por una actividad anterior que use el mismo chatId.
  • La actividad Registrar herramientas V2 añade herramientas a un asistente chatbot.
  • La actividad Registrar herramientas del servidor MCP registra un servidor MCP remoto como proveedor de herramientas para que sus herramientas estén disponibles para una actividad Prompt V2 encadenada, permitiendo que los modelos descubran e invoquen dinámicamente herramientas desde puntos finales MCP administrados por el cliente en tiempo de ejecución.

  Estas tres actividades también admiten la persistencia del contexto de chat entre operaciones usando un chatId compartido: una conexión OpenAI tiene una nueva configuración Almacenar contexto de chat entre operaciones (solo actividades V2) para grupos de agentes en la nube, con configuraciones dependientes de TTL del contexto de chat, Máximo de mensajes guardados en el contexto y Cuando no se encuentra el contexto de chat. Los agentes privados ya retienen el contexto de chat en memoria y no se ven afectados por esta configuración. Las actividades existentes Prompt y Registrar herramientas no se ven afectadas.

EDI

• Compatibilidad del Asistente de IA de EDI con códigos de tipo de documento
  El Asistente de IA de EDI ahora admite filtrar transacciones por un código de tipo de documento específico, como 810 o INVOIC, además de un tipo de documento general como Factura u Orden. Puedes hacer referencia a un subtipo por su código únicamente (por ejemplo, 810) o calificado con su tipo general (por ejemplo, Invoice.810).

• Menús para crear con IA o abrir configuración de UI
  Un nuevo menú Nuevo en la página Socios comerciales, la pestaña Administrar flujos de trabajo de un socio y la pestaña Configuración de comunicación de un socio muestran opciones para Crear con IA o abrir la configuración de UI. Además, el generador de búsqueda avanzada de la página Transacciones tiene un nuevo menú Buscar con una opción Buscar con IA. La opción Crear con IA abre el Asistente de IA de EDI para crear un socio comercial, flujo de trabajo o conexión usando prompts en lenguaje natural, y la opción Buscar con IA lo abre para buscar transacciones.

• Rediseño de la página de mensajería
  La página Mensajería tiene una interfaz rediseñada con las siguientes nuevas capacidades: filtrado y una columna para el nivel de gravedad del mensaje (Alto, Medio, Bajo o Información); filtrado por categoría y subcategoría de mensaje; un cajón Columnas para mostrar, ocultar y reordenar columnas; y un cajón de detalles del mensaje para revisar las entradas de registro de un mensaje sin perder tu lugar en la lista.

Portal Harmony

• Rediseño de la página de configuración de cuenta y restablecimiento de pregunta de seguridad
  La página Configuración de cuenta (anteriormente Mi cuenta) tiene una interfaz rediseñada con navegación de barra lateral y formularios separados para tu perfil e información de contacto. También puedes restablecer tu pregunta de seguridad y respuesta, que proporcionan una forma adicional de verificar tu identidad.

Consola de Administración

• Nuevo tipo de alerta: Estado de SSO Cambió
  La página Alertas tiene un nuevo tipo de alerta que envía correos electrónicos a los usuarios con permiso de rol Admin cuando se habilita o deshabilita el inicio de sesión único (SSO) para la organización. Esta alerta está habilitada de forma predeterminada para organizaciones nuevas y existentes, por lo que los usuarios Admin reciben notificaciones automáticamente sin necesidad de configuración, a menos que se reconfigure o se elimine la alerta. La habilitación o deshabilitación de SSO ahora también se registra como una entrada de Actualización en el registro de auditoría.

Studio

• Indicador de validación compacto para scripts de campos de transformación
  El estado de validación de scripts para un script de campo de destino dentro de una transformación ahora se muestra como un indicador colapsado de una sola línea en lugar de expandirse automáticamente, coincidiendo con el comportamiento del editor de scripts completo y del componente de script. Los mensajes de validación largos se truncan con puntos suspensivos, y se puede hacer clic en el indicador para ver el mensaje completo en una superposición flotante que no desplaza el script ni los campos circundantes. Haz clic fuera de la superposición o usa su control de cierre para contraerla nuevamente al indicador.

Cambios

Agente

• Controlador JDBC de Microsoft SQL Server actualizado
  Se ha actualizado el controlador JDBC de Microsoft SQL Server incluido con el agente. A partir de la versión 10.2 del controlador, Microsoft cambió las propiedades de conexión predeterminadas para que el controlador solicite una conexión cifrada (encrypt=true) y valide el certificado del servidor, un cambio que Microsoft documenta como incompatible bajo la propiedad de conexión encrypt.

  Una conexión a un SQL Server cuyo certificado no se puede rastrear hasta una autoridad de certificación que el agente ya confía, como Amazon RDS para SQL Server, ahora falla con un error PKIX path building failed. Para resolver esto, ingresa encrypt=false; en el campo Parámetros de Cadena de Conexión Adicionales, como se describe en Cifrado de conexión y certificados de servidor. La misma orientación se aplica a una fuente o destino de base de datos de Microsoft SQL en Design Studio.

• El cifrado de contraseña de PostgreSQL usa MD5 de forma predeterminada en agentes privados de Linux
  Los agentes privados de Linux ahora usan cifrado de contraseña MD5 para la instancia de PostgreSQL incluida de forma predeterminada, revirtiendo el valor predeterminado de SCRAM-SHA-256 que se introdujo para instalaciones nuevas de Linux en 12.6. Cuando actualizas un agente de Linux cuyo PostgreSQL usa SCRAM-SHA-256, el instalador te solicita que restablezca el cifrado a MD5 (recomendado) o mantengas SCRAM-SHA-256; la actualización continúa de cualquier forma, y el usuario de base de datos jitterbit y su contraseña permanecen sin cambios. Los agentes que ya usan MD5 y las actualizaciones que se ejecutan con silent_install establecido no se solicitan y mantienen su cifrado existente. Para usar SCRAM-SHA-256 en un agente de Linux, consulta SCRAM en PostgreSQL.

Puerta de enlace de API

• Cambios generales
  La puerta de enlace de API tiene cambios generales para mantenimiento y rendimiento.

Administrador de API

• Visualización del nombre de API en el filtro de API de la página Analytics
  El filtro APIs en la página Analytics del Administrador de API ahora muestra cada API solo por su nombre, y el filtrado por una API coincide con el nombre de la API. Anteriormente, la lista desplegable mostraba el nombre de la API concatenado con su número de versión. Dado que el filtrado coincide con el nombre, seleccionar una API puede devolver resultados para múltiples APIs que comparten el mismo nombre; usa los filtros separados de Versión y Entorno para reducir los resultados.

Conectores

• La configuración del corpus RAG del conector Google Gemini se movió; requiere acción del usuario
  La opción Use RAG Corpus (Vertex AI) de la actividad Prompt de Google Gemini ahora muestra los campos de selección del corpus RAG en el mismo paso que la configuración del modelo y el prompt, en lugar de en un paso separado.

  Acción requerida: Las actividades Prompt existentes que usan RAG Corpus (Vertex AI) deben reconfigurarse

  Las operaciones existentes que usan actividades Prompt configuradas con Use RAG Corpus (Vertex AI) habilitado antes de este cambio fallarán hasta que abras la actividad y reconfigures la selección del corpus RAG. Las actividades Prompt sin esta opción habilitada no se ven afectadas.

Management Console

• Alcance de acceso por rol de entorno para las pestañas Project access y API access
  Las pestañas Project access y API access en el cajón Role Assignments de User Management ahora muestran un proyecto o API solo cuando tanto el rol seleccionado como tu propia cuenta de usuario tienen al menos acceso de environment role access de Read a su entorno. Anteriormente, podías ver proyectos y APIs listados aquí a los que no tenías acceso de environment role.

Correcciones

Agent

• Nueva variable Jitterbit para preservar prefijos de espacios de nombres XML de origen
  La nueva variable Jitterbit jitterbit.target.xml.preserve.namespace.prefix se puede establecer en true antes de una transformación con salida XML para preservar los prefijos de espacios de nombres definidos en el XML de origen. De forma predeterminada (false), las transformaciones continúan aplicando prefijos de espacios de nombres genéricos (ns, ns2, etc.), por lo que el comportamiento existente no cambia a menos que establezcas esta variable. Esto es útil cuando un endpoint de destino requiere que se retengan los prefijos de espacios de nombres originales.

• Las funciones de fecha y hora ahora preservan valores de medianoche
  Las funciones ConvertTimeZone, Date y GeneralDate ahora tratan la medianoche (00:00:00) como un valor de hora válido y la preservan en el valor devuelto, ya sea que la entrada sea una cadena de fecha y hora sin procesar o producida por Date o GeneralDate. Anteriormente, un valor convertido o analizado de exactamente medianoche podría truncarse a una cadena de solo fecha, mientras que cualquier otra hora se preservaba correctamente. La función CVTDate no se vio afectada.

• Estabilidad mejorada del agente durante el procesamiento de operaciones
  Los agentes son más estables al ejecutar transformaciones y procesar operaciones bajo carga. Esto resuelve bloqueos que podrían ocurrir durante transformaciones y conversiones de formato de datos, cuando las operaciones de larga duración alcanzan su tiempo de espera y cuando se procesan altos volúmenes de operaciones simultáneamente.

Agent y Design Studio

• Correcciones de caracteres multibyte
  Las siguientes correcciones resuelven problemas con fallos de operaciones, salida incorrecta, caracteres mostrados incorrectamente y archivos inaccesibles.

  Estas correcciones se aplican cuando se usa la versión 12.8 del agente o posterior:

  • Las operaciones ya no fallan con un error UTF-8 Invalid byte cuando los datos de origen o el nombre de un archivo de origen contienen caracteres multibyte. Por ejemplo, un archivo de origen JSON con contenido multibyte ahora se carga correctamente en una transformación, y una operación de Salesforce con un carácter multibyte en el nombre del archivo de origen ya no devuelve un error SOAP.
  • Las operaciones de NetSuite ya no reemplazan caracteres multibyte en nombres de campos devueltos con ?, lo que anteriormente causaba que las transformaciones fallaran.
  • Los conectores File Share y FTP ahora pueden leer archivos cuyos nombres contienen caracteres multibyte. Anteriormente, las operaciones podían fallar cuando un nombre de archivo contenía caracteres multibyte.

Estas correcciones requieren tanto la versión del agente 12.8 o posterior como Design Studio 11.64 o posterior:

• Los nombres de objetos de Oracle EBS que contienen caracteres multibyte ahora se muestran correctamente en el asistente de selección de objetos.
• Los caracteres multibyte ya no se corrompen cuando se descarga o restaura un proyecto de Design Studio desde la nube de Harmony, incluyendo en los asuntos y cuerpos de los mensajes de correo electrónico.

Conectores

• Actualizar el esquema de una actividad existente ya no falla con DTDPARSER_ERR_UNKNOWN_FILE_EXTENSION
  Actualizar el esquema de una actividad previamente configurada, como para los conectores JWT o Stripe, ya no falla con un error DTDPARSER_ERR_UNKNOWN_FILE_EXTENSION y un esquema de respuesta en blanco. Anteriormente, esto podía ocurrir en una actividad creada antes de un cambio en la forma en que estos conectores reportan su tipo de esquema.

Consola de administración

• La búsqueda en tiempo de ejecución ahora admite códigos de estado HTTP para entradas de registro de API
  La clave de búsqueda status de la página Runtime ahora acepta un código de estado HTTP (100–599) para buscar entradas de registro de Custom API, Proxy API y OData API, además de un nombre de estado de operación para entradas de registro de Operation. Anteriormente, buscar con un código de estado HTTP devolvía un error y ninguna entrada de registro de API.

Studio

• La transformación ahora guarda múltiples scripts de asignación abiertos sin un error de conflicto
  El editor de transformación ya no muestra un falso conflicto de guardado cuando tienes múltiples scripts de asignación abiertos y editados al mismo tiempo. Anteriormente, editar contenido de script o valores de campo en varios scripts abiertos podía activar intermitentemente un mensaje de conflicto de guardado; resolverlo descartaba los cambios no guardados y cerraba cualquier script de asignación abierto.

Avisos

Agente

• Retiro del versionamiento del agente privado 11.x
  La versión 11.59 / 12.3 incluyó la versión final del agente privado 11.x (11.59) y la primera versión disponible del agente privado 12.x (12.3). Ten en cuenta lo siguiente respecto a futuras versiones:

  • Versión final 11.x: La versión del agente privado 11.x ha llegado al final de su desarrollo planeado. Todas las mejoras futuras, nuevas características y actualizaciones de seguridad se entregarán a través de agentes privados 12.x. Aunque los agentes 11.x pueden recibir correcciones críticas raras para problemas que impacten la producción, no se planean versiones continuas.

  • Recomendación: Te recomendamos encarecidamente actualizar a agentes privados 12.x lo antes posible para beneficiarte de las últimas mejoras de rendimiento, seguridad y características.

  • Ruta de actualización: Puedes actualizar directamente de 11.x a cualquier versión 12.x utilizando nuestras instrucciones de actualización documentadas: Windows, Linux o Docker.

  Acciones requeridas: Actualizaciones de complementos y verificación de conectores personalizados para agentes privados 12.x

  • Actualizaciones de complementos para agentes privados 12.x
    Las mejoras de rendimiento y seguridad para agentes privados 12.x son incompatibles con los complementos Multipart Pipeline y AWS S3 Create. Si utilizas estos complementos, se requiere acción del usuario como se describe en las instrucciones de actualización.

• Verificación de conectores personalizados para agentes privados 12.x
  Los conectores creados por terceros con el SDK de Connector deben someterse a cambios de desarrollo para ser compatibles con agentes privados 12.x. Antes de actualizar a agentes privados 12.x, verifica la compatibilidad con el desarrollador del conector, o las operaciones que utilizan esos conectores comenzarán a fallar en el momento de la actualización.

• Fin de vida útil para la versión 11.46
  A partir del 17 de julio de 2026, la versión 11.46 del agente privado ha llegado al fin de su vida útil y ya no es compatible. Recomendamos que los usuarios de esta versión actualicen a la versión más reciente lo antes posible.

Conectores

• Acción requerida: Próxima eliminación de la actividad Cloud Datastore Query Items obsoleta
  En una próxima versión, la actividad Query Items obsoleta en el conector Cloud Datastore se eliminará permanentemente. Esta actividad fue reemplazada en la versión 11.47 por la actividad Query Items rediseñada, cuya estructura de respuesta aplanada devuelve los campos individuales que defines en la página Cloud Datastore de la Consola de administración directamente en el nivel superior de la respuesta.

  Importante

  Si utilizas la actividad Query Items obsoleta en cualquier operación, debes revisar el diseño de tu operación y reemplazarla con la actividad Query Items rediseñada lo antes posible. La actividad obsoleta ya no es compatible y se eliminará en una versión futura.

Design Studio

• Requisito de versión incorrecto en proyectos con un endpoint de Salesforce
  Design Studio 11.63 y 11.64 pueden marcar un proyecto que contiene un endpoint de Salesforce con una versión requerida de 12.7.0.0, una versión de Design Studio que no existe. Abrir o importar un proyecto afectado falla con un error que indica que el Jitterpak requiere la versión 12.7.0.0 o superior. Design Studio 11.64.1, disponible en la página Descargas del portal Harmony, exporta el requisito de versión correcto. Para corregir un proyecto que ya está afectado, consulta Problemas conocidos de Design Studio.