12.11 Notas de lançamento do Harmony

Lançamento do Harmony 12.11

O lançamento do Harmony 12.11 é escalonado com base nas datas e horários listados abaixo por componente e região. Para uma explicação mais detalhada do cronograma de lançamento por categoria de componente, consulte o cronograma de lançamento.

O App Builder 4.67 e o Wevo iPaaS possuem notas de lançamento separadas.

Compilações de notas de lançamento para Production Cloud Agent Groups, Sandbox Cloud Agent Groups e agentes privados também estão disponíveis.

É possível se inscrever em notificações de manutenção para componentes baseados na web em Jitterbit Trust. Componentes instalados localmente estão disponíveis na página Downloads. Imagens de agente privado Docker, gateway de API privado e App Builder estão disponíveis no Docker Hub da Jitterbit. A data de fim de vida útil para esses componentes (exceto App Builder) é um ano após a data de lançamento.

Novos recursos

Conectores

• Conector ServiceNow v2
  O conector ServiceNow v2 agora está disponível para o público em geral. Pode ser usado com agentes na nuvem ou privados para consultar, criar, atualizar ou excluir registros no ServiceNow.

Melhorias

Agent

• Pool de conexões para conexões de banco de dados de origem e destino
  Os agentes agora podem reutilizar conexões JDBC em pool para uma conexão de banco de dados no Studio e uma origem ou destino de banco de dados no Design Studio, em vez de abrir e fechar uma nova conexão para cada operação. Isso reduz a sobrecarga de conexão e melhora a confiabilidade sob carga concorrente pesada. O pool de conexões está desabilitado por padrão. Para habilitá-lo em um agente privado, defina jdbc.hikari.enabled=true na seção [SourceTargetPooling] de jitterbit.conf e reinicie o agente.

Conectores

• Suporte do conector Amazon Bedrock para modelos GPT-5.6
  As atividades Prompt e Registrar Ferramentas do Amazon Bedrock agora suportam a família de modelos GPT-5.6 da OpenAI: gpt-5.6-sol, gpt-5.6-terra e gpt-5.6-luna. Como esses modelos exigem um ID de perfil de inferência da AWS em vez de um ID de modelo sob demanda, selecione a opção Inserir identificador de modelo e insira o ID de perfil de inferência do modelo (por exemplo, us.openai.gpt-5.6-sol) em vez de selecionar o modelo na tabela Listar todos os modelos.

• Disponibilidade geral e seleção padrão da atividade MCP Client Prompts and Resources
  O conector MCP Client inclui as seguintes atualizações em suas atividades Prompts and Resources:

  • Disponibilidade geral: As atividades Listar Recursos, Listar Prompts, Obter Prompt e Ler Recurso agora estão geralmente disponíveis.
  • Seleção padrão: As etapas Escolher ferramenta, Escolher prompt e Escolher recurso das atividades Invocar Ferramentas, Obter Prompt e Ler Recurso agora usam como padrão a opção Selecionar ferramenta da lista, Selecionar prompt da lista e Selecionar recurso da lista, em vez da opção de entrada manual.

• Rótulos de entrada manual padronizados entre conectores
  Os conectores agora usam um rótulo consistente para a opção de inserir manualmente o nome, ID ou URI de um objeto. Anteriormente, esse rótulo variava por conector, usando expressões como Informar..., Inserir... ou Usar Entradas de Texto.

  • Amazon S3: As atividades Get Object, Put Object, Delete Object, List Objects e Move Object especificam um bucket usando a opção Select Bucket From List ou Provide S3 Bucket Manually.
  • Cloud Datastore: As atividades Insert Items, Query Items, Update Items, Delete Items, Delete Storage e Get Metrics especificam um nome de armazenamento usando a opção Provide storage name manually.
  • Google Pub/Sub: As atividades Get, Publish, Acknowledge e Listener especificam uma assinatura ou tópico usando a opção Provide Subscription Manually ou Provide Topic Manually.
  • MCP Client: As atividades Invoke Tools, Read Resource e Get Prompt especificam uma ferramenta, recurso ou prompt usando a opção Provide tool name manually, Provide resource URI manually ou Provide prompt name manually.
  • Microsoft Azure Key Vault: As atividades Update Vault Objects, Delete Vault Objects e Query Vault Objects especificam um objeto usando a opção Provide object manually.
  • Microsoft Azure Service Bus: A atividade Send Message especifica uma fila ou tópico usando a opção Provide Queue or Topic Manually.
  • Microsoft Teams: A atividade Chat especifica um chat usando a opção Provide Chat ID Manually.
  • SMB: As atividades Create Folder, Create File, Search, Update Folder, Update File, Delete Folder, Delete File e Read File especificam uma pasta usando a opção Provide folder name manually.
  • Slack: A opção Provide Conversation ID Manually e o campo Provide Conversation ID/Channel ID da atividade Send Message especificam a conversa ou o canal.

Console de Gerenciamento

• Status de uso e referências de endpoints na página App Registrations
  A tabela principal da página App Registrations possui novas colunas Usage e Endpoints que mostram se cada registro de aplicativo é referenciado por algum endpoint e, se for o caso, por quantos. A gaveta de detalhes do registro possui uma nova aba Endpoints usage que lista o projeto, ambiente, conector, expiração, status de autorização e data da última implantação para cada endpoint que faz referência, junto com uma ação Go to endpoint para abrir a configuração do endpoint no Studio.

Studio

• Mais tipos de componentes na visualização de diff de importação seletiva e transferência seletiva
  A visualização de diff para revisar conflitos de componentes agora abrange mais tipos de componentes:

  • Importação seletiva: O botão View changes agora abrange ferramentas, operações, variáveis de projeto, notificações de email, endpoints de conector e atividades de conector, além do suporte existente para scripts e transformações. Esses tipos adicionais usam uma nova visualização de diff de comparação de campos, exibida como uma tabela Name, Before e After, junto com a visualização de diff de código lado a lado existente usada para scripts e transformações.
  • Transferência seletiva: O ícone View changes agora também abrange ferramentas, notificações de email, operações, variáveis de projeto e agendamentos, além do suporte existente para script, transformação, endpoint de conector e atividade de conector.

Alterações

Agent

• Limite de chamadas RunOperation síncronas dentro de loops While
  Um loop While que chama RunOperation de forma síncrona agora é limitado a 50 chamadas por padrão, para evitar que um loop descontrolado ou ilimitado invoque milhares de operações filhas. Quando o limite é atingido, RunOperation retorna false e o script continua executando; o motivo está disponível em GetLastError e também é registrado no log de operação.

  Três novas chaves na seção [OperationEngine] do arquivo de configuração do agent privado (jitterbit.conf) controlam esse comportamento:

  • MaxSynchronousRunOperationCallsInLoop: Altera ou remove o limite padrão.
  • MaxSynchronousRunOperationCallsInLoopOverrideAllowed: Controla se uma operação individual pode substituir o limite usando a nova variável Jitterbit jitterbit.operation.max_sync_runop_calls_in_loop.
  • MaxSynchronousRunOperationCallsInLoopCustomError: Personaliza a mensagem de erro exibida quando o limite é atingido.

• Restrições de entidade externa para RunXSLT
  Por motivos de segurança, os agents agora bloqueiam declarações DOCTYPE e resolução de entidades externas por padrão ao processar a função RunXSLT: entrada XML contendo uma referência DOCTYPE, ENTITY ou URI externa é rejeitada. Para permitir esse processamento, atualize a chave correspondente na seção [XsltEngine] do arquivo de configuração do agent (jitterbit.conf) e reinicie o agent.

Gateway de API

• Limite de comprimento do identificador de usuário para logs de API
  O valor registrado para identificar quem fez uma solicitação de API agora é limitado a 256 caracteres, correspondendo ao seu limite de armazenamento subjacente. Uma solicitação falha com um erro TRIGGER_USER_TOO_LONG se esse valor exceder o limite de comprimento. Para resolver esse erro, verifique qual das seguintes opções se aplica:

• Autenticação básica com a configuração padrão de Logging: Atualize o campo Nome de usuário do perfil de segurança para 256 caracteres ou menos e, em seguida, atualize as credenciais em qualquer aplicação chamadora que faça referência ao nome de usuário anterior.

• Configuração de Logging personalizada: Atualize a aplicação chamadora para enviar um valor de cabeçalho com 256 caracteres ou menos.

Correções

Agent

• O conector File Share agora substitui uma variável colocada após uma barra invertida em um caminho
  O campo Path do conector File Share, em sua configuração de conexão, e a função FileList chamada de um script agora substituem uma variável global ou de projeto que vem imediatamente após uma barra invertida (\\) em um caminho UNC (por exemplo, \\\\server\\share\\[myVariable]\\). Anteriormente, a barra invertida imediatamente antes da variável era tratada como um caractere de escape, então o nome literal da variável era usado no caminho em vez de seu valor, causando erros como The system cannot find the path specified.

• A validação de campo do Design Studio agora respeita uma ação Skip Row configurada
  Uma regra de validação de campo do Design Studio configurada com uma ação Skip Row é respeitada novamente durante a execução da operação. A partir da versão 12.6 do agent, uma linha que deveria ter sido ignorada com base em uma regra de validação configurada chegava ao destino inalterada.

• A duração da operação cancelada agora é informada com precisão
  Quando uma operação é cancelada após atingir seu Tempo limite de operação configurado, a Duração mostrada na tabela de detalhes da operação Runtime do Console de Gerenciamento e nos logs de operação agora reflete o tempo real até o cancelamento, normalmente dentro de alguns segundos do valor de tempo limite configurado. Anteriormente, essa duração podia ser informada como até duas vezes o valor de tempo limite configurado, mesmo que a operação fosse cancelada no momento correto.

• Nomes de arquivo multibyte em agents privados do Windows agora processados com confiabilidade
  A leitura ou escrita de um arquivo cujo nome contém caracteres multibyte agora é processada com confiabilidade em agents privados do Windows usando File Share, FTP, Local Storage ou Temporary Storage no Studio ou Design Studio.

Agent e Design Studio

• As edições de conexão Salesforce OAuth 2.0 agora persistem corretamente no Design Studio
  As alterações nos campos Instance URL, Client ID e Client secret de um Salesforce Org existente configurado com autenticação de cliente OAuth 2.0 de 2 pernas agora são salvas antes de Test Salesforce Login ser executado. Anteriormente, testar a conexão imediatamente após editar esses campos podia validar contra os valores anteriores em vez dos atualizados, retornando um resultado de sucesso ou falha enganoso.

API Manager

• O download de CSV do monitoramento de integridade da API agora corresponde ao gateway selecionado
  O download da tabela de monitoramento de integridade da API como CSV na página Analytics agora retorna dados para o mesmo gateway que os resultados exibidos na tela. Anteriormente, o download sempre retornava dados para o gateway padrão da organização, independentemente de qual gateway seus dados estavam selecionados e exibidos no momento.

Conectores do Studio SDK

• O conector Excel v2 agora carrega corretamente em agentes privados do Windows versão 12.x
  O conector Excel v2 agora carrega corretamente em agentes privados do Windows versão 12.x. Anteriormente, testar uma conexão ou executar uma operação usando este conector em um agente privado do Windows versão 12.x retornava um erro indicando que o conector não foi encontrado no agente. Para aplicar essa correção, clique em Testar na conexão no Studio para baixar a versão mais recente do conector, ou use a página Agentes do Console de Gerenciamento e escolha Ação > Atualizar conectores para forçar a atualização em todo o grupo de agentes.

Plataforma Harmony

• Implantações de projeto não falham mais durante um failover de banco de dados
  Implantar um projeto no Studio ou Design Studio não falha mais, nem fica suspenso por um período prolongado, durante um failover de banco de dados. Anteriormente, um failover em andamento ou um evento de manutenção prolongada podia bloquear implantações de projeto até sua conclusão.

• Operações que um agente não consegue executar agora falham mais rapidamente
  Uma operação cujo agente atribuído relata que não consegue executá-la agora faz a transição para o status Erro muito mais rapidamente. Isso também resolve um problema relacionado em que um grande acúmulo de tais operações competia por tentativas de repetição limitadas a cada ciclo, atrasando ainda mais a resolução.

• Dados de Logs de API e Analytics agora registrados para versões mais antigas do gateway de API privada
  Solicitações de API servidas por um gateway de API privada anterior à versão 11.57 agora geram entradas em Logs de API e Analytics. Anteriormente, essas entradas podiam falhar silenciosamente em aparecer, mesmo que a solicitação fosse processada normalmente.

Console de Gerenciamento

• A contagem de acesso da função de ambiente não fica mais imprecisa após edições simultâneas
  A guia Acesso da Função de Ambiente na página Gerenciamento de Usuários e o painel Acesso da Função na página Ambientes agora permanecem sincronizados quando o acesso ao ambiente da mesma função é editado de ambos os locais simultaneamente. Anteriormente, fazer isso podia criar uma associação duplicada de função-ambiente, fazendo com que a contagem de ambiente exibida na página Gerenciamento de Usuários não correspondesse mais ao número real de ambientes ativos da organização.

• A tabela de armazenamento de chaves do Cloud Datastore agora rola horizontalmente
  A tabela de dados de armazenamento de chaves na gaveta de detalhes de um armazenamento de chaves agora exibe uma barra de rolagem horizontal quando suas colunas são mais largas que a gaveta, permitindo rolar para visualizar qualquer coluna, incluindo Ações, que de outra forma se estenderia além da borda direita. Anteriormente, essas colunas eram cortadas sem forma de rolar até elas, embora permanecessem acessíveis por rolagem com shift.

Studio

• Editar certos esquemas grandes ou profundamente aninhados não causa mais falta de resposta do Studio
  Editar um esquema muito grande ou profundamente aninhado não causa mais falta de resposta da guia do navegador ou falta de memória ao clicar em Editar Esquema. Nós em um esquema com 5.000 ou mais nós agora são expandidos para 2 níveis de profundidade por padrão, em vez de 5.

Avisos

Agente

• Descontinuação do versionamento do agente privado 11.x
  A versão 11.59 / 12.3 incluiu a versão final do agente privado 11.x (11.59) e a primeira versão disponível do agente privado 12.x (12.3). Observe o seguinte em relação a versões futuras:

  • Versão final 11.x: A versão do agente privado 11.x atingiu o fim de seu desenvolvimento planejado. Todos os aprimoramentos futuros, novos recursos e atualizações de segurança serão entregues por meio de agentes privados 12.x. Embora agentes 11.x possam receber correções críticas raras para problemas que afetam a produção, nenhuma versão contínua está planejada.
  • Recomendação: Recomendamos fortemente atualizar para agentes privados 12.x o mais breve possível para se beneficiar dos últimos aprimoramentos de desempenho, segurança e recursos.
  • Caminho de atualização: Você pode atualizar diretamente de 11.x para qualquer versão 12.x usando nossas instruções de atualização documentadas: Windows, Linux ou Docker.

  Ações necessárias: Atualizações de plug-in e verificação de conectores personalizados para agentes privados 12.x

  • Atualizações de plug-in para agentes privados 12.x
    Os aprimoramentos de desempenho e segurança para agentes privados 12.x são incompatíveis com os plug-ins Multipart Pipeline e AWS S3 Create. Se você usar esses plug-ins, é necessária uma ação do usuário conforme descrito nas instruções de atualização.
  • Verificação de conectores personalizados para agentes privados 12.x
    Conectores criados por terceiros com o Connector SDK devem passar por alterações de desenvolvimento para serem compatíveis com agentes privados 12.x. Antes de atualizar para agentes privados 12.x, verifique a compatibilidade com o desenvolvedor do conector, ou as operações que usam esses conectores começarão a falhar no momento da atualização.

Agent e gateway de API

• Fim da vida útil da versão 11.49
  A partir de 18 de setembro de 2026, estas versões de produto atingiram o fim da vida útil e não são mais suportadas:

  • Versão 11.49 do agente privado
  • Versão 11.49 do gateway de API privado

  Recomendamos que os usuários dessas versões façam upgrade para a versão mais recente assim que possível.

Conectores

• Ação necessária: Descontinuação das atividades OpenAI Prompt e Register Tools
  As atividades OpenAI Prompt e Register Tools agora estão descontinuadas e não são mais suportadas, e serão removidas permanentemente em uma versão futura. Ambas foram substituídas na versão 12.8 pelas atividades redesenhadas Prompt V2 e Register Tools V2, cujo uso da API de Respostas do OpenAI possibilita persistir o contexto do chat e chamar ferramentas registradas em grupos de agentes na nuvem, não apenas em agentes privados.

  Importante

  Se você estiver usando a atividade Prompt (Descontinuada) ou Register Tools (Descontinuada) em qualquer operação, você deve revisar o design da operação e substituí-la pela atividade Prompt V2 ou Register Tools V2 assim que possível, pois as atividades descontinuadas não são mais suportadas e serão removidas no futuro.

• Ação necessária: Remoção futura da atividade Cloud Datastore Query Items descontinuada
  Em uma versão futura, a atividade Query Items descontinuada no conector Cloud Datastore será removida permanentemente. Esta atividade foi substituída na versão 11.47 pela atividade Query Items redesenhada, cuja estrutura de resposta simplificada retorna os campos individuais que você define na página Cloud Datastore do Console de Gerenciamento diretamente no nível superior da resposta.

  Importante

  Se você estiver usando a atividade Query Items descontinuada em qualquer operação, você deve revisar o design da operação e substituí-la pela atividade Query Items redesenhada assim que possível. A atividade descontinuada não é mais suportada e será removida em uma versão futura.