Hızlı başlangıç: Vertex AI kullanarak metin oluşturma

Bu sayfada, Apps Komut Dosyası'nın Vertex AI gelişmiş hizmetini kullanarak Gemini 2.5 Flash modelinden metin oluşturmasını isteme hakkında bilgi verilmektedir.

Vertex AI gelişmiş hizmeti hakkında daha fazla bilgi edinmek için referans belgelerine bakın.

Şekil 1. Apps Komut Dosyası yürütme günlüğündeki Vertex AI hizmeti yanıtı.

Hedefler

• Ortamınızı ayarlayın.
• Vertex AI gelişmiş hizmetini kullanan bir Apps Komut Dosyası projesi oluşturun.
• Metin oluşturmak için komut dosyasını çalıştırın.

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

Ortamınızı ayarlama

Bu bölümde, Google Cloud Console ve Apps Komut Dosyası'nda ortamınızı nasıl yapılandırıp ayarlayacağınız açıklanmaktadır.

Cloud projenizde Vertex AI API'yi etkinleştirme

1. Google Cloud Console'da Google Cloud projenizi açın ve Vertex AI API'yi etkinleştirin:

   API'yi etkinleştirme

2. API'yi doğru Cloud projesinde etkinleştirdiğinizi onaylayıp İleri'yi tıklayın.

3. Doğru API'yi etkinleştirdiğinizden emin olun ve Etkinleştir'i tıklayın.

Apps Komut Dosyası projenizi oluşturup ayarlama

Apps Komut Dosyası projenizi oluşturmak ve ayarlamak için aşağıdaki adımları tamamlayın:

1. script.google.com adresine gidin.
2. Apps Komut Dosyası projesi oluşturmak için Yeni proje'yi tıklayın.
3. Sol üstte Adsız proje'yi tıklayın.
4. Komut dosyanızı Vertex AI quickstart olarak adlandırın ve Rename'i (Yeniden adlandır) tıklayın.

Vertex AI gelişmiş hizmetini ayarlama

Vertex AI gelişmiş hizmetini etkinleştirmek ve kodu ayarlamak için aşağıdakileri yapın:

1. Komut dosyası düzenleyicide Hizmetler'e gidin ve Hizmet ekle'yi tıklayın .
2. Açılır menüde Vertex AI API'yi seçin ve Ekle'yi tıklayın.

3. Code.gs dosyasını açın ve içeriğini aşağıdaki kodla değiştirin:

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

4. Kaydet'i tıklayın .

Komut dosyasını test etme

1. main işlevini çalıştırmak için komut dosyası düzenleyicide Çalıştır'ı tıklayın.
2. İstenirse komut dosyasını yetkilendirin.
3. Vertex AI'dan gelen yanıtı görüntülemek için Yürütme günlüğü'nü tıklayın.

Vertex AI, soruya yanıt olarak What is Apps Script in one sentence? değerini döndürüyor. Örneğin, yürütme günlüğü aşağıdaki gibi bir yanıt döndürür:

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.

Temizleme

Bu eğitimde kullanılan kaynaklar için Google Cloud hesabınızın ücretlendirilmesini önlemek istiyorsanız Cloud projesini silmenizi öneririz.

Dikkat: Bir projenin silinmesinin etkileri şunlardır:

• Projedeki her şey silinir. Bu eğitim için mevcut bir projeyi kullandıysanız projeyi sildiğinizde projede yaptığınız diğer tüm çalışmalar da silinir.
• Özel proje kimlikleri kaybolur. Bu projeyi oluştururken gelecekte kullanmak istediğiniz özel bir proje kimliği oluşturmuş olabilirsiniz. Proje kimliğini kullanan URL'leri (ör. appspot.com'daki bir URL) korumak için projenin tamamını silmek yerine proje içindeki seçili kaynakları silin.

Birden fazla eğitici ve hızlı başlangıç kılavuzunu incelemeyi planlıyorsanız projeleri yeniden kullanmak proje kotası sınırlarını aşmanızı önleyebilir.

1. Google Cloud Console'da Kaynakları yönetin sayfasına gidin. Şunu tıklayın: Menü > IAM ve Yönetici > Kaynakları Yönetin.

   Resource Manager'a gidin

2. Proje listesinde, silmek istediğiniz projeyi seçin ve Sil'i tıklayın.
3. İletişim kutusunda proje kimliğini yazın ve projeyi silmek için Kapat'ı tıklayın.

Bu hızlı başlangıç kılavuzunda kullanılan kaynaklar için Google Cloud hesabınızın ücretlendirilmesini istemiyorsanız Cloud projesini silmenizi öneririz.

İlgili konular

• Vertex AI gelişmiş hizmet belgeleri
• Vertex AI platform belgeleri
• Google Workspace Yapay Zeka örnekleri galerisini inceleyin.