Memecahkan masalah log eksekusi yang gagal menggunakan AI

Integrasi Aplikasi menyediakan pemecahan masalah berteknologi AI untuk eksekusi yang gagal. Fitur ini menggunakan Gemini Google untuk menganalisis log eksekusi, menentukan akar masalah, dan membuat rekomendasi yang dapat ditindaklanjuti. Anda dapat mengakses fitur ini dari halaman Execution Logs dalam Integrasi Aplikasi.

Catatan: Data Anda tidak disimpan di AI Gemini.

Manfaat utama

Dengan menggunakan fitur pemecahan masalah yang didukung AI Gemini, Anda dapat:

• Memahami pesan error yang kompleks dengan jelas. AI mengubah log teknis menjadi insight yang jelas dan dapat ditindaklanjuti.
• Menerima langkah-langkah penyelesaian yang tepat dan disesuaikan dengan logika integrasi unik Anda dan error spesifik yang terjadi.
• Kurangi waktu proses debug dengan mengidentifikasi penyebab utama dan langkah-langkah perbaikan untuk solusi.

Sebelum memulai

Sebelum dapat menggunakan fitur pemecahan masalah AI Gemini, Anda harus:

• Aktifkan kemampuan AI untuk Google Cloud wilayah tertentu tempat Anda men-deploy integrasi. Untuk mengetahui informasi selengkapnya tentang cara mengaktifkan kemampuan AI untuk wilayah baru atau yang sudah ada, lihat Mengaktifkan kemampuan AI untuk pemecahan masalah.

Mengaktifkan kemampuan AI untuk pemecahan masalah

Untuk menggunakan AI Gemini dalam memecahkan masalah eksekusi yang gagal, aktifkan kemampuan AI untuk region Google Cloud tertentu tempat Anda men-deploy integrasi.

Mengaktifkan AI untuk wilayah baru

Untuk mengaktifkan AI untuk region baru di Integrasi Aplikasi, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman Application Integration.

   Buka Application Integration

2. Di menu navigasi, klik Regions. Halaman Regions akan muncul dan mencantumkan semua region yang disediakan dalam project Anda.
3. Klik Provision new region.
4. Luaskan Setelan lanjutan.
5. Klik tombol Aktifkan fitur AI di bagian Fitur AI.

Mengaktifkan AI di region yang ada

Untuk mengaktifkan AI bagi region yang sudah ada di Integrasi Aplikasi, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman Application Integration.

   Buka Application Integration

2. Di menu navigasi, klik Regions. Halaman Regions akan muncul dan mencantumkan semua region yang disediakan dalam project Anda.
3. Untuk wilayah yang ada yang ingin Anda edit, di kolom Tindakan, klik Tindakan wilayah, lalu pilih Edit.

   Panel Edit wilayah akan muncul.

4. Luaskan bagian Setelan lanjutan.
5. Klik tombol Aktifkan fitur AI di bagian Fitur AI.

Memecahkan masalah eksekusi yang gagal menggunakan AI

Catatan: Hanya kegagalan eksekusi integrasi yang dipublikasikan yang dapat diatasi menggunakan fitur ini.

Untuk memecahkan masalah log eksekusi yang gagal menggunakan AI Gemini, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman Application Integration.

   Buka Application Integration

2. Di menu navigasi, klik Logs.

   Halaman Execution Logs akan muncul dan mencantumkan log eksekusi yang dibuat untuk integrasi di region default.

3. Di halaman Execution Logs, cari entri yang menampilkan status error Gagal.
4. Klik ikon chat_spark di samping entri log yang gagal.
   • Atau, perluas baris tertentu, lalu klik Explain this log entry.

   Tindakan ini akan membuka halaman Ringkasan Error, yang menampilkan ringkasan error yang dihasilkan Gemini, termasuk bagian berikut:

   • Pesan error: Menampilkan deskripsi error teknis dan menunjukkan lokasi terjadinya error dalam kode.
   • Akar masalah: Menjelaskan alasan terjadinya error.
   • Analisis mendetail: (Perluas bagian ini) Memberikan detail selengkapnya tentang dampak error, area kode tertentu yang terlibat, dan cara memperbaikinya.
   • Langkah-langkah untuk memperbaiki error: Memberikan petunjuk perbaikan khusus untuk akar masalah yang teridentifikasi.
   Catatan: Anda mungkin menerima respons debug yang lebih mendetail untuk log yang gagal dari jenis tugas berikut: Rest Caller Task, Connectors Task, Javascript Task, Data Mapping Task, Cloud Function Task, dan Data Transformer Task. Hal ini karena petunjuk tambahan diberikan kepada model Gemini untuk jenis tugas tertentu ini.
   Catatan: Saat pemecahan masalah dicoba lagi, Anda mungkin mendapatkan respons yang berbeda, karena respons dihasilkan oleh model Gemini.
   Catatan: Jika fitur AI dinonaktifkan, tombol Aktifkan fitur AI akan ditampilkan saat Anda pertama kali mencoba mengakses halaman Ringkasan Error.
   Waktu pemuatan: Halaman Ringkasan Error dapat memerlukan waktu hingga 20 detik untuk dimuat saat akses awal karena analisis AI.
5. Setelah Anda meninjau ringkasan error dan memahami masalahnya, klik Tutup untuk kembali ke halaman Log Eksekusi.

Mengatasi masalah menggunakan rekomendasi AI

Setelah meninjau ringkasan error, selesaikan masalah dengan menyelesaikan langkah-langkah berikut:

1. Ikuti rekomendasi: Terapkan langkah-langkah yang direkomendasikan dan lakukan semua perubahan yang diperlukan pada logika integrasi atau konfigurasi konektor Anda seperti yang disarankan di bagian Langkah-langkah untuk memperbaiki error di halaman Ringkasan Error.
2. Uji dan publikasikan ulang: Setelah menyelesaikan modifikasi, uji dan publikasikan ulang integrasi yang telah diupdate untuk mengonfirmasi bahwa masalah telah sepenuhnya diselesaikan.

Contoh ringkasan error

Contoh berikut menjelaskan ringkasan error yang dibuat AI dari eksekusi yang gagal:

• Pesan error:

  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

• Penyebab utama: Error Index 0 out of bounds, not within [0, 0) menunjukkan upaya untuk mengakses elemen pertama (indeks 0) dari array kosong. Masalah ini terjadi di baris 16 kode Anda, khususnya dalam bagian skrip berikut:
  • Fungsi getMergedObject(orderId): Fungsi ini menampilkan array kosong [] jika tidak dapat menemukan pesanan yang cocok di ordersSalesforce.
  • Baris local orders = std.map(...);: Baris ini menyebabkan error index 0 out of bounds saat mencoba mengakses elemen pertama hasil yang ditampilkan oleh getMergedObject(orderId) karena hasilnya adalah array kosong [].
• Analisis mendetail:
  • Fungsi getMergedObject(orderId): Fungsi ini mencari urutan yang cocok dalam array ordersSalesforce. Jika tidak ditemukan kecocokan, fungsi akan menampilkan array kosong []. Ini adalah perilaku yang diharapkan saat orderId tidak ditemukan dalam array ordersSalesforce.
  • baris local orders = std.map (...);: Baris ini menggunakan fungsi std.map untuk memproses data. Namun, kode ini langsung mencoba mengakses elemen pertama array yang ditampilkan oleh getMergedObject(orderId) tanpa memeriksa apakah array kosong. Jika array kosong, error index 0 out of bounds akan terjadi.
  Langkah-langkah untuk memperbaiki error:
  • Buka bagian Autentikasi di koneksi Salesforce Anda.
  • Verifikasi token akses dan versi secret.
  • Berikan nilai yang valid untuk token akses dan versi rahasia.
  • Uji dan publikasikan ulang integrasi untuk menerapkan perubahan.