Serviço da Vertex AI

O serviço da Vertex AI permite usar a API Vertex AI no Apps Script. Essa API dá acesso ao Gemini e a outros modelos de IA generativa para geração de texto, geração de imagens e muito mais.

Pré-requisitos

• Ter um projeto do Google Cloud com o faturamento ativado. Para verificar se um projeto já tem o faturamento ativado, consulte Verificar o status de faturamento dos seus projetos. Para criar um projeto e configurar o faturamento, consulte Criar um projeto do Google Cloud.

• No console do Google Cloud, acesse seu projeto do Cloud e ative a API Vertex AI:

  Ativar a API

• Configure seu projeto do Apps Script:

  • Ative o serviço da Vertex AI. Para ver as etapas, consulte Serviços avançados do Google.
  • Nas configurações do projeto, adicione seu projeto do Cloud.

Referência

Para mais informações sobre esse serviço, consulte a documentação de referência da API Vertex AI. Assim como todos os serviços avançados no Apps Script, o serviço da Vertex AI usa os mesmos objetos, métodos e parâmetros que a API pública.

Código de amostra

O exemplo de código a seguir usa a versão 1 da API Vertex AI.

Gerar texto

Este exemplo de código mostra como pedir ao modelo Gemini 2.5 Flash para gerar texto. A função retorna a saída para o registro de execução do 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.';
}

Substitua GOOGLE_CLOUD_PROJECT_ID pelo ID do projeto do seu projeto do Cloud.