Vertex AI hizmeti

Vertex AI hizmeti, Apps Script'te Vertex AI API'yi kullanmanıza olanak tanır. Bu API ile metin oluşturma, görüntü oluşturma ve daha fazlası için Gemini'a ve diğer üretken yapay zeka modellerine erişebilirsiniz.

Ön koşullar

• Faturalandırmanın etkin olduğu bir Google Cloud projesi. Mevcut bir projede faturalandırmanın etkinleştirilip etkinleştirilmediğini kontrol etmek için Projelerinizin faturalandırma durumunu doğrulama bölümüne bakın. Proje oluşturma ve faturalandırmayı ayarlama hakkında bilgi edinmek için Google Cloud projesi oluşturma bölümüne bakın.

• Google Cloud Console'da Cloud projenize gidin ve Vertex AI API'yi etkinleştirin:

  API'yi etkinleştirme

• Apps Komut Dosyası projenizi yapılandırın:

  • Vertex AI hizmetini etkinleştirin. Adımlar için Gelişmiş Google hizmetleri başlıklı makaleyi inceleyin.
  • Proje ayarlarında Cloud projenizi ekleyin.

Referans

Bu hizmet hakkında daha fazla bilgi için Vertex AI API referans belgelerine bakın. Apps Komut Dosyası'ndaki tüm gelişmiş hizmetler gibi Vertex AI hizmeti de herkese açık API ile aynı nesneleri, yöntemleri ve parametreleri kullanır.

Örnek kod

Aşağıdaki örnek kodda Vertex AI API'nin 1. sürümü kullanılmaktadır.

Metin oluşturun

Bu örnek kodda, Gemini 2.5 Flash modeline metin oluşturma isteminin nasıl gönderileceği gösterilmektedir. İşlev, çıktıyı Apps Komut Dosyası'nın yürütme günlüğüne döndürür.

/**
 * 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.';
}

GOOGLE_CLOUD_PROJECT_ID kısmını Cloud projenizin proje kimliği ile değiştirin.