Guia de início rápido: gerar texto usando a Vertex AI

Nesta página, explicamos como usar o serviço avançado da Vertex AI do Apps Script para pedir ao modelo Gemini 2.5 Flash que gere texto.

Para saber mais sobre o serviço avançado da Vertex AI, consulte a documentação de referência.

Texto gerado por IA do serviço avançado da Vertex AI do Apps Script.
Figura 1. A resposta do serviço da Vertex AI no registro de execução do Apps Script.

Objetivos

  • Prepare o ambiente.
  • Crie um projeto do Apps Script que use o serviço avançado da Vertex AI.
  • Execute o script para gerar texto.

Pré-requisitos

Configurar o ambiente

Nesta seção, explicamos como configurar seu ambiente no console do Google Cloud e no Apps Script.

Ative a API Vertex AI no seu projeto do Cloud

  1. No console do Google Cloud, abra seu projeto do Google Cloud e ative a API Vertex AI:

    Ativar a API

  2. Confirme se você está ativando a API no projeto correto do Cloud e clique em Próxima.

  3. Confirme se você está ativando a API correta e clique em Ativar.

Criar e configurar seu projeto do Apps Script

Para criar e configurar seu projeto do Apps Script, siga estas etapas:

  1. Acesse script.google.com.
  2. Clique em Novo projeto para criar um projeto do Apps Script.
  3. No canto superior esquerdo, clique em Projeto sem título.
  4. Nomeie o script como Guia de início rápido da Vertex AI e clique em Renomear.

Configurar o serviço avançado da Vertex AI

Para ativar o serviço avançado da Vertex AI e configurar o código, faça o seguinte:

  1. No editor de script, acesse Serviços e clique em Adicionar um serviço O ícone para adicionar um serviço.
  2. No menu suspenso, selecione API Vertex AI e clique em Adicionar.

  3. Abra o arquivo Code.gs e substitua o conteúdo pelo seguinte código:

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

  4. Clique em Salvar Ícone Salvar.

Testar o script:

  1. No editor de scripts, clique em Executar para executar a função main.
  2. Se for necessário, autorize o script.
  3. Clique em Registro de execução para conferir a resposta da Vertex AI.

A Vertex AI retorna uma resposta à pergunta, What is Apps Script in one sentence?. Por exemplo, o registro de execução retorna uma resposta como esta:

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.

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados neste tutorial, exclua o projeto do Cloud.

  1. No console do Google Cloud, acesse a página Gerenciar recursos. Clique em Menu > IAM e administrador > Gerenciar recursos.

    Acesse o Resource Manager

  2. Na lista de projetos, selecione o projeto que você quer excluir e clique em Excluir .
  3. Na caixa de diálogo, digite o ID do projeto e clique em Encerrar para excluí-lo.

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados neste guia de início rápido, recomendamos que você exclua o projeto do Cloud.