Mendapatkan penjelasan

Panduan ini menjelaskan cara mendapatkan penjelasan dari resource Model di Vertex AI. Anda bisa mendapatkan penjelasan dengan dua cara:

  • Penjelasan online: Permintaan sinkron ke Vertex AI API, mirip dengan inferensi online yang menampilkan inferensi dengan atribusi fitur.

  • Penjelasan batch: Permintaan asinkron ke Vertex AI API yang menampilkan inferensi dengan atribusi fitur. Penjelasan batch merupakan bagian opsional dari permintaan inferensi batch.

Sebelum memulai

Sebelum mendapatkan penjelasan, Anda harus melakukan langkah berikut:

  1. Langkah ini berbeda-beda, bergantung pada jenis model machine learning yang Anda gunakan:

  2. Jika Anda ingin mendapatkan penjelasan online, deploy Model yang Anda buat pada langkah sebelumnya ke resource Endpoint.

Mendapatkan penjelasan online

Untuk mendapatkan penjelasan online, ikuti sebagian besar langkah yang sama seperti yang Anda lakukan untuk mendapatkan inferensi online. Namun, alih-alih mengirim permintaan projects.locations.endpoints.predict ke Vertex AI API, kirim permintaan projects.locations.endpoints.explain.

Panduan berikut memberikan petunjuk terperinci untuk menyiapkan dan mengirim permintaan penjelasan online:

Mendapatkan penjelasan batch

Hanya penjelasan batch berbasis fitur yang didukung; Anda tidak bisa mendapatkan penjelasan batch berbasis contoh.

Untuk mendapatkan penjelasan batch, tetapkan kolom generateExplanation ke true saat Anda membuat tugas inferensi batch.

Untuk petunjuk terperinci tentang menyiapkan dan membuat tugas prediksi batch, baca Mendapatkan inferensi batch.

Mendapatkan Penjelasan Serentak

Explainable AI mendukung penjelasan serentak. Penjelasan serentak memungkinkan Anda meminta penjelasan berbasis fitur dan berbasis contoh dari endpoint model yang di-deploy yang sama tanpa harus men-deploy model secara terpisah untuk setiap metode penjelasan.

Untuk mendapatkan penjelasan serentak, upload model Anda dan konfigurasi penjelasan berbasis contoh atau berbasis fitur. Kemudian, deploy model seperti biasa.

Setelah model di-deploy, Anda dapat meminta penjelasan yang dikonfigurasi seperti biasa. Selain itu, Anda dapat meminta penjelasan serentak dengan menentukan concurrent_explanation_spec_override.

Perhatikan hal berikut saat menggunakan penjelasan serentak:

  • Penjelasan serentak hanya tersedia menggunakan versi v1beta1 API. Jika menggunakan Vertex Python SDK, Anda harus menggunakan model preview untuk menggunakan penjelasan serentak.
  • Penjelasan berbasis contoh tidak dapat diminta setelah men-deploy dengan penjelasan berbasis fitur. Jika Anda menginginkan Penjelasan berbasis contoh dan Penjelasan berbasis fitur, deploy model Anda menggunakan Penjelasan berbasis contoh dan minta Penjelasan berbasis fitur menggunakan kolom penjelasan serentak.
  • Penjelasan Batch tidak didukung untuk penjelasan Serentak. Online Penjelasan adalah satu-satunya cara untuk menggunakan fitur ini.

Pemecahan masalah

Bagian ini menjelaskan langkah-langkah pemecahan masalah yang mungkin berguna jika Anda mengalami masalah saat mendapatkan penjelasan.

Error: indeks daftar di luar rentang

Jika Anda mendapatkan pesan error berikut saat meminta penjelasan:

"error": "Explainability failed with exception: listindex out of range"

Pastikan Anda tidak meneruskan array kosong ke kolom yang mengharapkan array objek. Misalnya, jika field1 menerima array objek, isi permintaan berikut dapat menyebabkan error:

{
  "instances": [
    {
      "field1": [],
    }
  ]
}

Sebagai gantinya, pastikan array tidak kosong, misalnya:

{
  "instances": [
    {
      "field1": [
        {}
      ],
    }
  ]
}

Langkah berikutnya