Guía de inicio rápido: Genera texto con Vertex AI

En esta página, se explica cómo usar el servicio avanzado de Vertex AI de Apps Script para solicitarle al modelo Gemini 2.5 Flash que genere texto.

Para obtener más información sobre el servicio avanzado de Vertex AI, consulta la documentación de referencia.

Texto generado por IA del servicio avanzado de Vertex AI de Apps Script.
Figura 1: Es la respuesta del servicio de Vertex AI en el registro de ejecución de Apps Script.

Objetivos

  • Configura el entorno.
  • Crea un proyecto de Apps Script que use el servicio avanzado de Vertex AI.
  • Ejecuta la secuencia de comandos para generar texto.

Requisitos previos

Configura tu entorno

En esta sección, se explica cómo configurar tu entorno en la consola de Google Cloud y en Apps Script.

Habilita la API de Vertex AI en tu proyecto de Cloud

  1. En la consola de Google Cloud, abre tu proyecto de Google Cloud y habilita la API de Vertex AI:

    Habilitar la API

  2. Confirma que habilitarás la API en el proyecto de Cloud correcto y, luego, haz clic en Siguiente.

  3. Confirma que habilitarás la API correcta y, luego, haz clic en Habilitar.

Crea y configura tu proyecto de Apps Script

Para crear y configurar tu proyecto de Apps Script, completa los siguientes pasos:

  1. Ve a script.google.com.
  2. Haz clic en Nuevo proyecto para crear un proyecto de Apps Script.
  3. En la esquina superior izquierda, haz clic en Proyecto sin título.
  4. Asigna el nombre Inicio rápido de Vertex AI a tu secuencia de comandos y haz clic en Cambiar nombre.

Configura el servicio avanzado de Vertex AI

Para habilitar el servicio avanzado de Vertex AI y configurar el código, haz lo siguiente:

  1. En el editor de secuencias de comandos, ve a Servicios y haz clic en Agregar un servicio El ícono para agregar un servicio.
  2. En el menú desplegable, selecciona API de Vertex AI y haz clic en Agregar.

  3. Abre el archivo Code.gs y reemplaza su contenido por el siguiente 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.';
}

    Reemplaza GOOGLE_CLOUD_PROJECT_ID por el ID del proyecto de tu proyecto de Cloud.

  4. Haz clic en Guardar Ícono Guardar.

Prueba la secuencia de comandos

  1. En el editor de secuencias de comandos, haz clic en Ejecutar para ejecutar la función main.
  2. Si se te solicita, autoriza la secuencia de comandos.
  3. Haz clic en Registro de ejecución para ver la respuesta de Vertex AI.

Vertex AI devuelve una respuesta a la pregunta, What is Apps Script in one sentence?. Por ejemplo, el registro de ejecución devuelve una respuesta como la siguiente:

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.

Limpia

Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en este instructivo, te recomendamos que borres el proyecto de Cloud.

  1. En la consola de Google Cloud, ve a la página Administrar recursos. Haz clic en Menú > IAM y administración > Administrar recursos.

    Ir al administrador de recursos

  2. En la lista de proyectos, selecciona el proyecto que deseas borrar y haz clic en Borrar .
  3. En el diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrarlo.

Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta guía de inicio rápido, te recomendamos que borres el proyecto de Cloud.