Servizio Vertex AI

Il servizio Vertex AI ti consente di utilizzare l'API Vertex AI in Apps Script. Questa API ti dà accesso a Gemini e ad altri modelli di AI generativa per la generazione di testo, immagini e altro ancora.

Prerequisiti

• Un progetto Google Cloud con la fatturazione abilitata. Per verificare che la fatturazione sia abilitata per un progetto esistente, consulta Verifica lo stato di fatturazione dei progetti. Per creare un progetto e configurare la fatturazione, consulta Creare un progetto Google Cloud.

• Nella console Google Cloud, vai al tuo progetto Cloud e attiva l'API Vertex AI:

  Abilita l'API

• Configura il progetto Apps Script:

  • Attiva il servizio Vertex AI. Per informazioni sulla procedura, vedi Servizi Google avanzati.
  • Nelle impostazioni del progetto, aggiungi il tuo progetto Cloud.

Riferimento

Per saperne di più su questo servizio, consulta la documentazione di riferimento dell'API Vertex AI. Come tutti i servizi avanzati in Apps Script, il servizio Vertex AI utilizza gli stessi oggetti, metodi e parametri dell'API pubblica.

Codice di esempio

Il seguente codice di esempio utilizza la versione 1 dell'API Vertex AI.

Genera testo

Questo codice di esempio mostra come richiedere al modello Gemini 2.5 Flash di generare testo. La funzione restituisce l'output al log di esecuzione di Apps Script.

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