Vertex AI-Dienst

Mit dem Vertex AI-Dienst können Sie die Vertex AI API in Apps Script verwenden. Mit dieser API erhalten Sie Zugriff auf Gemini und andere generative KI-Modelle für die Text- und Bildgenerierung und mehr.

Vorbereitung

• Google Cloud-Projekt mit aktivierter Abrechnungsfunktion. Informationen dazu, wie Sie prüfen können, ob die Abrechnung für ein vorhandenes Projekt aktiviert ist, finden Sie unter Abrechnungsstatus Ihrer Projekte prüfen. Informationen zum Erstellen eines Projekts und Einrichten der Abrechnung finden Sie unter Google Cloud-Projekt erstellen.

• Rufen Sie in der Google Cloud Console Ihr Cloud-Projekt auf und aktivieren Sie die Vertex AI API:

  API aktivieren

• Konfigurieren Sie Ihr Apps Script-Projekt:

  • Aktivieren Sie den Vertex AI-Dienst. Eine Anleitung finden Sie im Hilfeartikel Erweiterte Google-Dienste.
  • Fügen Sie in den Projekteinstellungen Ihr Cloud-Projekt hinzu.

Referenz

Weitere Informationen zu diesem Dienst finden Sie in der Vertex AI API-Referenzdokumentation. Wie alle erweiterten Dienste in Apps Script verwendet der Vertex AI-Dienst dieselben Objekte, Methoden und Parameter wie die öffentliche API.

Beispielcode

Im folgenden Beispielcode wird Version 1 der Vertex AI API verwendet.

Text generieren

In diesem Beispielcode wird gezeigt, wie Sie das Gemini 2.5 Flash-Modell auffordern, Text zu generieren. Die Funktion gibt die Ausgabe an das Ausführungsprotokoll von Apps Script zurück.

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

Ersetzen Sie GOOGLE_CLOUD_PROJECT_ID durch die Projekt-ID Ihres Cloud-Projekts.