12.12 Notas de la versión de Harmony

Versión 12.12 Harmony

La versión 12.12 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.68 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 suscribirse 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

AI Agents

• Sales Quote Agent
  El Sales Quote Agent, al que se accede desde la categoría AI Agent del Marketplace, orquesta el proceso de creación de cotizaciones de extremo a extremo en Salesforce a través de una interfaz conversacional de Slack, aplicando porcentajes de incremento, prorrateo y lógica de renovación de varios años para generar cotizaciones y PDFs de cotizaciones. Para agregarlo a tu licencia, contáctanos.

MCP

• Jitterbit MCP (Beta)
  La nueva aplicación Jitterbit MCP te permite exponer tus integraciones y APIs de Harmony como herramientas, recursos y prompts de Model Context Protocol (MCP) que los asistentes y agentes de IA pueden descubrir y usar.

  Los servidores MCP se gestionan de forma centralizada: tú controlas la autenticación, el acceso y los límites de velocidad, y las credenciales utilizadas para acceder a las integraciones y APIs subyacentes nunca se exponen a los clientes MCP. Puedes ejecutar servidores MCP en la nube de Jitterbit, o en un runtime MCP privado y una puerta de enlace MCP que despliegues tú mismo.

  Para abrir Jitterbit MCP, haz clic en el mosaico MCP Servers en el portal de Harmony, o usa el menú del portal de Harmony para seleccionar MCP. Jitterbit MCP incluye estas páginas:

  • Servers: Crea, configura, prueba y publica servidores MCP y sus herramientas, recursos y prompts.
  • Logs: Rastrea las solicitudes MCP y sus ejecuciones de API y operaciones relacionadas para solucionar problemas.
  • Analytics: Monitorea el volumen de solicitudes, las tasas de éxito y error, y el uso por servidor, herramienta, recurso y prompt.
  • Service Tokens: Crea y gestiona los tokens de servicio que los runtimes MCP privados y las puertas de enlace MCP usan para autenticarse.

  Para conectar una operación de Studio a un servidor Jitterbit MCP, consulta Conectar a un servidor Jitterbit MCP usando el conector MCP Client. Para solicitar acceso beta o proporcionar comentarios, contacta al equipo de producto de Jitterbit.

Mejoras

Agente

• Mejoras de seguridad
  Se ha actualizado la versión de ActiveMQ incluida con el agente y utilizada por el conector JMS de Design Studio.

API Manager

• Tipo de autenticación personalizado para perfiles de seguridad
  Un perfil de seguridad ahora admite un tipo de autenticación Personalizado que valida una firma HMAC-SHA256 o HMAC-SHA512 incluida en un encabezado de solicitud que especifiques. Configura el Algoritmo de firma, el Nombre del encabezado de firma y el Secreto compartido, junto con el Código de estado no autorizado y el Cuerpo de respuesta no autorizado que se devuelven cuando falla la validación.

Conectores

• Memoria a corto plazo del conector Anthropic Claude
  Una conexión Anthropic Claude tiene una nueva configuración Almacenar contexto de chat entre operaciones que habilita la memoria a corto plazo para grupos de agentes en la nube, conservando el contexto de chat más allá de una sola operación mediante un chatId compartido. Cuando está habilitada, usa las nuevas configuraciones TTL del contexto de chat, Máximo de mensajes guardados en el contexto y Cuando no se encuentra el contexto de chat para configurar la retención y el comportamiento de respaldo. Los agentes privados ya conservan el contexto de chat en memoria para las operaciones de la misma cadena y no se ven afectados por esta configuración.

• Memoria a corto plazo del conector Google Gemini
  Una conexión Google Gemini tiene una nueva configuración Almacenar contexto de chat entre operaciones que habilita la memoria a corto plazo para grupos de agentes en la nube, conservando el contexto de chat más allá de una sola operación mediante un chatId compartido. Cuando está habilitada, usa las nuevas configuraciones TTL del contexto de chat, Máximo de mensajes guardados en el contexto y Cuando no se encuentra el contexto de chat para configurar la retención y el comportamiento de respaldo. Los agentes privados ya conservan el contexto de chat en memoria para las operaciones de la misma cadena y no se ven afectados por esta configuración.

• Compatibilidad del conector Salesforce Einstein Analytics con flujos OAuth 2.0 Client Credentials y JWT Bearer
  La conexión Salesforce Einstein Analytics tiene un nuevo campo Autenticación con tres opciones: Username-Password (predeterminado, existente), Client Credentials (nuevo soporte) y JWT Bearer (nuevo soporte).

  • Client Credentials requiere una aplicación cliente externa de Salesforce, o una aplicación conectada existente, configurada para el flujo de credenciales de cliente OAuth 2.0. Consulta Requisitos previos de OAuth 2.0 de 2 patas para las instrucciones de configuración.
  • JWT Bearer requiere una aplicación conectada de Salesforce configurada con un certificado digital. Consulta la documentación de Salesforce Flujo JWT Bearer de OAuth 2.0 para integración servidor a servidor.

• Compatibilidad del conector Salesforce Events con flujos OAuth 2.0 Client Credentials y JWT Bearer
  La conexión Salesforce Events tiene un nuevo campo Autenticación con tres opciones: Username-Password (predeterminado, existente), Client Credentials (nuevo soporte) y JWT Bearer (nuevo soporte).

  • Client Credentials requiere una aplicación cliente externa de Salesforce, o una aplicación conectada existente, configurada para el flujo de credenciales de cliente OAuth 2.0. Consulta Requisitos previos de OAuth 2.0 de 2 patas para las instrucciones de configuración.
  • JWT Bearer requiere una aplicación conectada de Salesforce configurada con un certificado digital. Consulta la documentación de Salesforce Flujo JWT Bearer de OAuth 2.0 para integración servidor a servidor.

Management Console

• Clave de búsqueda Log Type en la página Runtime
  La página Runtime de la Management Console tiene una nueva clave de búsqueda logType. Usa = o != para filtrar entradas de registro por tipo de registro: Operation, Custom API, Proxy API u OData API.

• Compatibilidad del Management AI Assistant con Cloud Datastore, uso de endpoints y tokens de acceso
  El Management AI Assistant (Beta) incluye las siguientes actualizaciones:

  • Cloud Datastore: Ahora puede listar, buscar, crear, editar y eliminar almacenamientos de estado y almacenamientos de claves.
  • Endpoints Usage: Ahora puede listar, buscar y ver detalles de endpoints.
  • Access Tokens: Ahora puede listar, buscar, crear, editar, activar, desactivar y eliminar tokens de acceso.

• Uso de MCP en la página Dashboard
  El mosaico Licensed vs Actual Use en la página Dashboard de la Management Console ahora muestra el uso licenciado y real de servidores MCP, herramientas MCP y solicitudes MCP mensuales. El Management AI Assistant también puede informar estos recuentos.

Studio

• Detalles de despliegue en el historial del proyecto
  Los eventos de despliegue en el historial del proyecto ahora identifican lo que se desplegó. Cuando se despliega una sola operación, la entrada muestra un icono de operación y el nombre de la operación. Cuando se despliega un proyecto completo, la entrada muestra un icono de proyecto y el nombre del proyecto. Cuando se usa el despliegue configurable para desplegar múltiples operaciones, la entrada principal se puede expandir para ver cada operación desplegada individualmente.

• Visualización del entorno de origen para la transferencia selectiva
  El paso Seleccionar entorno de destino y etiqueta de la función de transferencia selectiva ahora muestra un campo Entorno de origen con el nombre del entorno desde el cual se transfirió originalmente el proyecto, o No source environment si el proyecto nunca ha sido transferido. Este entorno permanece excluido del menú Entorno de destino, ya que un proyecto no puede transferirse de vuelta al entorno desde el que fue promovido.

Cambios

Management Console

• Console AI Assistant renombrado a Management AI Assistant
  El Console AI Assistant (Beta) ahora se llama Management AI Assistant (Beta). Permite monitorear, solucionar problemas y gestionar tu organización de Harmony interactuando con la Management Console en lenguaje natural, en lugar de navegar entre páginas para encontrar información o realizar un cambio.

Correcciones

Agente

• JSONStringify y JSONParser ahora manejan correctamente valores numéricos, booleanos y null
  Las funciones JSONStringify y JSONParser incluyen estas correcciones:

  • Convertir un diccionario que contiene un campo numérico, como uno creado por JSONParser a partir de una cadena JSON con valores numéricos, ya no falla con el error Unknown DataElement type seen.
  • Los valores decimales ya no se truncan a 6 dígitos significativos.
  • Los valores booleanos ahora se devuelven como true y false en lugar de 1 y 0.
  • JSONParser ahora preserva los campos de objeto y elementos de matriz con un valor null en lugar de omitirlos.

• Los valores de anulación por operación no numéricos para los límites de invocación ahora utilizan el valor predeterminado configurado
  Establecer cualquiera de las siguientes variables de Jitterbit en un valor no numérico ahora utiliza correctamente el valor predeterminado de jitterbit.conf correspondiente, en lugar de deshabilitar el límite por completo:

  • jitterbit.operation.max_sync_runop_calls_in_loop: Utiliza el valor predeterminado de MaxSynchronousRunOperationCallsInLoop (50 por defecto), que limita las llamadas síncronas dentro de un bucle While.
  • jitterbit.operation.max_async_chain_length: Utiliza el valor predeterminado de MaxAsyncOperationChainLength (50 por defecto), que limita la longitud de una cadena de operaciones asíncronas.

  Ambas configuraciones se establecen en la sección [OperationEngine] del archivo jitterbit.conf. Anteriormente, un valor no numérico deshabilitaba el límite correspondiente por completo, permitiendo una invocación ilimitada.

• GetLastError ahora identifica por nombre de operación un exceso del límite de bucle RunOperation síncrono
  Cuando se alcanza el límite de un bucle While en llamadas síncronas a RunOperation, GetLastError y el registro de operación ahora identifican la operación secundaria que activó el límite por su nombre de operación, utilizando su GUID como alternativa si el nombre no se puede resolver. Anteriormente, GetLastError no devolvía esta información de identificación y el registro de operación identificaba la operación solo por su GUID.

API Manager

• El nombre de usuario de autenticación Basic del perfil de seguridad ahora se valida al guardar
  El campo Nombre de usuario de un perfil de seguridad que usa autenticación Basic ahora se valida al guardar el perfil de seguridad, bloqueando los caracteres no permitidos que anteriormente causaban que una solicitud de API fallara más tarde con un error INVALID_TRIGGER_USER. Un perfil de seguridad guardado antes de esta versión no se revalida, por lo que puede seguir conteniendo un carácter no permitido y fallar en tiempo de ejecución de la misma manera.

Conectores

• El conector Cloud Datastore ahora envía los cuerpos de solicitud con la codificación de caracteres correcta
  Las actividades Insert Items, Update Items y Delete Items del conector Cloud Datastore ahora envían el cuerpo de la solicitud con codificación UTF-8. Anteriormente, estas actividades podían enviar el cuerpo de la solicitud con un conjunto de caracteres incorrecto, causando un error cuando los datos contenían caracteres multibyte.

• La actividad HTTP v2 DELETE ahora envía el cuerpo de la solicitud
  La actividad DELETE del conector HTTP v2 ahora incluye el cuerpo de la solicitud configurado en la solicitud saliente. Anteriormente, la actividad no adjuntaba el cuerpo de la solicitud al enviar una solicitud DELETE, por lo que el endpoint de destino recibía un payload vacío y podía rechazar la solicitud.

• El conector Microsoft Excel v2 ahora se carga correctamente en agentes privados de Linux 12.x
  El conector Microsoft Excel v2 ahora se carga correctamente en agentes privados de Linux 12.x. Anteriormente, probar una conexión o ejecutar una operación con este conector en un agente privado de Linux 12.x devolvía un error que indicaba que el conector no se encontró en el agente. Para aplicar esta corrección, haz clic en Test en la conexión en Studio para descargar la última versión del conector, o usa la página Agents de la Management Console y elige Action > Update connectors para forzar la actualización en todo el grupo de agentes.

• La actividad OData Query ya no incluye un parámetro $skip cuando Skip se deja vacío
  El URI de solicitud de la actividad Query de OData ya no incluye un parámetro $skip cuando el campo Skip se deja vacío. Anteriormente, dejar Skip vacío causaba que la solicitud incluyera $skip=0, en lugar de omitir el parámetro por completo, lo que podía causar que la operación fallara contra un endpoint OData que rechaza un parámetro $skip no reconocido, como Microsoft Dynamics 365 CRM.

• El esquema de respuesta de la actividad OpenAI Create Image ahora incluye generation_id
  El esquema de respuesta de la actividad Create Image de OpenAI ahora incluye el campo generation_id devuelto por la API de OpenAI. Anteriormente, este campo faltante causaba que las operaciones exitosas reportaran un estado Success with Warning en lugar de Success with Info. Para aplicar esta corrección a una actividad existente, regenera sus esquemas.

• Los esquemas de respuesta de las actividades Pinecone Query Vectors y Fetch Vectors ahora incluyen egressBytes
  Los esquemas de respuesta de las actividades Query Vectors y Fetch Vectors de Pinecone ahora incluyen el campo egressBytes devuelto dentro del objeto usage por la API de Pinecone. Anteriormente, este campo faltante causaba que las operaciones exitosas reportaran un estado Success with Warning en lugar de Success with Info. Para aplicar esta corrección a una actividad existente, regenera sus esquemas.

• La creación de Checkout Session del conector Stripe ya no falla con un error interno
  El sub-objeto Checkout > Sessions de la actividad Create de Stripe ya no falla con un error interno antes de que la solicitud llegue a Stripe. Anteriormente, crear una sesión podía fallar con un error similar a The Exception is: "null", incluso cuando todos los campos requeridos (como mode, currency, success_url y customer) se proporcionaban correctamente. Para aplicar esta corrección a una actividad existente, debes regenerar sus esquemas.

Portal de Harmony

• El Asistente de IA ahora carga por defecto según la aplicación que estás usando
  Jitterbit AI en el encabezado del portal de Harmony ahora carga el Asistente de IA APIM por defecto en API Manager y Studio, el Management AI Assistant en Management Console, o el Asistente de IA EDI en Jitterbit EDI, para las organizaciones con acceso a ese asistente. Anteriormente, AskJB AI siempre cargaba por defecto, lo que requería cambiar el tipo de bot manualmente.

Studio

• Las operaciones ya no revierten a No desplegado después de cambiar entre endpoints locales y globales
  Desplegar una operación después de cambiar el endpoint asignado para una de sus actividades entre un endpoint local y un endpoint global, o viceversa, ahora establece y conserva el estado de despliegue correcto. Anteriormente, la operación podía mostrarse como desplegada exitosamente inmediatamente después del despliegue, pero revertir a mostrar el estado No desplegado después de recargar el proyecto, aunque no se hubieran realizado más cambios.

Avisos

Agente

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

  • Versión final 11.x: La versión de 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 lanzamientos continuos.
  • Recomendación: Recomendamos ampliamente actualizar a agentes privados 12.x lo antes posible para beneficiarse 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 usando 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 construidos por un tercero con el Connector SDK 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.

Agent y puerta de enlace de API

• Fin de vida para la versión 11.50
  A partir del 9 de octubre de 2026, estas versiones de producto han llegado al fin de vida y ya no son compatibles:

  • Versión 11.50 del agente privado
  • Versión 11.50 de la puerta de enlace de API privada

  Se recomienda que los usuarios de estas versiones actualicen a la versión más reciente lo antes posible.

Conectores

• Acción requerida: Desuso de las actividades OpenAI Prompt y Register Tools
  Las actividades Prompt y Register Tools de OpenAI ahora están obsoletas y ya no son compatibles, y se eliminarán permanentemente en una próxima versión. Ambas fueron reemplazadas en la versión 12.8 por las actividades rediseñadas Prompt V2 y Register Tools V2, cuyo uso de la API de Respuestas de OpenAI permite persistir el contexto de chat e invocar herramientas registradas en grupos de agentes en la nube, no solo en agentes privados.

  Importante

  Si utilizas la actividad Prompt (Deprecated) o Register Tools (Deprecated) en cualquier operación, debes revisar el diseño de tu operación y reemplazarla con la actividad Prompt V2 o Register Tools V2 lo antes posible, ya que las actividades obsoletas ya no son compatibles y se eliminarán en el futuro.

• Acción requerida: Próxima eliminación de la actividad deprecated Cloud Datastore Query Items
  En una próxima versión, la actividad Query Items deprecated 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 Management Console directamente en el nivel superior de la respuesta.

  Importante

  Si utilizas la actividad Query Items deprecated 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 deprecated ya no es compatible y se eliminará en una versión futura.