Kurzanleitung: Text mit Vertex AI generieren

Auf dieser Seite wird beschrieben, wie Sie den erweiterten Vertex AI-Dienst von Apps Script verwenden, um das Gemini 2.5 Flash-Modell aufzufordern, Text zu generieren.

Weitere Informationen zum erweiterten Vertex AI-Dienst finden Sie in der Referenzdokumentation.

KI-generierter Text aus dem erweiterten Vertex AI-Dienst von Apps Script.
Abbildung 1. Die Vertex AI-Dienstantwort im Apps Script-Ausführungsprotokoll.

Ziele

  • die Umgebung einrichten
  • Erstellen Sie ein Apps Script-Projekt, das den erweiterten Vertex AI-Dienst verwendet.
  • Führen Sie das Skript aus, um Text zu generieren.

Vorbereitung

Umgebung einrichten

In diesem Abschnitt wird beschrieben, wie Sie Ihre Umgebung in der Google Cloud Console und in Apps Script konfigurieren und einrichten.

Vertex AI API in Ihrem Cloud-Projekt aktivieren

  1. Öffnen Sie in der Google Cloud Console Ihr Google Cloud-Projekt und aktivieren Sie die Vertex AI API:

    API aktivieren

  2. Bestätigen Sie, dass Sie die API im richtigen Cloud-Projekt aktivieren, und klicken Sie dann auf Weiter.

  3. Prüfen Sie, ob Sie die richtige API aktivieren, und klicken Sie dann auf Aktivieren.

Apps Script-Projekt erstellen und einrichten

So erstellen und richten Sie Ihr Apps Script-Projekt ein:

  1. Rufen Sie script.google.com auf.
  2. Klicken Sie auf Neues Projekt, um ein Apps Script-Projekt zu erstellen.
  3. Klicken Sie links oben auf Unbenanntes Projekt.
  4. Geben Sie dem Script den Namen Vertex AI-Kurzanleitung und klicken Sie auf Umbenennen.

Erweiterten Vertex AI-Dienst einrichten

So aktivieren Sie den erweiterten Vertex AI-Dienst und richten den Code ein:

  1. Rufen Sie im Skripteditor Dienste auf und klicken Sie auf Dienst hinzufügen Symbol zum Hinzufügen eines Dienstes.
  2. Wählen Sie im Drop-down-Menü Vertex AI API aus und klicken Sie auf Hinzufügen.

  3. Öffnen Sie die Datei Code.gs und ersetzen Sie den Inhalt durch den folgenden Code:

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

  4. Klicken Sie auf Speichern. Symbol „Speichern“

Skript testen

  1. Klicken Sie im Script-Editor auf Ausführen, um die Funktion main auszuführen.
  2. Autorisieren Sie das Script, wenn Sie dazu aufgefordert werden.
  3. Klicken Sie auf Ausführungslog, um die Antwort von Vertex AI aufzurufen.

Vertex AI gibt eine Antwort auf die Frage zurück: What is Apps Script in one sentence?. Das Ausführungsprotokoll gibt beispielsweise eine Antwort wie die folgende zurück:

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.

Bereinigen

Damit Ihrem Google Cloud-Konto die in dieser Anleitung verwendeten Ressourcen nicht in Rechnung gestellt werden, empfehlen wir, das Cloud-Projekt zu löschen.

  1. Wechseln Sie in der Google Cloud Console zur Seite Ressourcen verwalten. Klicken Sie auf das Menü > IAM & Verwaltung > Ressourcen verwalten.

    Zum Ressourcenmanager

  2. Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie dann auf Löschen .
  3. Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Beenden, um das Projekt zu löschen.

Wenn Sie vermeiden möchten, dass Ihrem Google Cloud-Konto die in dieser Kurzanleitung verwendeten Ressourcen in Rechnung gestellt werden, empfehlen wir Ihnen, das Cloud-Projekt zu löschen.