Krótkie wprowadzenie: generowanie tekstu za pomocą Vertex AI

Na tej stronie dowiesz się, jak używać zaawansowanej usługi Vertex AI w Apps Script do wysyłania promptów do modelu Gemini 2.5 Flash w celu generowania tekstu.

Więcej informacji o usłudze zaawansowanej Vertex AI znajdziesz w dokumentacji.

Tekst wygenerowany przez AI z usługi zaawansowanej Vertex AI w Apps Script.
Rysunek 1. Odpowiedź usługi Vertex AI w dzienniku wykonywania Apps Script.

Cele

  • skonfigurować środowisko,
  • Utwórz projekt Apps Script, który korzysta z usługi zaawansowanej Vertex AI.
  • Uruchom skrypt, aby wygenerować tekst.

Wymagania wstępne

Konfigurowanie środowiska

W tej sekcji dowiesz się, jak skonfigurować i przygotować środowisko w konsoli Google Cloud i Apps Script.

Włączanie interfejsu Vertex AI API w projekcie Cloud

  1. W konsoli Google Cloud otwórz projekt Google Cloud i włącz interfejs Vertex AI API:

    Włączanie interfejsu API

  2. Sprawdź, czy włączasz interfejs API w odpowiednim projekcie w Cloud, a potem kliknij Dalej.

  3. Sprawdź, czy włączasz odpowiedni interfejs API, a potem kliknij Włącz.

Tworzenie i konfigurowanie projektu Apps Script

Aby utworzyć i skonfigurować projekt Apps Script, wykonaj te czynności:

  1. Wejdź na script.google.com.
  2. Aby utworzyć projekt Apps Script, kliknij Nowy projekt.
  3. W lewym górnym rogu kliknij Projekt bez tytułu.
  4. Nadaj skryptowi nazwę Vertex AI quickstart i kliknij Zmień nazwę.

Konfigurowanie usługi zaawansowanej Vertex AI

Aby włączyć zaawansowaną usługę Vertex AI i skonfigurować kod:

  1. W edytorze skryptów kliknij Usługi i Dodaj usługę. Ikona dodawania usługi
  2. W menu wybierz Vertex AI API i kliknij Dodaj.

  3. Otwórz plik Code.gs i zastąp jego zawartość tym kodem:

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

    Zastąp GOOGLE_CLOUD_PROJECT_ID identyfikatorem projektu projektu Cloud.

  4. Kliknij Zapisz. Ikona zapisania

Testowanie skryptu

  1. W edytorze skryptów kliknij Uruchom, aby uruchomić funkcję main.
  2. Jeśli pojawi się odpowiedni komunikat, autoryzuj skrypt.
  3. Aby wyświetlić odpowiedź z Vertex AI, kliknij Log wykonywania.

Vertex AI zwraca odpowiedź na pytanie, What is Apps Script in one sentence?. Na przykład dziennik wykonania zwraca odpowiedź podobną do tej:

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.

Czyszczenie danych

Aby uniknąć obciążenia konta Google Cloud opłatami za zasoby zużyte w tym samouczku, zalecamy usunięcie projektu w Cloud.

  1. W konsoli Google Cloud otwórz stronę Zarządzanie zasobami. Kliknij Menu > Administracja > Zarządzaj zasobami.

    Otwórz Menedżera zasobów

  2. Z listy projektów wybierz projekt do usunięcia, a potem kliknij Usuń .
  3. W oknie wpisz identyfikator projektu i kliknij Wyłącz, aby usunąć projekt.

Aby uniknąć obciążenia konta Google Cloud opłatami za zasoby zużyte w tym samouczku, zalecamy usunięcie projektu w Cloud.