Créez, exécutez et personnalisez un module complémentaire de révision pour Google Workspace Slides avec ce projet de code. Que vous fassiez une présentation par semaine ou une par an, la plupart d'entre nous auraient besoin d'un peu d'aide. Avez-vous tendance à en mettre trop dans une diapositive ? Peut-être avez-vous oublié de rompre votre présentation avec des visuels ? Votre organisation peut même définir un ensemble de directives sur des présentations efficaces. Tu les as lues récemment ?
Le projet Slides Advisor est un module complémentaire Google Workspace Open Source qui utilise la technologie d'intelligence artificielle (IA) pour examiner vos présentations et fournir des commentaires à leur sujet, chaque fois que vous en avez besoin. Le projet exploite les fonctionnalités de traitement d'images et de texte de l'API Gemini de Google pour analyser vos présentations Google Slides en fonction d'un ensemble de consignes et vous indiquer vos progrès par rapport à ces consignes. Mieux encore, vous pouvez personnaliser ces directives pour suivre les recommandations de votre organisation ou vous rappeler d'améliorer vos présentations en fonction des règles que vous définissez vous-même.
Pour obtenir une présentation vidéo du projet et de la manière de le développer, y compris avec les insights des personnes qui le créent, consultez la vidéo Éditeur de diapositives IA – Compiler avec l'IA de Google. Sinon, vous pouvez commencer à prolonger le projet en suivant les instructions.
Figure 1. Module complémentaire Slides Advisor pour Google Slides exécuté en tant que panneau latéral.
Configuration du projet
Ces instructions vous guident tout au long de la configuration du projet Slides Advisor pour le développement et le test. Les étapes générales incluent la création du projet Google Apps Script, la configuration d'un projet Google Cloud pour l'accès à l'API et la définition de certaines propriétés de script pour le projet.
Créer un projet Apps Script
Ce projet Slides Advisor fonctionne en tant que module complémentaire pour Google Slides. Configurez le projet à l'aide de l'interface Web de Google Slides et créez un projet Apps Script pour le code.
Pour créer un projet Apps Script:
- Accédez à l'application Web Slides pour Google Workspace.
- Ouvrez une présentation existante ou créez-en une.
- Dans votre présentation Slides, sélectionnez Extensions > Apps Script.
Une fois ces étapes terminées, vous devriez avoir un nouveau projet sans titre dans l'interface utilisateur Web Apps Script, qui est joint à la présentation de départ. Nommez le projet pour le trouver plus facilement.
Pour nommer le projet Apps Script:
- Dans l'interface Web d'Apps Script, sélectionnez le texte Projet sans titre.
- Dans la boîte de dialogue "Rename Project" (Renommer le projet), saisissez
My Slides Advisor, puis sélectionnez Rename (Renommer).
Préparer les fichiers du projet
Le projet "Conseiller Slides" contient cinq fichiers de code, que vous devez configurer avant de pouvoir copier le code dans votre nouveau projet Apps Script. Cette section explique comment préparer le projet et obtenir le code.
Pour préparer les fichiers du projet:
- Ouvrez l'interface Web Apps Script contenant le projet My Slides Advisor.
- Dans le menu de gauche, sélectionnez la vue < > Éditeur.
- Renommez le fichier Code.gs en main.gs. Pour cela, passez la souris sur le nom du fichier Code.gs et sélectionnez Rename (Renommer) dans le menu contextuel, puis saisissez
main. L'interface ajoute automatiquement l'extension .gs. - Rendez le fichier manifeste appscript.json du projet visible en sélectionnant l'icône en forme de roue dentée (Paramètres du projet) dans le menu de gauche, puis en activant l'option Show "appscript.json" manifest file (Afficher le fichier manifeste "appscript.json").
- Dans l'interface Web d'Apps Script, dans le menu de gauche, sélectionnez la vue < > Editor (Éditeur).
- Créez un fichier de code ui.gs en sélectionnant l'icône + (plus) à droite de l'en-tête Files (Fichiers), en sélectionnant Script (Script), puis en saisissant
ui. - Répétez l'étape précédente pour créer les fichiers de code
slides.gsetai.gs.
Votre projet Apps Script doit désormais contenir les cinq fichiers de code suivants, qui sont pour la plupart vides:
- appscript.json
- main.gs
- ui.gs
- slides.gs
- ai.gs
À l'étape suivante, récupérez le code du projet dans le dépôt et copiez-le dans votre projet Apps Script.
Obtenir le code du projet
Le code du projet Slides Advisor est hébergé dans un dépôt de code. Vous devez copier ce code dans votre projet Apps Script pour travailler dessus. Cette section explique comment obtenir le code du projet.
Pour obtenir le code du projet, procédez comme suit:
- Accéder au dépôt de code du projet pour le fichier manifeste du projet,
appsscript.json - Copiez le contenu de ce fichier de code dans votre presse-papiers.
- Revenez à l'interface Web d'Apps Script, sélectionnez le nom de fichier appsscript.json, puis collez le code dans le panneau de l'éditeur de code pour remplacer le code précédent.
- Répétez cette procédure pour les quatre autres fichiers de code :
Associer un projet Google Cloud
Ce projet utilise un projet Google Cloud pour accéder aux modèles d'IA Gemini. Google Cloud propose des règles de confidentialité des données spécifiques, ainsi qu'un large éventail de services logiciels utiles pour la création d'applications, tels que Slides Advisor. Pour connecter le code du module complémentaire à l'API Gemini, créez un projet Cloud avec accès à l'API AI, créez un compte de service pour le projet, créez une clé pour le compte de service et installez cette clé dans votre projet du module complémentaire.
Configurer un projet Cloud
Le service d'API Vertex AI doit être activé sur le projet Cloud que vous utilisez pour vous connecter à l'API Gemini. Vous devez également créer une connexion authentifiée à ce projet à partir du module complémentaire Slides Advisor. L'API Vertex AI nécessite également que la facturation soit activée dans les projets où vous l'utilisez.
Pour configurer un projet Cloud avec un accès à l'API Vertex AI:
- Accédez à la console Google Cloud et connectez-vous si nécessaire.
- Dans la console Google Cloud, sélectionnez un projet Cloud existant ou créez-en un.
- Sur la page Tableau de bord de la console de votre projet, dans le panneau API, sélectionnez Accéder à la présentation des API ou https://console.cloud.google.com/apis/.
- En haut de la page API et services, sélectionnez + ACTIVER DES API ET DES SERVICES.
- Sur la page Bibliothèque d'API, recherchez
vertex ai api, sélectionnez l'option API Vertex AI, puis cliquez sur le bouton Activer. - Si ce n'est pas déjà fait, vous devez activer la facturation pour votre projet Google Cloud, puis activer l'API AI en sélectionnant le bouton Activer sur la page de la console API Vertex AI.
- Vérifiez que l'API Vertex AI est activée en accédant à la page API et services de votre projet. L'API Vertex AI doit maintenant figurer sur cette page.
Créer un compte de service
Le module complémentaire Slides Advisor nécessite une connexion authentifiée à votre projet Cloud pour accéder à l'API Vertex AI et aux modèles Gemini. Pour créer cette connexion, vous devez d'abord générer dans votre projet Cloud un compte de service ayant accès à l'API Vertex AI. Le projet Slides Advisor se connecte à l'aide de ce compte de service.
Pour créer un compte de service pour le module complémentaire Slides Advisor:
- Dans la console Google Cloud, accédez à la page API et services de votre projet Cloud.
- Dans la partie gauche de la page, sélectionnez Identifiants.
- En haut de la page, sélectionnez + CRÉER DES IDENTIFIANTS > Compte de service.
- Sur la page Créer un compte de service, dans la section Détails du compte de service, saisissez un nom, un ID et une description de compte de service.
- Créez le compte de service en sélectionnant Create and Continue (Créer et continuer).
- Dans la section Autoriser ce compte de service à accéder au projet, sélectionnez la commande Rôle.
- Dans le champ Filtrer, sélectionnez l'ensemble d'autorisations Utilisateur Vertex AI, puis Continuer.
- Finalisez la création de ce compte de service en sélectionnant OK.
Pour en savoir plus, consultez la documentation Google Cloud Créer des comptes de service.
Créer et installer une clé de compte de service
Le projet Slides Advisor doit pouvoir s'authentifier auprès du compte de service que vous avez créé à l'étape précédente. Pour activer cette authentification, vous pouvez créer une clé pour le compte de service et la configurer dans votre projet Apps Script Slides Advisor en tant que propriété de script. La procédure suivante explique comment créer la clé et la configurer dans votre projet.
Pour créer et configurer une clé de compte de service, procédez comme suit:
- Dans la console Google Cloud, accédez à la page API et services de votre projet Cloud.
- Dans la partie gauche de la page, sélectionnez Identifiants.
- Dans la section Comptes de service, recherchez le compte de service que vous avez créé, puis sélectionnez son adresse e-mail ou l'icône en forme de crayon pour le modifier.
- Dans la fenêtre de modification du compte de service, en haut de la page, sélectionnez le titre de l'onglet CLÉS.
- Dans la section Clés, sélectionnez Ajouter une clé > Créer une clé.
- Dans la boîte de dialogue Créer une clé privée pour, sélectionnez JSON, puis Créer. Cette étape crée un fichier de clé nommé projectid-hashcode.json et le télécharge automatiquement sur votre ordinateur.
- Ouvrez le fichier projectid-hashcode.json téléchargé et copiez son contenu.
- Ouvrez l'interface Web Apps Script contenant le projet My Slides Advisor, puis sélectionnez la vue Settings (Paramètres) dans le menu de gauche.
- Dans la section Propriétés de script, sélectionnez le bouton Modifier les propriétés de script, puis le bouton Ajouter une propriété de script.
- Dans le nouveau champ Property (Propriété), saisissez
SERVICE_ACCOUNT_KEY, puis dans le champ Value (Valeur), copiez le contenu du fichier projectid-hashcode.json téléchargé. - Enregistrez la nouvelle propriété en sélectionnant le bouton Enregistrer les propriétés du script.
Pour en savoir plus sur la création de clés de compte de service, consultez la documentation Google Cloud Créer et supprimer des clés de compte de service.
Tester le projet du module complémentaire
Pour tester le projet Slides Advisor, vous devez créer un déploiement test du code du module complémentaire et installer ce déploiement test. Dans cette configuration de test, le projet est uniquement disponible dans la présentation Google Slides dans laquelle vous avez démarré le module complémentaire Apps Script sur le projet, et dans aucune autre présentation Slides. Pour en savoir plus sur le déploiement de votre module complémentaire pour une utilisation plus large, consultez l'article Créer et gérer des déploiements de la documentation Google Workspace Apps Script.
Pour déployer et tester le code du projet Apps Script:
- En haut de l'interface Web d'Apps Script, sélectionnez Déployer > Déploiements de test.
- Dans la boîte de dialogue Tester les déploiements, à côté de Sélectionner un type, sélectionnez l'icône en forme de roue dentée et le module complémentaire Google Workspace.
- À côté de "Application(s)" : titre Slides, sélectionnez le bouton Installer.
- Conservez les paramètres par défaut pour Tester le dernier code et sélectionnez OK.
- Naviguez dans la présentation Google Slides connectée à votre projet Apps Script et actualisez la page Web.
- Dans l'angle inférieur droit de l'application Web Slides, sélectionnez l'icône (<) pour ouvrir le panneau latéral, puis sélectionnez l'icône œil en noir et blanc pour ouvrir le panneau Slides Advisor (Conseiller Slides).
Une fois cette étape terminée et le module complémentaire exécuté avec succès, vous pouvez commencer à le modifier pour utiliser des consignes différentes ou suivre un workflow différent. Consultez les sections suivantes pour savoir comment apporter des modifications de base au module complémentaire Advisor pour Slides.
Modifier le comportement d'examen
En modifiant le code du projet, vous pouvez modifier le comportement d'examen de Slides Advisor, à la fois en termes de sortie de l'API Gemini et d'interface utilisateur fournie par le module complémentaire. Ce tutoriel se concentre sur la modification des instructions d'invite pour modifier le comportement de révision des diapositives de la présentation. Pour découvrir comment développer l'interface utilisateur de Google Slides à l'aide d'Apps Script, consultez Extension de l'interface utilisateur de Google Slides.
Consignes relatives à l'examen des modifications
Slides Advisor est programmé avec un ensemble de consignes de base pour la révision des diapositives, avec des catégories pour la simplicité, la couleur et la typographie, la structure et les espaces blancs, ainsi que les graphiques et les icônes. Il s'agit simplement d'instructions textuelles incluses dans une requête via l'API Gemini, ainsi que d'une image instantanée de la diapositive sélectionnée et des commentaires du présentateur.
Vous pouvez modifier le comportement d'examen du module complémentaire en modifiant les instructions textuelles. Par exemple, vous pouvez demander au modèle Gemini de générer l'avis avec la note de la catégorie sur la même ligne que l'en-tête de la catégorie, ou de modifier le nom d'une catégorie.
Pour modifier le lieu d'évaluation de la catégorie et un nom de catégorie:
- Ouvrez l'interface Web Apps Script contenant le projet My Slides Advisor. Si nécessaire, accédez à la fenêtre du projet en ouvrant la présentation Google Slides contenant le projet Apps Script, puis en sélectionnant Extensions > Apps Script.
- Dans le menu de gauche, sélectionnez la vue < > Éditeur, puis sélectionnez le nom de fichier ai.gs.
- Dans le fichier de code ai.gs, localisez la constante de chaîne
SYSTEM_PROMPTet modifiez les instructions comme suit avec le texte en gras :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.
- Dans la même constante de chaîne
SYSTEM_PROMPT, remplacez le texte de la catégorieSimplicityparMessage:const SYSTEM_PROMPT = ` ... * Message -- Slides should focus on one main idea per slide and ...
- Enregistrez les modifications apportées au fichier de code ai.gs.
- Parcourez la présentation Google Slides connectée à votre projet Apps Script, actualisez la page Web et testez les modifications apportées au module complémentaire en l'exécutant à nouveau.
Si vous n'avez pas encore configuré de déploiement test pour le module complémentaire Slides Advisor, suivez les instructions de la section Tester le projet du module complémentaire.
Vous pouvez supprimer, remplacer ou réécrire les instructions de catégorie d'avis dans la constante de chaîne SYSTEM_PROMPT pour répondre à vos exigences d'avis. Si vous souhaitez essayer différentes approches des invites d'examen ou réécrire l'intégralité de l'invite d'examen, consultez l'application Web Google AI Studio. Cette application vous permet de prototyper, de tester et d'enregistrer des requêtes pour Gemini dans une interface pratique. Elle utilise la même API Gemini que le projet Slides Advisor. Pour en savoir plus sur l'utilisation d'AI Studio, consultez le guide de démarrage rapide d'AI Studio.
Modifier la configuration du comportement du modèle
L'API Gemini fournit plusieurs paramètres permettant de modifier le fonctionnement général du modèle en réponse à une invite de requête. En particulier, le paramètre température du modèle vous permet de définir les variations autorisées par le modèle dans une réponse, zéro étant le minimum et 1 le plus élevé. Définir cette valeur sur 0,1 produit des réponses très cohérentes, mais ce comportement peut sembler répétitif et moins utile pour les utilisateurs qui reçoivent des avis. Envisagez de définir une valeur de température plus élevée et gardez à l'esprit que plus la température est élevée, plus les résultats peuvent être incohérents. Cela peut inclure une implémentation différente des instructions, voire la possibilité d'ignorer complètement certaines instructions.
Pour augmenter la température des réponses aux avis:
- Ouvrez l'interface Web Apps Script contenant le projet My Slides Advisor.
- Dans le menu de gauche, sélectionnez la vue < > Éditeur, puis sélectionnez le nom de fichier ai.gs.
Dans le fichier de code ai.gs, localisez la fonction
analyzeSlides()et modifiez la constantegenerationConfigen définissant la valeurtemperaturesur0.3:function analyzeSlides(slide) { const generationConfig = { temperature: 0.3, maxOutputTokens: 1024 * 2, };Enregistrez les modifications apportées au fichier de code ai.gs.
Parcourez la présentation Google Slides connectée à votre projet Apps Script, actualisez la page Web et testez les modifications apportées au module complémentaire en l'exécutant à nouveau.
Pour en savoir plus sur les paramètres de configuration du comportement du modèle, consultez la documentation de l'API Gemini pour GenerationConfig.
Ressources supplémentaires
Pour en savoir plus sur le projet Slides Advisor, consultez le dépôt de code. Si vous avez besoin d'aide pour créer l'application ou si vous souhaitez collaborer avec d'autres développeurs, consultez le serveur Google Developers Community Discord. Pour d'autres projets Compiler avec l'IA de Google, regardez la playlist de vidéos.