Membuat peninjau slide AI dengan Gemini

Rakit, jalankan, dan sesuaikan Add-on peninjau slide untuk Slide Google Workspace dengan project kode ini. Baik Anda melakukan satu presentasi dalam seminggu atau satu tahun, kebanyakan dari kita membutuhkan sedikit bantuan untuk memperbaikinya. Apakah Anda cenderung memasukkan terlalu banyak hal ke dalam {i>slide<i}? Mungkin Anda lupa memecah presentasi dengan visualisasi? Anda bahkan mungkin memiliki serangkaian pedoman dari organisasi tentang presentasi yang efektif. Sudahkah kamu membacanya akhir-akhir ini?

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

Untuk ringkasan video project dan cara memperluasnya, termasuk insight dari orang-orang yang membuatnya, lihat Peninjau Slide AI - Membangun dengan Google AI. Jika tidak, Anda dapat mulai memperluas project menggunakan petunjuk berikut.

Add-on Penasihat Slide 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 umum adalah membuat project Google Apps Script, menyiapkan project Google Cloud untuk akses API, dan menetapkan beberapa properti Script untuk project tersebut.

Buat project Apps Script

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

Untuk membuat project Apps Script baru:

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

Setelah menyelesaikan langkah-langkah ini, Anda akan memiliki Untitled project baru di antarmuka pengguna web Apps Script, yang dilampirkan ke presentasi tempat Anda memulai. Memberi nama pada proyek tersebut agar lebih mudah ditemukan.

Untuk memberi nama project Apps Script:

  1. Di antarmuka web Apps Script, pilih teks Untitled project.
  2. Pada dialog Rename Project, ketik: My Slides Advisor lalu pilih Rename.

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, pilih Rename dari menu konteks, lalu masukkan main. Antarmuka akan menambahkan ekstensi .gs secara otomatis.
  4. Buat file manifes appscript.json project terlihat dengan memilih ikon roda gigi (Project Settings) di menu samping kiri, lalu mengaktifkan opsi Show "appscript.json" manifest file.
  5. Di antarmuka web Apps Script, di menu sebelah kiri, pilih tampilan < > Editor.
  6. Buat file kode ui.gs dengan memilih ikon + (plus) di sebelah kanan header Files, pilih Script lalu masukkan ui.
  7. Ulangi langkah sebelumnya untuk membuat file kode slides.gs dan ai.gs.

Project Apps Script Anda sekarang 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 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 agar dapat 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, sehingga menggantikan kode sebelumnya.
  4. Ulangi prosedur ini untuk 4 file kode lainnya:
    • Salin kode main.js ke file main.gs Anda.
    • Salin kode ui.js ke file ui.gs Anda.
    • Salin kode slides.js ke file slides.gs Anda.
    • Salin kode ai.js ke file ai.gs Anda.

Hubungkan project Google Cloud

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

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 mengharuskan penagihan 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 project baru.
  3. Di halaman Dashboard pada konsol untuk project Anda, di panel APIs, pilih Go to APIs overview, 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 API Library, 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 sudah 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 untuk Add-on Slides Advisor:

  1. Di konsol Google Cloud, buka halaman APIs and Services untuk project Cloud Anda.
  2. Di sisi kiri halaman, pilih Credentials.
  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 Buat dan Lanjutkan.
  6. Di bagian Grant this service account access to project, pilih kontrol Role.
  7. Di penelusuran kolom Filter, 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 mengautentikasi ke akun layanan yang Anda buat di prosedur sebelumnya. Anda dapat mengaktifkan autentikasi tersebut dengan membuat kunci untuk akun layanan dan mengonfigurasi kunci tersebut di project Slides Advisor Apps Script 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 Credentials.
  3. Pada bagian Akun Layanan, temukan akun layanan yang Anda buat, pilih alamat email akun atau ikon pensil untuk mengeditnya.
  4. Pada jendela pengeditan akun layanan, di dekat bagian atas halaman, pilih judul tab KEYS.
  5. Di bagian Keys, pilih Add Key > Create new key.
  6. Dalam dialog Create private key for..., pilih JSON, lalu Create. Langkah ini akan membuat file kunci dengan nama projectid-hashcode.json dan mendownloadnya secara otomatis ke komputer Anda.
  7. Buka file projectid-hashcode.json yang didownload, lalu salin kontennya.
  8. Buka antarmuka web Apps Script yang berisi project My Slides Advisor dan di menu samping kiri, pilih tampilan Settings.
  9. Di bagian Properti Skrip, pilih tombol Edit properti skrip, lalu tombol Tambahkan properti skrip.
  10. Di kolom Property baru, masukkan SERVICE_ACCOUNT_KEY, lalu di kolom Value, salin konten file projectid-hashcode.json yang didownload.
  11. Simpan properti baru dengan memilih tombol Simpan properti skrip.

Untuk mengetahui informasi lebih lanjut 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, lalu menginstal deployment uji tersebut. Dalam konfigurasi pengujian ini, project hanya tersedia di presentasi Google Slide tempat Anda memulai project Add Apps Script, dan di tidak ada presentasi Slide lainnya. Anda dapat mempelajari lebih lanjut cara men-deploy Add-on untuk penggunaan yang lebih luas dalam dokumentasi Skrip Aplikasi Google Workspace, mengenai topik Membuat dan mengelola deployment.

Untuk men-deploy dan menguji kode project Apps Script:

  1. Di bagian atas antarmuka web Apps Script, pilih Deploy > Test deployments.
  2. Pada dialog Test deployment, di samping Select type, pilih ikon roda gigi dan Google Workspace Add-on.
  3. Di samping Aplikasi: Judul Slide, pilih tombol Instal.
  4. Tetap gunakan setelan default untuk Uji kode terbaru, lalu pilih Selesai.
  5. Buka presentasi Google Slide yang terhubung ke project Apps Script Anda, lalu muat ulang halaman web.
  6. Di sudut kanan bawah aplikasi web Slide, pilih ikon ( < ) untuk membuka panel samping, lalu pilih ikon mata hitam 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 mendapatkan petunjuk tentang cara melakukan beberapa perubahan dasar pada Add-on Penasihat Slide.

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 memodifikasi kode project-nya. Tutorial ini berfokus pada perubahan petunjuk prompt untuk mengubah perilaku peninjauan slide presentasi. Untuk mengetahui informasi selengkapnya tentang cara memperluas antarmuka pengguna Google Slide menggunakan Apps Script, lihat Memperluas Google Slide.

Mengubah panduan peninjauan

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

Anda dapat mengubah perilaku peninjauan Add-on dengan mengubah petunjuk teks. Misalnya, Anda dapat menginstruksikan model Gemini untuk menampilkan 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 Slide yang berisi project Apps Script, lalu memilih Extensions > Apps Script.
  2. Di menu sebelah kiri, pilih tampilan < > Editor, lalu pilih nama file ai.gs.
  3. Dalam file kode ai.gs, cari konstanta string SYSTEM_PROMPT lalu ubah petunjuk 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 ke 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 peninjauan Anda. Jika Anda ingin mencoba berbagai pendekatan permintaan peninjauan atau menulis ulang seluruh permintaan peninjauan, lihat aplikasi web Google AI Studio. Aplikasi ini memungkinkan Anda membuat prototipe, menguji, dan menyimpan perintah untuk Gemini di antarmuka yang praktis. Aplikasi ini juga menggunakan Gemini API yang sama dengan project Slide Advisor. Untuk mengetahui informasi selengkapnya tentang cara menggunakan AI Studio, baca panduan memulai AI Studio.

Ubah konfigurasi perilaku model

Gemini API menyediakan beberapa setelan untuk mengubah operasi umum model sebagai respons terhadap prompt permintaan. Secara khusus, setelan suhu untuk model memungkinkan Anda menetapkan seberapa besar variasi yang diizinkan model dalam respons, dengan nol sebagai yang terendah dan 1 sebagai yang tertinggi. Menetapkan nilai ini ke 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 lebih tinggi, dan ingat bahwa makin tinggi suhu, semakin tidak konsisten hasil yang dihasilkan, yang dapat mencakup penerapan petunjuk secara berbeda, dan bahkan mengabaikan beberapa petunjuk sepenuhnya.

Untuk menaikkan 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, cari 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 ke 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 tambahan

Untuk mengetahui informasi selengkapnya tentang project Slides Advisor, lihat repositori kode. Jika Anda memerlukan bantuan untuk membuat aplikasi atau ingin berkolaborasi dengan developer lain, buka server Komunitas Discord Google Developers. Untuk mengetahui project Membangun dengan AI Google lainnya, lihat playlist video.