Layanan Vertex AI

Layanan Vertex AI memungkinkan Anda menggunakan Vertex AI API di Apps Script. API ini memberi Anda akses ke Gemini dan model AI generatif lainnya untuk pembuatan teks, pembuatan gambar, dan lainnya.

Prasyarat

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

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

  Mengaktifkan API

• Konfigurasi project Apps Script Anda:

  • Aktifkan layanan Vertex AI. Untuk mengetahui langkah-langkahnya, lihat Layanan Google lanjutan.
  • Di setelan project, tambahkan project Cloud Anda.

Referensi

Untuk mengetahui informasi selengkapnya tentang layanan ini, lihat dokumentasi referensi Vertex AI API. Seperti semua layanan lanjutan di Apps Script, layanan Vertex AI menggunakan objek, metode, dan parameter yang sama dengan API publik.

Kode contoh

Contoh kode berikut menggunakan versi 1 dari Vertex AI API.

Buat teks

Kode contoh ini menunjukkan cara memberikan perintah ke model Gemini 2.5 Flash untuk membuat teks. Fungsi ini menampilkan output ke log eksekusi Apps Script.

/**
 * 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.