Membuat peninjau slide AI dengan Gemini

Buat, jalankan, dan sesuaikan Add-on peninjau slide untuk Slide Google Workspace dengan project kode ini. Baik Anda melakukan satu presentasi seminggu atau satu tahun, sebagian besar dari kita memerlukan sedikit bantuan untuk melakukannya dengan benar. Apakah Anda cenderung memasukkan terlalu banyak informasi dalam satu slide? Mungkin Anda lupa membagi presentasi dengan visual? Anda mungkin bahkan memiliki serangkaian pedoman dari organisasi tentang presentasi yang efektif. Apakah Anda baru-baru ini membacanya?

Project Slides Advisor adalah Add-On Google Workspace open source yang menggunakan teknologi kecerdasan buatan (AI) untuk meninjau dan memberikan masukan tentang presentasi Anda, kapan pun Anda membutuhkannya. Project ini menggunakan fitur pemrosesan gambar dan teks Gemini API Google untuk menganalisis Google Slide Anda berdasarkan serangkaian pedoman dan memberi tahu Anda bagaimana Anda melakukannya berdasarkan pedoman tersebut. Lebih baik lagi, Anda dapat menyesuaikan panduan tersebut untuk mengikuti rekomendasi organisasi, atau mengingatkan Anda untuk meningkatkan kualitas presentasi berdasarkan aturan yang Anda tentukan untuk diri sendiri.

Untuk ringkasan video tentang project dan cara memperluasnya, termasuk insight dari orang yang membuatnya, lihat AI Slides Reviewer - Build with Google AI. Jika tidak, Anda dapat mulai memperluas project menggunakan petunjuk berikut.

Add-on Slides Advisor berjalan sebagai sidebar untuk Google Slide Gambar 1. Add-on Slides Advisor untuk Google Slide yang berjalan sebagai panel sidebar.

Penyiapan project

Petunjuk ini akan memandu Anda menyiapkan project Slides Advisor untuk pengembangan dan pengujian. Langkah-langkah umumnya adalah membuat project Google Apps Script, menyiapkan project Google Cloud untuk akses API, dan menetapkan beberapa properti Skrip untuk project.

Membuat project Apps Script

Project Slides Advisor ini berjalan sebagai Add-on untuk Google Slide. Anda menyiapkan project menggunakan antarmuka web Google Slides, dan membuat project Apps Script untuk kode.

Untuk membuat project Apps Script baru:

  1. Buka aplikasi web Slide untuk Google Workspace.
  2. Buka presentasi yang ada, atau buat presentasi baru.
  3. Dalam presentasi Slide, pilih Ekstensi > Apps Script.

Setelah menyelesaikan langkah-langkah ini, Anda akan memiliki Project tanpa judul baru di antarmuka pengguna web Apps Script, yang dilampirkan ke presentasi tempat Anda memulai. Beri nama project agar lebih mudah ditemukan.

Untuk memberi nama project Apps Script:

  1. Di antarmuka web Apps Script, pilih teks Project tanpa judul.
  2. Pada dialog Ganti Nama Project, ketik: My Slides Advisor, lalu pilih Ganti nama.

Menyiapkan file project

Project Slides Advisor memiliki 5 file kode, dan Anda perlu menyiapkan file tersebut sebelum dapat menyalin kode ke project Apps Script baru. Bagian ini menjelaskan cara menyiapkan project dan mendapatkan kode.

Untuk menyiapkan file project:

  1. Buka antarmuka web Apps Script yang berisi project My Slides Advisor.
  2. Di menu sebelah kiri, pilih tampilan < > Editor.
  3. Ganti nama file Code.gs menjadi main.gs dengan mengarahkan kursor ke nama file kode Code.gs, memilih Rename dari menu konteks, memasukkan main. Antarmuka akan otomatis menambahkan ekstensi .gs.
  4. Buat file manifes appscript.json project terlihat dengan memilih ikon roda gigi (Project Settings) di menu sebelah kiri, lalu mengaktifkan opsi Show "appscript.json" manifest file.
  5. Di antarmuka web Apps Script, pada menu sebelah kiri, pilih tampilan < > Editor.
  6. Buat file kode ui.gs dengan memilih ikon + (plus) di sebelah kanan header Files, memilih Script, dan memasukkan ui.
  7. Ulangi langkah sebelumnya untuk membuat file kode slides.gs dan ai.gs.

Project Apps Script Anda kini akan berisi 5 file kode berikut, yang sebagian besar kosong:

  • appscript.json
  • main.gs
  • ui.gs
  • slides.gs
  • ai.gs

Untuk langkah berikutnya, dapatkan kode project dari repositori dan salin ke dalam project Apps Script Anda.

Mendapatkan kode project

Kode untuk project Slides Advisor dihosting di repositori kode. Anda harus menyalin kode tersebut ke project Apps Script untuk menggunakannya. Bagian ini menjelaskan cara mendapatkan kode project.

Untuk mendapatkan kode project:

  1. Buka repositori kode project untuk file manifes project, appsscript.json
  2. Salin konten file kode ini ke papan klip Anda.
  3. Kembali ke antarmuka web Apps Script, pilih nama file appsscript.json, lalu tempelkan kode ke panel editor kode, yang akan menggantikan kode sebelumnya.
  4. Ulangi prosedur ini untuk 4 file kode lainnya:
    • Salin kode main.js ke file main.gs.
    • Salin kode ui.js ke file ui.gs.
    • Salin kode slides.js ke file slides.gs.
    • Salin kode ai.js ke file ai.gs Anda.

Menghubungkan project Google Cloud

Project ini menggunakan project Google Cloud untuk mengakses model AI Gemini. Google Cloud menyediakan kebijakan privasi data tertentu, serta sejumlah layanan software yang berguna untuk membuat aplikasi seperti Slides Advisor. Anda menghubungkan kode Add-on ke Gemini API dengan membuat project Cloud dengan akses AI API, membuat akun layanan untuk project, membuat kunci untuk akun layanan, dan menginstal kunci tersebut di project Add-on.

Mengonfigurasi project Cloud

Project Cloud yang Anda gunakan untuk terhubung ke Gemini API harus mengaktifkan layanan Vertex AI API, dan Anda harus membuat koneksi yang diautentikasi dari Add-on Slides Advisor ke project ini. Vertex AI API juga mewajibkan faktur untuk diaktifkan di project tempat Anda menggunakannya.

Untuk mengonfigurasi project Cloud dengan akses Vertex AI API:

  1. Buka konsol Google Cloud dan login, jika perlu.
  2. Di konsol Google Cloud, pilih Project Cloud yang ada, atau buat yang baru.
  3. Di halaman Dasbor konsol untuk project Anda, di panel API, pilih Buka ringkasan API, atau buka https://console.cloud.google.com/apis/.
  4. Di halaman APIs and Services, di bagian atas halaman, pilih + ENABLE APIS AND SERVICES.
  5. Di halaman Library API, telusuri vertex ai api, pilih opsi Vertex AI API, lalu pilih tombol Enable.
  6. Jika belum aktif, Anda harus Mengaktifkan penagihan untuk project Google Cloud, lalu mengaktifkan AI API dengan memilih tombol Enable di halaman konsol Vertex AI API.
  7. Pastikan Vertex AI API diaktifkan dengan membuka halaman APIs and Services untuk project Anda. Sekarang Anda akan melihat Vertex AI API tercantum di halaman ini.

Membuat akun layanan

Add-on Slides Advisor memerlukan koneksi yang diautentikasi ke project Cloud Anda untuk mengakses Vertex AI API dan model Gemini. Anda membuat koneksi tersebut dengan terlebih dahulu membuat akun layanan di project Cloud yang memiliki akses ke Vertex AI API. Project Slides Advisor terhubung menggunakan akun layanan ini.

Untuk membuat akun layanan bagi Add-on Slides Advisor:

  1. Di konsol Google Cloud, buka halaman APIs and Services untuk project Cloud Anda.
  2. Di sisi kiri halaman, pilih Kredensial.
  3. Di bagian atas halaman, pilih + BUAT KREDENSIAL > Akun layanan.
  4. Di halaman Create service account, bagian Service account details, masukkan nama, ID, dan deskripsi akun layanan.
  5. Buat akun layanan dengan memilih Create and Continue.
  6. Di bagian Berikan akses project ke akun layanan ini, pilih kontrol Role.
  7. Di kolom Filter, telusuri, lalu pilih kumpulan izin Vertex AI User, lalu pilih Continue.
  8. Selesaikan pembuatan akun layanan ini dengan memilih Selesai.

Untuk mengetahui informasi selengkapnya tentang cara membuat akun layanan, lihat dokumentasi Membuat akun layanan Google Cloud.

Membuat dan menginstal kunci akun layanan

Project Slides Advisor harus dapat melakukan autentikasi ke akun layanan yang Anda buat dalam prosedur sebelumnya. Anda dapat mengaktifkan autentikasi tersebut dengan membuat kunci untuk akun layanan dan mengonfigurasi kunci tersebut di project Apps Script Slides Advisor sebagai Properti Skrip. Prosedur berikut menjelaskan cara membuat kunci dan mengonfigurasinya dalam project Anda.

Untuk membuat dan mengonfigurasi kunci akun layanan:

  1. Di konsol Google Cloud, buka halaman APIs and Services untuk project Cloud Anda.
  2. Di sisi kiri halaman, pilih Kredensial.
  3. Di bagian Service Accounts, temukan akun layanan yang Anda buat, pilih alamat email akun atau ikon pensil untuk mengeditnya.
  4. Di jendela pengeditan akun layanan, di dekat bagian atas halaman, pilih judul tab KEYS.
  5. Di bagian Keys, pilih Add Key > Create new key.
  6. Pada dialog Create private key for..., pilih JSON, lalu Create. Langkah ini akan membuat file kunci bernama projectid-hashcode.json dan otomatis mendownloadnya ke komputer Anda.
  7. Buka file projectid-hashcode.json yang telah didownload dan salin kontennya.
  8. Buka antarmuka web Apps Script yang berisi project My Slides Advisor, lalu di menu sebelah kiri, pilih tampilan Settings.
  9. Di bagian Script Properties, pilih tombol Edit script properties, lalu tombol Add script property.
  10. Di kolom Properti baru, masukkan SERVICE_ACCOUNT_KEY, dan di kolom Nilai, salin isi file projectid-hashcode.json yang didownload.
  11. Simpan properti baru dengan memilih tombol Simpan properti skrip.

Untuk informasi selengkapnya tentang cara membuat kunci akun layanan, lihat dokumentasi Membuat dan menghapus kunci akun layanan Google Cloud.

Menguji project Add-on

Panel slide Google Workspace dengan ikon Slides Advisor Untuk menguji project Slides Advisor, Anda harus membuat deployment uji coba kode Add-on, dan menginstal deployment uji coba tersebut. Dalam konfigurasi pengujian ini, project hanya tersedia dalam presentasi Google Slides tempat Anda memulai project Add-on Apps Script, dan tidak ada presentasi Slides lainnya. Anda dapat mempelajari lebih lanjut cara men-deploy Add-on untuk penggunaan yang lebih luas di dokumentasi Google Workspace Apps Script, topik Membuat dan mengelola deployment.

Untuk men-deploy dan menguji kode project Apps Script:

  1. Di bagian atas antarmuka web Apps Script, pilih Deploy > Uji deployment.
  2. Di dialog Test deployments, di samping Select type, pilih ikon roda gigi dan Google Workspace Add-on.
  3. Di samping judul Aplikasi: Slide, pilih tombol Instal.
  4. Biarkan setelan default untuk Uji kode terbaru dan pilih Selesai.
  5. Buka presentasi Google Slide yang terhubung ke project Apps Script Anda dan muat ulang halaman web.
  6. Di sudut kanan bawah aplikasi web Slide, pilih ikon ( < ) untuk membuka panel samping, lalu pilih ikon mata hitam dan putih untuk membuka panel Slides Advisor.

Setelah menyelesaikan langkah ini dan berhasil menjalankan Add-on, Anda dapat mulai mengubahnya untuk menggunakan panduan yang berbeda atau mengikuti alur kerja yang berbeda. Lihat bagian berikutnya untuk mengetahui petunjuk cara melakukan beberapa modifikasi dasar pada Add-on Slides Advisor.

Mengubah perilaku peninjauan

Anda dapat mengubah perilaku peninjauan Slides Advisor, baik dalam hal output yang Anda dapatkan dari Gemini API, maupun antarmuka pengguna yang disediakan oleh Add-on, dengan mengubah kode project-nya. Tutorial ini berfokus pada perubahan petunjuk perintah untuk mengubah perilaku peninjauan slide presentasi. Untuk informasi selengkapnya tentang cara memperluas antarmuka pengguna Google Slide menggunakan Apps Script, lihat Memperluas Google Slide.

Mengubah panduan peninjauan

Slides Advisor diprogram dengan serangkaian panduan dasar peninjauan slide dengan kategori untuk kesederhanaan, warna dan tipografi, struktur dan spasi kosong, serta grafik dan ikon. Panduan peninjauan hanyalah petunjuk teks yang disertakan dalam perintah melalui Gemini API, beserta gambar ringkasan slide yang dipilih dan catatan pembicara.

Anda dapat mengubah perilaku peninjauan Add-on dengan mengubah petunjuk teks. Misalnya, Anda dapat menginstruksikan model Gemini untuk menghasilkan ulasan dengan rating kategori di baris yang sama dengan judul kategori, atau mengubah nama kategori.

Untuk mengubah lokasi rating kategori dan nama kategori:

  1. Buka antarmuka web Apps Script yang berisi project My Slides Advisor. Jika perlu, buka jendela project dengan membuka presentasi Google Slides yang berisi project Apps Script, lalu pilih Extensions > Apps Script.
  2. Di menu sebelah kiri, pilih tampilan < > Editor, lalu pilih nama file ai.gs.
  3. Di file kode ai.gs, temukan konstanta string SYSTEM_PROMPT dan ubah petunjuknya sebagai berikut dengan teks yang dicetak tebal: 
    const SYSTEM_PROMPT = `
...
For each of the following categories evaluate the given slide. Score each
category on a scale of 0 to 100, show the score next to the category heading,
and concisely explain the reasoning. Do not suggest improvements if the score
is 80 or above.
  4. Dalam konstanta string SYSTEM_PROMPT yang sama, ubah teks kategori Simplicity menjadi Message: 
    const SYSTEM_PROMPT = `
...
* Message -- Slides should focus on one main idea per slide and ...
  5. Simpan perubahan pada file kode ai.gs.
  6. Buka presentasi Google Slide yang terhubung ke project Apps Script Anda, muat ulang halaman web, dan uji perubahan pada Add-on dengan menjalankannya kembali.

Jika Anda belum menyiapkan deployment pengujian untuk Add-on Slides Advisor, ikuti petunjuk di Menguji project Add-on.

Anda dapat menghapus, mengganti, atau menulis ulang petunjuk kategori ulasan dalam konstanta string SYSTEM_PROMPT agar sesuai dengan persyaratan ulasan Anda. Jika Anda ingin mencoba berbagai pendekatan perintah peninjauan atau menulis ulang seluruh perintah peninjauan, lihat aplikasi web Google AI Studio. Aplikasi ini memungkinkan Anda membuat prototipe, menguji, dan menyimpan perintah untuk Gemini di antarmuka yang praktis, dan menggunakan Gemini API yang sama dengan project Slides Advisor. Untuk mengetahui informasi selengkapnya tentang cara menggunakan AI Studio, lihat panduan memulai AI Studio.

Mengubah konfigurasi perilaku model

Gemini API menyediakan beberapa setelan untuk mengubah operasi umum model sebagai respons terhadap perintah permintaan. Secara khusus, setelan suhu untuk model memungkinkan Anda menetapkan jumlah variasi yang diizinkan model dalam respons, dengan nol sebagai yang terendah dan 1 sebagai yang tertinggi. Menetapkan nilai ini pada 0,1 akan menghasilkan respons yang sangat konsisten, tetapi perilaku tersebut mungkin tampak berulang dan kurang membantu bagi pengguna yang mendapatkan masukan ulasan. Pertimbangkan untuk menetapkan nilai suhu yang lebih tinggi, dan perlu diingat bahwa semakin tinggi suhu, semakin tidak konsisten hasilnya, yang dapat mencakup penerapan petunjuk secara berbeda, dan bahkan mengabaikan beberapa petunjuk sepenuhnya.

Untuk meningkatkan suhu respons ulasan:

  1. Buka antarmuka web Apps Script yang berisi project My Slides Advisor.
  2. Di menu sebelah kiri, pilih tampilan < > Editor, lalu pilih nama file ai.gs.

  3. Dalam file kode ai.gs, temukan fungsi analyzeSlides() dan ubah konstanta generationConfig dengan menetapkan nilai temperature ke 0.3:

    function analyzeSlides(slide) {

    const generationConfig = {
        temperature: 0.3,
        maxOutputTokens: 1024 * 2,
    };

  4. Simpan perubahan pada file kode ai.gs.

  5. Buka presentasi Google Slide yang terhubung ke project Apps Script Anda, muat ulang halaman web, dan uji perubahan pada Add-on dengan menjalankannya kembali.

Untuk mengetahui informasi selengkapnya tentang setelan konfigurasi perilaku model, lihat dokumentasi Gemini API untuk GenerationConfig.

Referensi lainnya

Untuk mengetahui informasi selengkapnya tentang project Slides Advisor, lihat repositori kode. Jika Anda memerlukan bantuan untuk mem-build aplikasi atau ingin berkolaborasi dengan developer lain, lihat server Discord Komunitas Developer Google. Untuk project Build with Google AI lainnya, lihat playlist video.