Sección 8: Escenarios de integración de Google Workspace + Gemini

Escenario 78: Automatización de informes personalizados con Apps Script y Gemini

Nivel: Avanzado · Herramientas: Google Apps Script, Vertex AI service, Agent Platform API, modelo Gemini, Google Cloud

Quién y en qué situación

Okan es analista de operaciones en una empresa de logística. Quiere generar una explicación semanal de los retrasos que se adapte al flujo de trabajo de Sheets y Docs de la empresa y que los botones estándar de Workspace no permiten obtener.

Cómo se hace hoy

Okan descarga la hoja de cálculo, copia los datos en una herramienta de IA independiente y pega el texto resultante en el archivo del informe.

Cómo hacerlo con IA

  1. Cree o seleccione un proyecto de Google Cloud y habilite la facturación del proyecto. Este es un requisito previo para Vertex AI service de Apps Script. [140]
  2. Habilite Agent Platform API en Cloud Console. La documentación explica que esta API también se conoce por su nombre anterior, Vertex AI API. [140]
  3. Active Vertex AI service en el proyecto de Apps Script. Tome como base la función callVertexAI del ejemplo de Google y modifique el prompt, la región, el ID del proyecto y el nombre del modelo según el estándar de su organización. [140]
  4. Genere el resultado únicamente con el rango de datos seleccionado. Por ejemplo, solicite un resumen de cada fila de retraso con los encabezados de causa, evidencia y recomendación de seguimiento.
  5. En la primera ejecución, revise la salida del registro y la respuesta del modelo.

Prompt de ejemplo

Examina los registros de retrasos en {rango_de_sheet}. Para cada registro, genera los encabezados de causa, información respaldada por evidencias y punto que requiere verificación humana, basándote únicamente en los datos disponibles. No hagas suposiciones sobre los campos vacíos.

Evidencia y ejemplo real

La documentación de Google Developers indica que se pueden realizar llamadas a generateContent de Gemini mediante Vertex AI service en Apps Script y publica el código de ejemplo; este documento técnico es la base de este escenario. [140]

Aspectos a tener en cuenta

El flujo no se ejecutará si la facturación del proyecto de Cloud está deshabilitada, la API no está habilitada o el servicio no está activado en Apps Script. [140] No dé por sentado que las llamadas a Vertex AI API están sujetas a los mismos compromisos que Gemini dentro de Workspace; obtenga la aprobación de su organización para las categorías de datos y los permisos de acceso. Lea también las condiciones relativas a los datos de Gemini dentro de Workspace. [40] No incluya claves de API ni secretos de cuentas de servicio en el código.

Fuentes de este escenario

  1. Google Workspace Gemini veri koruması (support.google.com)
  2. Vertex AI Service in Apps Script (developers.google.com)