Resolva problemas de registos de execução com falhas através da IA

A integração de aplicações oferece resolução de problemas baseada em IA para execuções com falhas. Esta funcionalidade usa o Google Gemini para analisar registos de execução, determinar as causas principais e gerar recomendações acionáveis. Pode aceder a esta funcionalidade na página Registos de execução na integração de aplicações.

Nota: os seus dados não são armazenados na IA do Gemini.

Principais vantagens

Ao usar a funcionalidade de resolução de problemas com tecnologia de IA do Gemini, pode:

• Compreender claramente mensagens de erro complexas. A IA transforma os registos técnicos em estatísticas claras e acionáveis.
• Receber passos de resolução precisos e personalizados para a sua lógica de integração exclusiva e erros específicos encontrados.
• Reduza o tempo de depuração identificando as causas principais e os passos de correção para as correções.

Antes de começar

Antes de poder usar a funcionalidade de resolução de problemas de IA do Gemini, tem de:

• Ative as capacidades de IA para a Google Cloud região específica onde implementa a sua integração. Para mais informações sobre como ativar as capacidades de IA para uma região nova ou existente, consulte o artigo Ative as capacidades de IA para a resolução de problemas.

Ative as capacidades de IA para a resolução de problemas

Para usar a IA do Gemini para resolver problemas de execuções com falhas, ative as capacidades de IA para a Google Cloud região específica onde implementa a sua integração.

Ative a IA para uma nova região

Para ativar a IA para uma nova região na integração de aplicações, siga estes passos:

1. Na Google Cloud consola, aceda à página Application Integration.

   Aceda à solução Application Integration

2. No menu de navegação, clique em Regiões. É apresentada a página Regiões com todas as regiões aprovisionadas no seu projeto.
3. Clique em Aprovisionar nova região.
4. Expanda Definições avançadas.
5. Clique no botão Ativar funcionalidades de IA em Funcionalidades de IA.

Ative a IA numa região existente

Para ativar a IA para uma região existente na integração de aplicações, siga estes passos:

1. Na Google Cloud consola, aceda à página Application Integration.

   Aceda à solução Application Integration

2. No menu de navegação, clique em Regiões. É apresentada a página Regiões com todas as regiões aprovisionadas no seu projeto.
3. Para a região existente que quer editar, na coluna Ações, clique em Ações da região e selecione Editar.

   É apresentado o painel Editar região.

4. Expanda a secção Definições avançadas.
5. Clique no botão Ativar funcionalidades de IA em Funcionalidades de IA.

Resolva problemas de execuções com falhas através da IA

Nota: só é possível resolver problemas de execuções com falhas de integrações publicadas através desta funcionalidade.

Para resolver problemas de um registo de execução com falhas através da IA do Gemini, faça o seguinte:

1. Na Google Cloud consola, aceda à página Application Integration.

   Aceda à solução Application Integration

2. No menu de navegação, clique em Registos.

   A página Registos de execução é apresentada com os registos de execução gerados para as integrações na região predefinida.

3. Na página Registos de execução, localize uma entrada que mostre um erro com o estado Falhou.
4. Clique no ícone chat_spark junto à entrada de registo com falha.
   • Em alternativa, expanda a linha específica e clique em Explicar esta entrada do registo.

   É aberta a página Resumo de erros, que apresenta o resumo de erros gerado pelo Gemini, incluindo as seguintes secções:

   • Mensagem de erro: apresenta a descrição técnica do erro e indica onde o erro ocorre no código.
   • Causa principal: explica o motivo pelo qual o erro ocorreu.
   • Análise detalhada: (expanda esta secção) fornece mais detalhes sobre o impacto do erro, as áreas de código específicas envolvidas e como corrigi-lo.
   • Passos para corrigir o erro: fornece instruções de correção específicas para a causa principal identificada.
   Nota: pode receber respostas de depuração mais detalhadas para registos com falhas dos seguintes tipos de tarefas: tarefa de chamador REST, tarefa de conetores, tarefa de JavaScript, tarefa de mapeamento de dados, tarefa de função na nuvem e tarefa de transformador de dados. Isto deve-se ao facto de serem fornecidas instruções adicionais ao modelo Gemini para estes tipos de tarefas específicos.
   Nota: quando tenta novamente a resolução de problemas, pode receber uma resposta diferente, uma vez que as respostas são geradas por um modelo do Gemini.
   Nota: se as funcionalidades de IA estiverem desativadas, o botão Ativar funcionalidades de IA é apresentado na primeira vez que tenta aceder à página Resumo de erros.
   Tempo de carregamento: a página Resumo de erros pode demorar até 20 segundos a carregar no acesso inicial devido à análise de IA.
5. Depois de rever o resumo dos erros e compreender o problema, clique em Fechar para voltar à página Registos de execução.

Resolva problemas com recomendações de IA

Depois de rever o resumo dos erros, resolva o problema concluindo os seguintes passos:

1. Siga as recomendações: implemente os passos recomendados e faça todas as alterações necessárias à lógica de integração ou à configuração do conector, conforme indicado na secção Passos para corrigir o erro na página Resumo de erros.
2. Teste e republique: após concluir as modificações, teste e republique a integração atualizada para confirmar que o problema está totalmente resolvido.

Exemplo de resumo de erro

O exemplo seguinte descreve um resumo de erros gerado pela IA de uma execução com falha:

• Mensagem de erro:

  RUNTIME ERROR: Index 0 out of bounds, not within [0, 0)
  template:16:2-59 function
  template:17:40-78 function
  :259:50-62 function
  :259:55-61 thunk from>
  template:20:39-40 thunk from>
  :1613:20-21 thunk from>
  :32:25-26 thunk from>
  :32:16-27 function
  :1613:8-22 function

• Causa principal: o erro Index 0 out of bounds, not within [0, 0) indica uma tentativa de aceder ao primeiro elemento (índice 0) de uma matriz vazia. Este problema ocorre na linha 16 do seu código, especificamente nestas partes do script:
  • Função getMergedObject(orderId): esta função devolve uma matriz vazia [] quando não consegue encontrar uma ordem correspondente em ordersSalesforce.
  • local orders = std.map(...);: esta linha causa um erro index 0 out of bounds quando tenta aceder ao primeiro elemento do resultado devolvido por getMergedObject(orderId), porque o resultado é uma matriz vazia [].
• Análise detalhada:
  • Função getMergedObject(orderId): esta função procura uma ordem correspondente na matriz ordersSalesforce. Se não forem encontradas correspondências, a função devolve uma matriz vazia []. Este é um comportamento esperado quando o orderId não é encontrado na matriz ordersSalesforce.
  • Linha local orders = std.map (...);: esta linha usa a função std.map para processar dados. No entanto, tenta aceder diretamente ao primeiro elemento da matriz devolvida por getMergedObject(orderId) sem verificar se a matriz está vazia. Quando a matriz está vazia, isto resulta num erro index 0 out of bounds.
  Passos para corrigir o erro:
  • Aceda à secção Autenticação na sua associação ao Salesforce.
  • Valide o token de acesso e a versão secreta.
  • Indique valores válidos para o token de acesso e a versão secreta.
  • Teste e volte a publicar a integração para aplicar as alterações.