Resolver problemas de registros de execução com falha usando a IA

O Application Integration oferece solução de problemas com tecnologia de IA para execuções com falha. Esse recurso usa o Google Gemini para analisar registros de execução, determinar causas raiz e gerar recomendações práticas. Acesse esse recurso na página Registros de execução da Application Integration.

Observação:seus dados não são armazenados na IA do Gemini.

Principais vantagens

Ao usar o recurso de solução de problemas com tecnologia de IA do Gemini, você pode:

• Entenda melhor mensagens de erro complexas. A IA transforma registros técnicos em insights claros e úteis.
• Receba etapas de resolução precisas adaptadas à sua lógica de integração exclusiva e aos erros específicos encontrados.
• Reduza o tempo de depuração identificando as causas principais e as etapas de correção.

Antes de começar

Antes de usar o recurso de solução de problemas da IA do Gemini, você precisa:

• Ative os recursos de IA para a Google Cloud região específica em que você implanta sua integração. Para mais informações sobre como ativar recursos de IA para uma região nova ou atual, consulte Ativar recursos de IA para solução de problemas.

Ativar recursos de IA para solução de problemas

Para usar a IA do Gemini na solução de problemas de execuções com falha, ative os recursos de IA na região Google Cloud específica em que você implanta a integração.

Ativar a IA para uma nova região

Para ativar a IA em uma nova região no Application Integration, siga estas etapas:

1. No console do Google Cloud , acesse a página Application Integration.

   Acessar o Application Integration

2. No menu de navegação, clique em Regiões. A página Regiões aparece com todas as regiões provisionadas no seu projeto.
3. Clique em Provisionar nova região.
4. Expanda Configurações avançadas.
5. Clique no botão Ativar recursos de IA em Recursos de IA.

Ativar a IA em uma região

Para ativar a IA em uma região atual do Application Integration, siga estas etapas:

1. No console do Google Cloud , acesse a página Application Integration.

   Acessar o Application Integration

2. No menu de navegação, clique em Regiões. A página Regiões aparece com todas as regiões provisionadas no seu projeto.
3. Na coluna Ações da região que você quer editar, clique em Ações da região e selecione Editar.

   O painel Editar região aparece.

4. Expanda a seção Configurações avançadas.
5. Clique no botão Ativar recursos de IA em Recursos de IA.

Resolver problemas de execuções com falha usando a IA

Observação:só é possível resolver problemas de execuções com falha de integrações publicadas usando esse recurso.

Para resolver um problema com um registro de execução com falha usando a IA do Gemini, faça o seguinte:

1. No console do Google Cloud , acesse a página Application Integration.

   Acessar o Application Integration

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

   A página Registros de execução aparece listando os registros de execução gerados para as integrações na região padrão.

3. Na página Registros de execução, localize uma entrada que mostre um status erro Falha.
4. Clique no ícone chat_spark ao lado da entrada de registro com falha.
   • Se preferir, abra a linha específica e clique em Explicar esta entrada de registro.

   Isso abre a página Resumo de erros, que mostra o resumo de erros gerado pelo Gemini, incluindo as seguintes seções:

   • Mensagem de erro: mostra a descrição técnica do erro e aponta onde ele ocorre no código.
   • Causa raiz: explica por que o erro ocorreu.
   • Análise detalhada: expanda esta seção para mais detalhes sobre o impacto do erro, as áreas específicas do código envolvidas e como corrigir o problema.
   • Etapas para corrigir o erro: fornece instruções de correção específicas para a causa raiz identificada.
   Observação:você pode receber respostas de depuração mais detalhadas para registros com falha dos seguintes tipos de tarefas: Tarefa de chamada REST, Tarefa de conectores, Tarefa JavaScript, Tarefa de mapeamento de dados, Tarefa de função do Cloud e Tarefa de transformação de dados. Isso acontece porque o modelo do Gemini recebe instruções adicionais para esses tipos de tarefas específicas.
   Observação:quando a solução de problemas é repetida, você pode receber uma resposta diferente, já que elas são geradas por um modelo do Gemini.
   Observação:se os recursos de IA estiverem desativados, o botão Ativar recursos de IA vai aparecer na primeira vez que você tentar acessar a página Resumo de erros.
   Tempo de carregamento:a página Resumo de erros pode levar até 20 segundos para carregar no acesso inicial devido à análise de IA.
5. Depois de analisar o resumo do erro e entender o problema, clique em Fechar para voltar à página Registros de execução.

Resolver problemas usando recomendações de IA

Depois de analisar o resumo do erro, resolva o problema seguindo estas etapas:

1. Siga as recomendações: implemente as etapas recomendadas e faça todas as mudanças necessárias na lógica de integração ou na configuração do conector, conforme indicado na seção Etapas para corrigir o erro da página Resumo do erro.
2. Teste e republicação: depois de concluir as modificações, teste e republique a integração atualizada para confirmar que o problema foi totalmente resolvido.

Exemplo de resumo de erro

O exemplo a seguir descreve um resumo de erros gerado por 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 acessar o primeiro elemento (índice 0) de uma matriz vazia. Esse problema ocorre na linha 16 do seu código, especificamente nestas partes do script:
  • Função getMergedObject(orderId): retorna uma matriz vazia [] quando não encontra um pedido correspondente em ordersSalesforce.
  • Linha local orders = std.map(...);: essa linha causa um erro index 0 out of bounds quando tenta acessar o primeiro elemento do resultado retornado por getMergedObject(orderId) porque o resultado é uma matriz vazia [].
• Análise detalhada:
  • Função getMergedObject(orderId): procura uma ordem correspondente na matriz ordersSalesforce. Se nenhuma correspondência for encontrada, ela vai retornar uma matriz vazia []. Esse é o comportamento esperado quando o orderId não é encontrado na matriz ordersSalesforce.
  • Linha local orders = std.map (...);: usa a função std.map para processar dados. No entanto, ele tenta acessar diretamente o primeiro elemento da matriz retornada por getMergedObject(orderId) sem verificar se a matriz está vazia. Quando a matriz está vazia, isso resulta em um erro index 0 out of bounds.
  Etapas para corrigir o erro:
  • Acesse a seção Autenticação na sua conexão do Salesforce.
  • Verifique o token de acesso e a versão do secret.
  • Informe valores válidos para o token de acesso e a versão do secret.
  • Teste e republique a integração para aplicar as mudanças.