Menjalankan eksekusi notebook dengan parameter

Instance notebook terkelola Vertex AI Workbench memungkinkan Anda menggunakan parameter value dalam eksekusi notebook untuk menentukan perbedaan dalam cara kode file notebook Anda dijalankan. Halaman ini menjelaskan cara menyiapkan file notebook untuk menggunakan parameter dan cara menjalankan eksekusi yang menentukan nilai yang berbeda untuk parameter notebook Anda.

Menggunakan parameter untuk menjalankan iterasi yang berbeda dari file notebook Anda

Anda dapat menggunakan parameter value notebook dalam eksekusi untuk menjalankan kode notebook yang sama sekaligus menentukan perbedaan seperti berikut:

  • Menentukan set data berbeda yang akan digunakan, atau ukuran sampel set data yang berbeda.

  • Menentukan konfigurasi model berbeda seperti kecepatan pembelajaran atau jenis pengoptimal.

  • Menjalankan model berbeda, atau menjalankan versi berbeda dari model yang sama.

Cara menggunakan parameter dalam eksekusi notebook

Proses untuk menjalankan notebook dengan parameter memiliki dua langkah utama:

  1. Tambahkan tag parameters ke salah satu sel file notebook Anda. Sel ini biasanya berisi kode yang menetapkan nilai ke variabel parameter Anda, meskipun ini bukan persyaratan teknis. Jika Anda tidak menetapkan parameter value yang berbeda dalam eksekusi, eksekusi Anda akan menggunakan parameter value dalam file notebook Anda sebagai nilai default.

  2. Buat eksekusi untuk file notebook yang menyertakan nilai baru untuk parameter Anda. Gunakan pola berikut untuk memformat parameter dan nilainya: parameter1=value1,parameter2=value2. Format tersebut memerlukan koma antara pasangan parameter value, tanpa spasi, dan tanpa tanda kutip. Saat eksekusi dijalankan, eksekutor akan menambahkan sel ke notebook yang memperbarui nilai parameter Anda secara langsung setelah sel yang diberi tag parameters.

Sebelum memulai

  1. Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

  2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

  3. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

  4. Aktifkan API Notebooks and Vertex AI.

    Mengaktifkan API

    5.

  5. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

  6. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

  7. Aktifkan API Notebooks and Vertex AI.

    Mengaktifkan API

    8.
  8. Buat instance notebook terkelola, jika Anda belum membuatnya.

Peran yang diperlukan

Untuk memastikan bahwa akun layanan instance Anda memiliki izin yang diperlukan untuk berinteraksi dengan eksekutor Vertex AI Workbench, minta administrator untuk memberi akun layanan instans Anda peran IAM berikut di project:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses.

Administrator Anda mungkin juga dapat memberikan izin yang diperlukan kepada akun layanan instance Anda melalui peran kustom atau peran yang telah ditetapkan.

Membuka JupyterLab

Untuk membuka JupyterLab dan menyiapkan file notebook untuk dijalankan, selesaikan langkah-langkah berikut.

  1. Buka JupyterLab.

  2. Upload file notebook (ipynb), buka file yang sudah ada, atau buka file notebook baru, lalu tambahkan kode yang ingin Anda jalankan ke notebook baru.

  3. Pastikan kode file notebook Anda memenuhi persyaratan untuk menggunakan eksekutor.

Menambahkan tag parameters ke sel notebook

  1. Di antarmuka pengguna JupyterLab instance notebook terkelola Anda, buka file notebook yang ingin Anda jalankan.

  2. Tulis kode dalam satu sel yang menetapkan nilai ke variabel parameter Anda. Ini adalah nilai yang digunakan file notebook Anda jika Anda tidak menetapkan parameter value yang berbeda dalam eksekusi.

  3. Pastikan sel parameter Anda tetap dipilih, lalu di sidebar kanan, klik  Property inspector.

  4. Pada pemeriksa properti, di bagian Cell Tags, klik Add Tag, masukkan parameters, lalu tekan Enter.

Memberikan parameter value untuk eksekusi Anda

  1. Di antarmuka pengguna JupyterLab instance notebook terkelola Anda, klik tombol  Executor.

  2. Pada dialog Submit notebooks to Executor, masukkan nama untuk eksekusi Anda di kolom Execution name.

  3. Pilih Machine type dan Accelerator type.

  4. Pilih Environment.

  5. Di kolom Type, pilih One-time execution, atau pilih Schedule-based recurring executions, lalu selesaikan dialog untuk menjadwalkan eksekusi.

  6. Di Advanced options, pilih Region tempat Anda ingin menjalankan notebook.

  7. Di kolom Cloud Storage bucket, pilih bucket Cloud Storage yang tersedia atau masukkan nama untuk bucket baru, lalu klik Create and select. Eksekutor menyimpan output notebook Anda di bucket Cloud Storage ini.

  8. Di bagian Notebook parameterization kotak teks Input parameters, tambahkan parameter notebook yang dipisahkan oleh koma, misalnya optimizer=SGD,learning_rate=0.01. Format ini mengharuskan tanpa spasi dan tanda kutip.

  9. Konfigurasikan seluruh eksekusi Anda, lalu klik Submit.

Notebook

Langkah selanjutnya