Crea un revisor de diapositivas de IA con Gemini

Arma, ejecuta y personaliza un complemento de revisor de diapositivas para Presentaciones de Google Workspace con este proyecto de código. Ya sea que hagas una presentación por semana o una al año, a la mayoría de nosotros nos vendría bien un poco de ayuda para hacerlas bien. ¿Sueles meter demasiado en una diapositiva? ¿Tal vez te olvidaste de dividir tu presentación con elementos visuales? Incluso puede que tengas un conjunto de pautas de tu organización sobre presentaciones efectivas. ¿Los ha leído últimamente?

El proyecto Slides Advisor es un complemento de Google Workspace de código abierto que usa tecnología de inteligencia artificial (IA) para revisar tus presentaciones y enviar comentarios sobre ellas cuando lo necesites. El proyecto usa las funciones de procesamiento de imágenes y texto de la API de Gemini de Google para analizar las diapositivas de Presentaciones de Google en función de un conjunto de lineamientos y, así, saber cómo te va en función de esos lineamientos. Aún mejor, puedes personalizar esos lineamientos para seguir las recomendaciones de tu organización o recordarte mejorar tus presentaciones en función de las reglas que definas para ti.

Para ver una descripción general en video del proyecto y cómo extenderlo, incluidas las estadísticas de quienes lo compilan, consulta Revisor de Presentaciones de IA: Crea con la IA de Google. De lo contrario, puedes comenzar a extender el proyecto con las siguientes instrucciones.

El complemento de Asesor de Presentaciones se ejecuta como una barra lateral de Presentaciones de Google Figura 1: Complemento del asesor de Presentaciones para Presentaciones de Google que se ejecuta como un panel de la barra lateral

Configuración del proyecto

Estas instrucciones te guiarán en la configuración del proyecto del Asesor de Presentaciones para el desarrollo y las pruebas. Los pasos generales son crear el proyecto de Google Apps Script, configurar un proyecto de Google Cloud para acceder a la API y configurar algunas propiedades de Script para el proyecto.

Crear proyecto de Apps Script

Este proyecto del Asesor de diapositivas se ejecuta como un complemento de Presentaciones de Google. Configura el proyecto con la interfaz web de Presentaciones de Google y crea un proyecto de Apps Script para el código.

Para crear un nuevo proyecto de Apps Script, sigue estos pasos:

  1. Navega a la app web de Presentaciones para Google Workspace.
  2. Abre una presentación existente o crea una nueva.
  3. En el archivo de Presentaciones, selecciona Extensiones > Apps Script.

Cuando completes estos pasos, deberías tener un nuevo Proyecto sin título en la interfaz de usuario web de Apps Script, que se adjunta a la presentación donde comenzaste. Asigna un nombre al proyecto para que sea más fácil encontrarlo.

Para asignar un nombre al proyecto Apps Script, sigue estos pasos:

  1. En la interfaz web de Apps Script, selecciona el texto Untitled project.
  2. En el diálogo Rename Project, escribe My Slides Advisor y, luego, selecciona Rename.

Prepara los archivos del proyecto

El proyecto de Asesor de diapositivas tiene 5 archivos de código que debes configurar antes de poder copiar el código en tu nuevo proyecto de Apps Script. En esta sección, se describe cómo preparar el proyecto y obtener el código.

Para preparar los archivos del proyecto, haz lo siguiente:

  1. Abre la interfaz web de Apps Script que contiene el proyecto My Slides Advisor.
  2. En el menú lateral izquierdo, selecciona la vista < > Editor.
  3. Para cambiar el nombre del archivo Code.gs a main.gs, desplázate sobre el nombre de archivo de código Code.gs, selecciona Cambiar nombre en el menú contextual y, luego, ingresa main. La interfaz agrega la extensión .gs automáticamente.
  4. Para que el archivo de manifiesto appscript.json del proyecto sea visible, selecciona el ícono de ajustes (Configuración del proyecto) en el menú lateral izquierdo y habilita la opción Show "appscript.json" manifest file.
  5. En la interfaz web de Apps Script, en el menú lateral izquierdo, selecciona la vista < > Editor.
  6. Para crear un archivo de código ui.gs, selecciona el ícono + (más) a la derecha del encabezado Archivos, elige Secuencia de comandos y, luego, ingresa ui.
  7. Repite el paso anterior para crear los archivos de código slides.gs y ai.gs.

Ahora, tu proyecto de Apps Script debería contener los siguientes 5 archivos de código, que suelen estar vacíos:

  • appscript.json
  • main.gs
  • ui.gs
  • slides.gs
  • ai.gs

Para el siguiente paso, obtén el código del proyecto del repositorio y cópialo en tu proyecto de Apps Script.

Obtén el código del proyecto

El código del proyecto del Asesor de diapositivas se aloja en un repositorio de código. Debes copiar ese código en tu proyecto de Apps Script para trabajar con él. En esta sección, se describe cómo obtener el código del proyecto.

Para obtener el código del proyecto, haz lo siguiente:

  1. Navega al repositorio de código del proyecto para el archivo de manifiesto del proyecto, appsscript.json.
  2. Copia el contenido de este archivo de código en el portapapeles.
  3. Regresa a la interfaz web de Apps Script, selecciona el nombre de archivo appsscript.json y pega el código en el panel del editor de código para reemplazar el código anterior.
  4. Repite este procedimiento para los otros 4 archivos de código:
    • Copia el código main.js en el archivo main.gs.
    • Copia el código ui.js en el archivo ui.gs.
    • Copia el código slides.js en tu archivo slides.gs.
    • Copia el código ai.js en el archivo ai.gs.

Conecta un proyecto de Google Cloud

En este proyecto, se usa un proyecto de Google Cloud para acceder a los modelos de Gemini AI. Google Cloud proporciona políticas de privacidad de los datos específicas, así como una variedad de servicios de software útiles para crear aplicaciones como Slides Advisor. Para conectar el código de complemento a la API de Gemini, debes crear un proyecto de Cloud con acceso a la API de IA, crear una cuenta de servicio para el proyecto, crear una clave para la cuenta de servicio y, luego, instalar esa clave en tu proyecto de complemento.

Configura un proyecto de Cloud

El proyecto de Cloud que usas para conectarte a la API de Gemini debe tener habilitado el servicio de la API de Vertex AI y deberás crear una conexión autenticada desde el complemento de Asesor de Presentaciones de este proyecto. La API de Vertex AI también requiere que la facturación esté habilitada en los proyectos en los que la usas.

Sigue estos pasos para configurar un proyecto de Cloud con acceso a la API de Vertex AI:

  1. Navega a la consola de Google Cloud y accede si es necesario.
  2. En la consola de Google Cloud, selecciona un proyecto de Cloud existente o crea uno nuevo.
  3. En la página Panel de la consola de tu proyecto, en el panel APIs, selecciona Ir a Descripción general de las APIs o navega a https://console.cloud.google.com/apis/.
  4. En la página APIs y servicios, en la parte superior de la página, selecciona + HABILITAR APIs Y SERVICIOS.
  5. En la página Biblioteca de APIs, busca vertex ai api, selecciona la opción API de Vertex AI y, luego, el botón Habilitar.
  6. Si aún no está activa, debes habilitar la facturación para tu proyecto de Google Cloud y, luego, habilitar la API de IA seleccionando el botón Habilitar en la página de la consola de la API de Vertex AI.
  7. Navega a la página APIs y servicios de tu proyecto para verificar que la API de Vertex AI esté habilitada. Ahora la API de Vertex AI debería aparecer en esta página.

Crea una cuenta de servicio

El complemento de Asesor de Presentaciones requiere una conexión autenticada a tu proyecto de Cloud para acceder a la API de Vertex AI y a los modelos de Gemini. Para crear esa conexión, primero genera una cuenta de servicio en tu proyecto de Cloud que tenga acceso a la API de Vertex AI. El proyecto del Asesor de diapositivas se conecta con esta cuenta de servicio.

Sigue estos pasos para crear una cuenta de servicio para el complemento de Asesor de Presentaciones:

  1. En la consola de Google Cloud, navega a la página APIs y servicios de tu proyecto de Cloud.
  2. En el lado izquierdo de la página, selecciona Credenciales.
  3. En la parte superior de la página, selecciona + CREAR CREDENCIALES > Cuenta de servicio.
  4. En la sección Detalles de la cuenta de servicio de la página Crear cuenta de servicio, ingresa un nombre, un ID y una descripción para la cuenta de servicio.
  5. Selecciona Crear y continuar para crear la cuenta de servicio.
  6. En la sección Otorga a esta cuenta de servicio acceso al proyecto, selecciona el control Función.
  7. Busca el campo Filtro y, luego, selecciona el conjunto de permisos de Usuario de Vertex AI. Luego, selecciona Continuar.
  8. Selecciona Listo para completar la creación de esta cuenta de servicio.

Para obtener más información sobre cómo crear cuentas de servicio, consulta la documentación Crea cuentas de servicio de Google Cloud.

Crea e instala la clave de la cuenta de servicio

El proyecto de Asesor de diapositivas debe poder autenticarse en la cuenta de servicio que creaste en el procedimiento anterior. Puedes habilitar esa autenticación creando una clave para la cuenta de servicio y configurando esa clave en tu proyecto de Apps Script del Asesor de Presentaciones como una propiedad de secuencia de comandos. En el siguiente procedimiento, se explica cómo crear la clave y configurarla en tu proyecto.

Para crear y configurar una clave de cuenta de servicio, haz lo siguiente:

  1. En la consola de Google Cloud, navega a la página APIs y servicios de tu proyecto de Cloud.
  2. En el lado izquierdo de la página, selecciona Credenciales.
  3. En la sección Cuentas de servicio, busca la cuenta de servicio que creaste, selecciona la dirección de correo electrónico de la cuenta o el ícono de lápiz para editarla.
  4. En la ventana de edición de la cuenta de servicio, cerca de la parte superior de la página, selecciona el título de la pestaña CLAVES.
  5. En la sección Claves, selecciona Agregar clave > Crear clave nueva.
  6. En el cuadro de diálogo Crear clave privada para..., selecciona JSON y, luego, Crear. En este paso, se crea un archivo de claves llamado projectid-hashcode.json y se descarga automáticamente a tu computadora.
  7. Abre el archivo projectid-hashcode.json descargado y copia el contenido.
  8. Abre la interfaz web de Apps Script que contiene el proyecto My Slides Advisor y, en el menú lateral izquierdo, selecciona la vista Settings.
  9. En la sección Propiedades de la secuencia de comandos, selecciona el botón Editar propiedades de la secuencia de comandos y, luego, el botón Agregar propiedad de la secuencia de comandos.
  10. En el nuevo campo Propiedad (Property), ingresa SERVICE_ACCOUNT_KEY y, en el campo Valor (Value), copia el contenido del archivo projectid-hashcode.json descargado.
  11. Para guardar la nueva propiedad, selecciona el botón Guardar propiedades de la secuencia de comandos.

Para obtener más información sobre cómo crear claves de cuenta de servicio, consulta la documentación Crea y borra claves de cuenta de servicio de Google Cloud.

Prueba el proyecto del complemento

Panel de diapositivas de Google Workspace con el ícono del asesor de Presentaciones Para probar el proyecto del Asesor de Presentaciones, debes crear una implementación de prueba del código del complemento y, luego, instalarla. En esta configuración de prueba, el proyecto solo está disponible en el archivo de Presentaciones de Google donde iniciaste el proyecto del complemento de Apps Script y en ninguna otra presentación de Presentaciones. Puedes obtener más información sobre cómo implementar tu complemento para un uso más amplio en la documentación de Apps Script de Google Workspace, en el tema Crea y administra implementaciones.

Para implementar y probar el código del proyecto de Apps Script, sigue estos pasos:

  1. En la parte superior de la interfaz web de Apps Script, selecciona Implementar > Implementaciones de prueba.
  2. En el diálogo Implementaciones de prueba, junto a Seleccionar tipo, selecciona el ícono de ajustes y el Complemento de Google Workspace.
  3. Junto a Aplicaciones(Applications): Título de Presentaciones, selecciona el botón Instalar.
  4. Deja la configuración predeterminada en Prueba el código más reciente y selecciona Listo.
  5. Navega por la presentación de Presentaciones de Google que está conectada a tu proyecto de Apps Script y vuelve a cargar la página web.
  6. En la esquina inferior derecha de la aplicación web de Presentaciones, selecciona el ícono ( <) para abrir el panel lateral y, luego, selecciona el ícono del ojo en blanco y negro para abrir el panel del Asesor de Presentaciones.

Una vez que completes este paso y ejecutes correctamente el complemento, puedes comenzar a modificarlo para que use lineamientos diferentes o siga un flujo de trabajo diferente. Consulta las siguientes secciones para obtener instrucciones sobre cómo hacer algunas modificaciones básicas en el complemento del Asesor de diapositivas.

Modifica el comportamiento de la revisión

Puedes cambiar el comportamiento de revisión del asesor de Presentaciones, tanto en términos del resultado que obtienes de la API de Gemini como en la interfaz de usuario que proporciona el complemento, si modificas el código de su proyecto. Este instructivo se centra en cambiar las instrucciones para modificar el comportamiento de revisión de las diapositivas de la presentación. Si quieres obtener más información para extender la interfaz de usuario de Presentaciones de Google con Apps Script, consulta Cómo ampliar Presentaciones de Google.

Cambiar los lineamientos de la opinión

El Asesor de Presentaciones viene programado con un conjunto básico de pautas para la revisión de diapositivas con categorías de simplicidad, color y tipografía, estructura y espacio en blanco, además de gráficos e íconos. Los lineamientos para la revisión son solo instrucciones de texto que se incluyen en una instrucción a través de la API de Gemini, junto con una imagen del resumen de una diapositiva seleccionada y cualquier nota del orador.

Puedes modificar el comportamiento de revisión del complemento si modificas las instrucciones de texto. Por ejemplo, puedes indicarle al modelo Gemini que muestre la opinión con la calificación de la categoría en la misma línea que el encabezado de la categoría o que cambie el nombre de una categoría.

Para cambiar la ubicación de la calificación de la categoría y el nombre de una categoría, haz lo siguiente:

  1. Abre la interfaz web de Apps Script que contiene el proyecto My Slides Advisor. Si es necesario, para navegar a la ventana del proyecto, abre la presentación de Google que contiene el proyecto de Apps Script y selecciona Extensiones > Apps Script.
  2. En el menú lateral izquierdo, selecciona la vista < > Editor y, luego, selecciona el nombre de archivo ai.gs.
  3. En el archivo de código ai.gs, ubica la constante de cadena SYSTEM_PROMPT y modifica las instrucciones de la siguiente manera con el texto en negrita: 
    const SYSTEM_PROMPT = `
...
For each of the following categories evaluate the given slide. Score each
category on a scale of 0 to 100, show the score next to the category heading,
and concisely explain the reasoning. Do not suggest improvements if the score
is 80 or above.
  4. En la misma constante de cadena SYSTEM_PROMPT, cambia el texto de la categoría Simplicity a Message: 
    const SYSTEM_PROMPT = `
...
* Message -- Slides should focus on one main idea per slide and ...
  5. Guarda los cambios en el archivo de código ai.gs.
  6. Navega por la presentación de Presentaciones de Google conectada a tu proyecto de Apps Script, vuelve a cargar la página web y prueba los cambios en el complemento volviendo a ejecutarlo.

Si aún no configuraste una implementación de prueba para el complemento de Asesor de Presentaciones, sigue las instrucciones que se indican en Prueba el proyecto del complemento.

Puedes quitar, reemplazar o reescribir las instrucciones de la categoría de opiniones en la constante de cadena SYSTEM_PROMPT para que coincida con los requisitos de opiniones. Si deseas probar diferentes enfoques de solicitudes de revisión o volver a escribir todo el mensaje de revisión, consulta la aplicación web de Google AI Studio. Esta app te permite crear prototipos, probar y guardar instrucciones de Gemini en una interfaz conveniente, y usa la misma API de Gemini que el proyecto del Asesor de Presentaciones. Para obtener más información sobre el uso de AI Studio, consulta la guía de inicio rápido de AI Studio.

Cambia la configuración del comportamiento del modelo

La API de Gemini proporciona varias opciones de configuración para cambiar la operación general del modelo en respuesta a un mensaje de solicitud. En particular, la configuración de temperatura del modelo te permite establecer cuánta variación permite el modelo en una respuesta, donde cero es el valor más bajo y 1 es el más alto. Establecer este valor en 0.1 produce respuestas muy coherentes, pero ese comportamiento puede parecer repetitivo y menos útil para los usuarios que reciben comentarios sobre las opiniones. Considera establecer un valor de temperatura más alto y ten en cuenta que cuanto más alta sea la temperatura, más incoherentes podrán ser los resultados, lo que puede incluir implementar instrucciones de manera diferente o ignorar algunas instrucciones por completo.

Para aumentar la temperatura de las respuestas a opiniones, haz lo siguiente:

  1. Abre la interfaz web de Apps Script que contiene el proyecto My Slides Advisor.
  2. En el menú lateral izquierdo, selecciona la vista < > Editor y, luego, selecciona el nombre de archivo ai.gs.

  3. En el archivo de código ai.gs, ubica la función analyzeSlides() y modifica la constante generationConfig mediante la configuración del valor temperature en 0.3:

    function analyzeSlides(slide) {

    const generationConfig = {
        temperature: 0.3,
        maxOutputTokens: 1024 * 2,
    };

  4. Guarda los cambios en el archivo de código ai.gs.

  5. Navega por la presentación de Presentaciones de Google conectada a tu proyecto de Apps Script, vuelve a cargar la página web y prueba los cambios en el complemento volviendo a ejecutarlo.

Para obtener más información sobre los parámetros de configuración del comportamiento del modelo, consulta la documentación de la API de Gemini para GenerationConfig.

Recursos adicionales

Para obtener más información sobre el proyecto del Asesor de diapositivas, consulta el repositorio de códigos. Si necesitas ayuda para compilar la aplicación o quieres colaborar con otros desarrolladores, consulta el servidor de Google Developers Community Discord. Para ver más proyectos de Build with Google IA, consulta la playlist de videos.