Risolvere i problemi relativi ai log di esecuzione non riusciti utilizzando l'AI

Application Integration fornisce la risoluzione dei problemi basata sull'AI per le esecuzioni non riuscite. Questa funzionalità utilizza Google Gemini per analizzare i log di esecuzione, determinare le cause principali e generare consigli pratici. Puoi accedere a questa funzionalità dalla pagina Log di esecuzione in Application Integration.

Nota:i tuoi dati non vengono memorizzati nell'AI Gemini.

Vantaggi principali

Utilizzando la funzionalità di risoluzione dei problemi basata sull'AI di Gemini, puoi:

• Comprendere chiaramente i messaggi di errore complessi. L'AI trasforma i log tecnici in insight chiari e strategici.
• Ricevi passaggi di risoluzione precisi, personalizzati in base alla tua logica di integrazione unica e agli errori specifici riscontrati.
• Riduci il tempo di debug identificando le cause principali e i passaggi di correzione per le correzioni.

Prima di iniziare

Prima di poter utilizzare la funzionalità di risoluzione dei problemi di Gemini AI, devi:

• Attiva le funzionalità di AI per la Google Cloud regione specifica in cui esegui il deployment dell'integrazione. Per ulteriori informazioni su come attivare le funzionalità di AI per una regione nuova o esistente, vedi Attivare le funzionalità di AI per la risoluzione dei problemi.

Attivare le funzionalità di AI per la risoluzione dei problemi

Per utilizzare Gemini AI per la risoluzione dei problemi relativi alle esecuzioni non riuscite, abilita le funzionalità di AI per la Google Cloud regione specifica in cui implementi l'integrazione.

Attivare l'AI per una nuova regione

Per attivare AI per una nuova regione in Application Integration, segui questi passaggi:

1. Nella console Google Cloud , vai alla pagina Integrazione di applicazioni.

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Regioni. Viene visualizzata la pagina Regioni, che elenca tutte le regioni di cui è stato eseguito il provisioning nel progetto.
3. Fai clic su Provision new region (Esegui provisioning nuova regione).
4. Espandi Impostazioni avanzate.
5. Fai clic sul pulsante di attivazione/disattivazione Attiva funzionalità di AI in Funzionalità di AI.

Attivare l'AI in una regione esistente

Per attivare AI per una regione esistente in Application Integration, segui questi passaggi:

1. Nella console Google Cloud , vai alla pagina Integrazione di applicazioni.

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Regioni. Viene visualizzata la pagina Regioni, che elenca tutte le regioni di cui è stato eseguito il provisioning nel progetto.
3. Per la regione esistente da modificare, fai clic su Azioni regione nella colonna Azioni e seleziona Modifica.

   Viene visualizzato il riquadro Modifica regione.

4. Espandi la sezione Impostazioni avanzate.
5. Fai clic sul pulsante di attivazione/disattivazione Attiva funzionalità di AI in Funzionalità di AI.

Risolvere i problemi relativi alle esecuzioni non riuscite utilizzando l'AI

Nota:solo le esecuzioni non riuscite delle integrazioni pubblicate possono essere risolte utilizzando questa funzionalità.

Per risolvere i problemi relativi a un log di esecuzione non riuscito utilizzando Gemini AI, segui questi passaggi:

1. Nella console Google Cloud , vai alla pagina Integrazione di applicazioni.

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Log.

   Viene visualizzata la pagina Log di esecuzione, che elenca i log di esecuzione generati per le integrazioni nella regione predefinita.

3. Nella pagina Log di esecuzione, individua una voce che mostra lo stato Non riuscito con un errore.
4. Fai clic sull'icona chat_spark accanto alla voce di log non riuscita.
   • In alternativa, espandi la riga specifica e fai clic su Spiega questa voce di log.

   Si apre la pagina Riepilogo errori, che mostra il riepilogo degli errori generato da Gemini, incluse le seguenti sezioni:

   • Messaggio di errore: mostra la descrizione tecnica dell'errore e indica il punto in cui si verifica nel codice.
   • Causa principale: spiega perché si è verificato l'errore.
   • Analisi dettagliata: (espandi questa sezione) fornisce maggiori dettagli sull'impatto dell'errore, sulle aree di codice specifiche coinvolte e su come correggerlo.
   • Passaggi per correggere l'errore: fornisce istruzioni di correzione specifiche per la causa principale identificata.
   Nota:potresti ricevere risposte di debug più dettagliate per i log non riusciti dai seguenti tipi di attività: Attività di chiamata REST, Attività di connettori, Attività JavaScript, Attività di mappatura dei dati, Attività di Cloud Functions e Attività di trasformazione dei dati. Questo perché al modello Gemini vengono fornite istruzioni aggiuntive per questi tipi di attività specifici.
   Nota: quando viene eseguito un nuovo tentativo di risoluzione dei problemi, potresti ricevere una risposta diversa, poiché le risposte vengono generate da un modello Gemini.
   Nota:se le funzionalità di AI sono state disattivate, il pulsante Attiva funzionalità di AI viene visualizzato la prima volta che provi ad accedere alla pagina Riepilogo errori.
   Tempo di caricamento:il caricamento della pagina Riepilogo errori può richiedere fino a 20 secondi al primo accesso a causa dell'analisi dell'AI.
5. Dopo aver esaminato il riepilogo degli errori e compreso il problema, fai clic su Chiudi per tornare alla pagina Log di esecuzione.

Risolvere i problemi utilizzando i consigli dell'AI

Dopo aver esaminato il riepilogo dell'errore, risolvi il problema completando i seguenti passaggi:

1. Segui i consigli: implementa i passaggi consigliati e apporta tutte le modifiche necessarie alla logica di integrazione o alla configurazione del connettore, come indicato nella sezione Passaggi per correggere l'errore della pagina Riepilogo errori.
2. Test e ripubblicazione: dopo aver completato le modifiche, testa e ripubblica l'integrazione aggiornata per verificare che il problema sia stato risolto completamente.

Esempio di riepilogo degli errori

L'esempio seguente descrive un riepilogo degli errori generato con l'AI di un'esecuzione non riuscita:

• Messaggio di errore:

  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 principale:l'errore Index 0 out of bounds, not within [0, 0) indica un tentativo di accedere al primo elemento (indice 0) di un array vuoto. Questo problema si verifica alla riga 16 del codice, in particolare in queste parti dello script:
  • Funzione getMergedObject(orderId): questa funzione restituisce una matrice vuota [] quando non riesce a trovare un ordine corrispondente in ordersSalesforce.
  • Riga local orders = std.map(...);: questa riga causa un errore index 0 out of bounds quando tenta di accedere al primo elemento del risultato restituito da getMergedObject(orderId) perché il risultato è un array vuoto [].
• Analisi dettagliata:
  • Funzione getMergedObject(orderId): questa funzione cerca un ordine corrispondente nell'array ordersSalesforce. Se non viene trovata alcuna corrispondenza, restituisce un array vuoto []. Questo è un comportamento previsto quando orderId non viene trovato nell'array ordersSalesforce.
  • Riga local orders = std.map (...);: questa riga utilizza la funzione std.map per elaborare i dati. Tuttavia, tenta direttamente di accedere al primo elemento dell'array restituito da getMergedObject(orderId) senza verificare se l'array è vuoto. Quando l'array è vuoto, viene generato un errore index 0 out of bounds.
  Passaggi per risolvere l'errore:
  • Vai alla sezione Autenticazione nella connessione Salesforce.
  • Verifica il token di accesso e la versione del secret.
  • Fornisci valori validi per il token di accesso e la versione del secret.
  • Testa e ripubblica l'integrazione per applicare le modifiche.