Résoudre les problèmes liés aux journaux d'exécution ayant échoué à l'aide de l'IA

Application Integration fournit un dépannage optimisé par l'IA pour les exécutions ayant échoué. Cette fonctionnalité utilise Google Gemini pour analyser les journaux d'exécution, déterminer les causes premières et générer des recommandations exploitables. Vous pouvez accéder à cette fonctionnalité depuis la page Journaux d'exécution dans Application Integration.

Remarque : Vos données ne sont pas stockées dans l'IA Gemini.

Principaux avantages

Grâce à la fonctionnalité de dépannage optimisée par Gemini AI, vous pouvez :

• Comprendre clairement les messages d'erreur complexes L'IA transforme les journaux techniques en insights clairs et exploitables.
• Recevez des étapes de résolution précises adaptées à votre logique d'intégration unique et aux erreurs spécifiques rencontrées.
• Réduisez le temps de débogage en identifiant les causes premières et les étapes de correction.

Avant de commencer

Avant de pouvoir utiliser la fonctionnalité de dépannage de Gemini AI, vous devez :

• Activez les fonctionnalités d'IA pour la région Google Cloud spécifique dans laquelle vous déployez votre intégration. Pour savoir comment activer les fonctionnalités d'IA pour une région nouvelle ou existante, consultez Activer les fonctionnalités d'IA pour le dépannage.

Activer les fonctionnalités d'IA pour le dépannage

Pour utiliser l'IA Gemini afin de résoudre les échecs d'exécution, activez les fonctionnalités d'IA pour la région Google Cloud spécifique dans laquelle vous déployez votre intégration.

Activer l'IA pour une nouvelle région

Pour activer l'IA pour une nouvelle région dans Application Integration, procédez comme suit :

1. Dans la console Google Cloud , accédez à la page Application Integration.

   Accéder à Application Integration

2. Dans le menu de navigation, cliquez sur Régions. La page Régions s'affiche et liste toutes les régions provisionnées dans votre projet.
3. Cliquez sur Provisionner une nouvelle région.
4. Développez la section Paramètres avancés.
5. Cliquez sur le bouton Activer les fonctionnalités d'IA sous Fonctionnalités d'IA.

Activer l'IA dans une région existante

Pour activer l'IA pour une région existante dans Application Integration, procédez comme suit :

1. Dans la console Google Cloud , accédez à la page Application Integration.

   Accéder à Application Integration

2. Dans le menu de navigation, cliquez sur Régions. La page Régions s'affiche et liste toutes les régions provisionnées dans votre projet.
3. Pour la région existante que vous souhaitez modifier, dans la colonne Actions, cliquez sur Actions sur la région, puis sélectionnez Modifier.

   Le volet Modifier la région s'affiche.

4. Développez la section Paramètres avancés.
5. Cliquez sur le bouton Activer les fonctionnalités d'IA sous Fonctionnalités d'IA.

Résoudre les problèmes d'exécution ayant échoué à l'aide de l'IA

Remarque : Vous ne pouvez résoudre les problèmes que pour les exécutions ayant échoué des intégrations publiées à l'aide de cette fonctionnalité.

Pour résoudre un problème lié à un journal d'exécution ayant échoué à l'aide de Gemini AI :

1. Dans la console Google Cloud , accédez à la page Application Integration.

   Accéder à Application Integration

2. Dans le menu de navigation, cliquez sur Journaux.

   La page Journaux d'exécution s'affiche et liste les journaux d'exécution générés pour les intégrations dans la région par défaut.

3. Sur la page Journaux d'exécution, recherchez une entrée dont l'état est Erreur Échec.
4. Cliquez sur l'icône chat_spark à côté de l'entrée de journal ayant échoué.
   • Vous pouvez également développer la ligne spécifique et cliquer sur Explication de cette entrée de journal.

   La page Résumé des erreurs s'ouvre. Elle affiche le résumé des erreurs généré par Gemini, y compris les sections suivantes :

   • Message d'erreur : affiche la description technique de l'erreur et indique où elle se produit dans le code.
   • Cause racine : explique pourquoi l'erreur s'est produite.
   • Analyse détaillée : (développez cette section) fournit plus de détails sur l'impact de l'erreur, les zones de code spécifiques concernées et la façon de la corriger.
   • Étapes à suivre pour corriger l'erreur : fournit des instructions de correction spécifiques à la cause racine identifiée.
   Remarque : Vous pouvez recevoir des réponses de débogage plus détaillées pour les journaux d'échec des types de tâches suivants : Tâche d'appel REST, Tâche de connecteurs, Tâche JavaScript, Tâche de mappage de données, Tâche Cloud Functions et Tâche de transformation de données. En effet, des instructions supplémentaires sont fournies au modèle Gemini pour ces types de tâches spécifiques.
   Remarque : Lorsque vous réessayez de résoudre le problème, vous pouvez obtenir une réponse différente, car les réponses sont générées par un modèle Gemini.
   Remarque : Si les fonctionnalités d'IA ont été désactivées, le bouton Activer les fonctionnalités d'IA s'affiche la première fois que vous essayez d'accéder à la page Récapitulatif des erreurs.
   Temps de chargement : la page Récapitulatif des erreurs peut mettre jusqu'à 20 secondes à se charger lors de son premier accès en raison de l'analyse de l'IA.
5. Après avoir examiné le récapitulatif des erreurs et compris le problème, cliquez sur Fermer pour revenir à la page Journaux d'exécution.

Résoudre les problèmes à l'aide des recommandations de l'IA

Après avoir examiné le récapitulatif des erreurs, résolvez le problème en procédant comme suit :

1. Suivez les recommandations : suivez les étapes recommandées et apportez toutes les modifications nécessaires à la logique d'intégration ou à la configuration du connecteur, comme indiqué dans la section Étapes à suivre pour corriger l'erreur de la page Résumé des erreurs.
2. Testez et republiez : une fois les modifications effectuées, testez et republiez l'intégration mise à jour pour confirmer que le problème est entièrement résolu.

Exemple de récapitulatif des erreurs

L'exemple suivant décrit un résumé d'erreur généré par IA pour une exécution ayant échoué :

• Message d'erreur :

  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

• Cause racine : l'erreur Index 0 out of bounds, not within [0, 0) indique une tentative d'accès au premier élément (index 0) d'un tableau vide. Ce problème se produit à la ligne 16 de votre code, plus précisément dans les parties suivantes de votre script :
  • Fonction getMergedObject(orderId) : cette fonction renvoie un tableau vide [] lorsqu'elle ne trouve pas de commande correspondante dans ordersSalesforce.
  • Ligne local orders = std.map(...); : cette ligne provoque une erreur index 0 out of bounds lorsqu'elle tente d'accéder au premier élément du résultat renvoyé par getMergedObject(orderId), car le résultat est un tableau vide [].
• Analyse détaillée :
  • Fonction getMergedObject(orderId) : cette fonction recherche une commande correspondante dans le tableau ordersSalesforce. Si aucune correspondance n'est trouvée, la fonction renvoie un tableau vide []. Il s'agit d'un comportement normal lorsque orderId n'est pas trouvé dans le tableau ordersSalesforce.
  • Ligne local orders = std.map (...); : cette ligne utilise la fonction std.map pour traiter les données. Toutefois, il tente d'accéder directement au premier élément du tableau renvoyé par getMergedObject(orderId) sans vérifier si le tableau est vide. Si le tableau est vide, une erreur index 0 out of bounds se produit.
  Procédure pour résoudre l'erreur :
  • Accédez à la section Authentification de votre connexion Salesforce.
  • Vérifiez le jeton d'accès et la version du secret.
  • Indiquez des valeurs valides pour le jeton d'accès et la version du secret.
  • Testez et republiez l'intégration pour appliquer les modifications.