Panduan memulai: Membuat teks menggunakan Vertex AI

Halaman ini menjelaskan cara menggunakan layanan lanjutan Vertex AI Google Apps Script untuk meminta model Gemini 2.5 Flash membuat teks.

Untuk mempelajari layanan lanjutan Vertex AI lebih lanjut, lihat dokumentasi referensi.

Tujuan

• Menyiapkan lingkungan Anda.
• Membuat project Apps Script yang menggunakan layanan lanjutan Vertex AI.
• Menjalankan skrip untuk membuat teks.

Prasyarat

• Project Google Cloud yang mengaktifkan penagihan. Untuk memeriksa apakah penagihan diaktifkan pada project yang ada, lihat Memverifikasi status penagihan project Anda. Untuk membuat project dan menyiapkan penagihan, lihat Membuat project Google Cloud.

Menyiapkan lingkungan Anda

Bagian ini menjelaskan cara mengonfigurasi dan menyiapkan lingkungan Anda di konsol Google Cloud dan Apps Script.

Mengaktifkan Vertex AI API di project Cloud Anda

1. Di konsol Google Cloud, buka project Google Cloud Anda dan aktifkan Vertex AI API:

   Mengaktifkan API

2. Pastikan Anda mengaktifkan API di project Cloud yang benar, lalu klik Next.

3. Pastikan Anda mengaktifkan API yang benar, lalu klik Enable.

Membuat dan menyiapkan project Apps Script Anda

Untuk membuat dan menyiapkan project Apps Script Anda, selesaikan langkah-langkah berikut:

1. Buka script.google.com.
2. Klik New project untuk membuat project Apps Script.
3. Di kiri atas, klik Untitled project.
4. Beri nama skrip Anda Vertex AI quickstart , lalu klik Rename.

Menyiapkan layanan lanjutan Vertex AI

Untuk mengaktifkan layanan lanjutan Vertex AI dan menyiapkan kode, lakukan hal berikut:

1. Di editor skrip, buka Services , lalu klik Add a service .
2. Di menu drop-down, pilih Vertex AI API , lalu klik Add.

3. Buka file Code.gs dan ganti isinya dengan kode berikut:

   /**
    * Main entry point to test the Vertex AI integration.
    */
   function main() {
     const prompt = 'What is Apps Script in one sentence?';
   
     try {
       const response = callVertexAI(prompt);
       console.log(`Response: ${response}`);
     } catch (error) {
       console.error(`Failed to call Vertex AI: ${error.message}`);
     }
   }
   
   /**
    * Calls the Vertex AI Gemini model.
    *
    * @param {string} prompt - The user's input prompt.
    * @return {string} The text generated by the model.
    */
   function callVertexAI(prompt) {
     // Configuration
     const projectId = 'GOOGLE_CLOUD_PROJECT_ID';
     const region = 'us-central1';
     const modelName = 'gemini-2.5-flash';
   
     const model = `projects/${projectId}/locations/${region}/publishers/google/models/${modelName}`;
   
     const payload = {
       contents: [{
         role: 'user',
         parts: [{
           text: prompt
         }]
       }],
       generationConfig: {
         temperature: 0.1,
         maxOutputTokens: 2048
       }
     };
   
     // Execute the request using the Vertex AI Advanced Service
     const response = VertexAI.Endpoints.generateContent(payload, model);
   
     // Use optional chaining for safe property access
     return response?.candidates?.[0]?.content?.parts?.[0]?.text || 'No response generated.';
   }
   

   Ganti GOOGLE_CLOUD_PROJECT_ID dengan project ID project Cloud Anda.

4. Klik Save .

Menguji skrip

1. Di editor skrip, klik Run untuk menjalankan fungsi main.
2. Jika diminta, izinkan skrip.
3. Klik Execution log untuk melihat respons dari Vertex AI.

Layanan Vertex AI menampilkan respons terhadap perintah, What is Apps Script in one sentence?.

Respons layanan Vertex AI di log eksekusi Apps Script.

Misalnya, log eksekusi menampilkan respons seperti berikut:

Response: Google Apps Script is a cloud-based, JavaScript platform that lets you
automate, integrate, and extend Google Workspace applications like Sheets, Docs,
and Gmail.

Pembersihan

Agar tidak menimbulkan biaya pada akun Google Cloud Anda untuk resource yang digunakan dalam tutorial ini, sebaiknya hapus project Cloud.

Perhatian: Penghapusan project akan mengakibatkan:

• Semua hal dalam project akan dihapus. Jika menggunakan project yang sudah ada untuk tutorial ini, saat menghapusnya, Anda juga akan menghapus pekerjaan lain yang telah dilakukan dalam project tersebut.
• Project ID kustom akan hilang. Saat membuat project ini, Anda mungkin telah membuat project ID kustom yang masih ingin Anda gunakan pada masa mendatang. Untuk mempertahankan URL yang menggunakan project ID tersebut, seperti URL di appspot.com, hapus resource yang dipilih di dalam project, alih-alih menghapus seluruh project.

Jika Anda berencana mempelajari beberapa tutorial dan panduan memulai, menggunakan kembali project dapat membantu Anda agar tidak melampaui batas kuota project.

1. Di konsol Google Cloud, buka halaman Manage resources. Klik Menu > IAM & Admin > Manage Resources.

   Buka Resource Manager

2. Pada daftar project, pilih project yang ingin Anda hapus, lalu klik Delete .
3. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus the project.

Agar tidak menimbulkan biaya pada akun Google Cloud Anda untuk resource yang digunakan dalam panduan memulai ini, sebaiknya hapus project Cloud.

Topik terkait

• Dokumentasi layanan lanjutan Vertex AI
• Dokumentasi platform Vertex AI
• Melihat galeri contoh AI Google Workspace