Panduan memulai: Membuat teks menggunakan Vertex AI

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

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

Teks yang dibuat AI dari layanan lanjutan Vertex AI Apps Script.
Gambar 1. Respons layanan Vertex AI di log eksekusi Apps Script.

Tujuan

  • Siapkan lingkungan Anda.
  • Buat project Apps Script yang menggunakan layanan lanjutan Vertex AI.
  • Jalankan skrip untuk membuat teks.

Prasyarat

Menyiapkan lingkungan Anda

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

Aktifkan 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 Berikutnya.

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

Membuat dan menyiapkan project Apps Script

Untuk membuat dan menyiapkan project Apps Script, 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 Layanan, lalu klik Tambahkan layanan Ikon untuk menambahkan layanan.
  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 Simpan Ikon simpan.

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.

Vertex AI menampilkan respons terhadap pertanyaan, What is Apps Script in one sentence?. 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 tersebut.

  1. Di Konsol Google Cloud, buka halaman Manage resources. Klik Menu > IAM & Admin > Kelola Resource.

    Buka Resource Manager

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

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