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

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 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 Save Ikon untuk menyimpan project.

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?.

Teks yang dibuat AI dari layanan lanjutan Vertex AI Apps Script.
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.

  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.