Guida rapida: genera testo utilizzando Vertex AI

Questa pagina spiega come utilizzare il servizio avanzato Vertex AI di Apps Script per richiedere al modello Gemini 2.5 Flash di generare testo.

Per saperne di più sul servizio avanzato Vertex AI, consulta la documentazione di riferimento.

Testo creato con l'AI dal servizio avanzato Vertex AI di Apps Script.
Figura 1. La risposta del servizio Vertex AI nel log di esecuzione di Apps Script.

Obiettivi

  • Configurare l'ambiente.
  • Crea un progetto Apps Script che utilizza il servizio avanzato Vertex AI.
  • Esegui lo script per generare il testo.

Prerequisiti

Configura l'ambiente

Questa sezione spiega come configurare e impostare l'ambiente in Google Cloud Console e Apps Script.

Abilita l'API Vertex AI nel tuo progetto Cloud

  1. Nella console Google Cloud, apri il tuo progetto Google Cloud e abilita l'API Vertex AI:

    Abilita l'API

  2. Verifica di abilitare l'API nel progetto Cloud corretto, poi fai clic su Avanti.

  3. Verifica di abilitare l'API corretta, poi fai clic su Abilita.

Creare e configurare il progetto Apps Script

Per creare e configurare il progetto Apps Script, completa i seguenti passaggi:

  1. Vai su script.google.com.
  2. Fai clic su Nuovo progetto per creare un progetto Apps Script.
  3. In alto a sinistra, fai clic su Progetto senza titolo.
  4. Assegna al tuo script il nome Avvio rapido di Vertex AI e fai clic su Rinomina.

Configura il servizio avanzato Vertex AI

Per attivare il servizio avanzato Vertex AI e configurare il codice:

  1. Nell'editor di script, vai a Servizi e fai clic su Aggiungi un servizio L'icona per aggiungere un servizio.
  2. Nel menu a discesa, seleziona API Vertex AI e fai clic su Aggiungi.

  3. Apri il file Code.gs e sostituisci i suoi contenuti con il seguente codice:

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

    Sostituisci GOOGLE_CLOUD_PROJECT_ID con l'ID progetto del tuo progetto Cloud.

  4. Fai clic su Salva Icona Salva.

Testa lo script

  1. Nell'editor di script, fai clic su Esegui per eseguire la funzione main.
  2. Se richiesto, autorizza lo script.
  3. Fai clic su Log di esecuzione per visualizzare la risposta di Vertex AI.

Vertex AI restituisce una risposta alla domanda, What is Apps Script in one sentence?. Ad esempio, il log di esecuzione restituisce una risposta come la seguente:

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.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, ti consigliamo di eliminare il progetto Cloud.

  1. Nella console Google Cloud, vai alla pagina Gestisci risorse. Fai clic su Menu > IAM e amministrazione > Gestisci risorse.

    Vai a Resource Manager

  2. Nell'elenco dei progetti, seleziona quello da eliminare e fai clic su Elimina .
  3. Nella finestra di dialogo, digita l'ID progetto, quindi fai clic su Chiudi per eliminare il progetto.

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa guida rapida, ti consigliamo di eliminare il progetto Cloud.