Automatiser les tâches Google Workspace avec l'API Gemini

1. Avant de commencer

Dans cet atelier de programmation, vous apprendrez à automatiser les tâches Google Workspace à l'aide des fonctionnalités d'appel de fonctions et de multimodalité de l'API Gemini.

Prérequis

• Connaissances de base d'Apps Script, de JavaScript ou d'un langage de programmation similaire

Objectifs

• Utiliser les fonctionnalités d'appel de fonction et de multimodalité de l'API Gemini
• Comment enchaîner plusieurs appels de l'API Gemini.
• Découvrez comment automatiser des tâches Google Workspace avec l'API Gemini.

Ce dont vous avez besoin

• Un navigateur Web.
• Un compte Gmail Vous pouvez également utiliser un compte Google Workspace pour lequel la configuration spécifique de l'API Gemini a été implémentée.
• Une connexion depuis une région compatible avec l'API Gemini.
• Facultatif : Une interface de ligne de commande avec le programme curl pour tester les requêtes API directes.

Remarque : Dans cet atelier de programmation, vous utilisez Apps Script. Vous n'avez pas besoin d'avoir une expérience directe avec Apps Script, car la syntaxe est très similaire à celle de JavaScript et d'autres langages similaires.

Le code complet de cet atelier de programmation est disponible dans le cookbook de l'API Gemini sur GitHub. Consultez-le si vous avez besoin du code complet.

2. Configurer l'API Gemini

À propos de Gemini

Les modèles Gemini sont la famille de modèles d'IA la plus vaste et la plus performante de Google. Pour profiter de ces modèles dans vos applications, vous pouvez utiliser l'API Gemini. Vous pouvez également essayer l'API Gemini dans Google AI Studio, une interface Web pour l'API qui vous permet d'essayer des requêtes, de modifier les paramètres des modèles et d'ajuster des modèles personnalisés sans écrire de code.

Obtenir une clé

• Pour utiliser l'API Gemini, créez une clé API dans Google AI Studio.

Facultatif : Tester votre clé

Si vous avez accès à une ligne de commande avec curl, ajoutez votre clé à la première ligne du bloc suivant, puis exécutez-la dans votre terminal pour tester la clé API.

export GOOGLE_API_KEY=Paste_your_API_key_here

curl "https://generativelanguage.googleapis.com/v1beta/models?key=${GOOGLE_API_KEY}"

Vous devriez voir une liste de modèles au format JSON, tels que "models/gemini-1.0-pro". Cela signifie que l'opération a fonctionné.

3. Facultatif : Envoyer une requête à l'API Gemini

Dans cette étape facultative, vous allez envoyer une requête à l'API Gemini pour mieux comprendre comment fonctionne la génération de contenu avant de l'ajouter à une application Apps Script.

À propos des modèles

L'API Gemini fournit plusieurs modèles qui présentent des capacités et des limites différentes. Chacun des modèles est listé avec ses capacités sur la page Modèles Gemini.

Créer votre première requête

Pour que l'API Gemini complète une requête textuelle, vous devez créer une requête JSON et l'envoyer au point de terminaison de l'API REST.

Pour cela, procédez comme suit :

1. Dans un nouveau fichier, saisissez la requête JSON suivante :

{
  contents: [
   {
     parts: [
       { text: 'The most important aspects of a persuasive presentation are:' }
     ]
   }
 ]
}

La requête JSON inclut la requête suivante : The most important aspects of a persuasive presentation are:. Le modèle exécutera cette instruction et vous fournira directement le résultat.

La requête JSON comporte trois champs de premier niveau à remplir : contents, generationConfig et safetySettings. Seul contents est requis. Les autres fournissent des mécanismes pour contrôler la sortie.

2. Enregistrez ce JSON dans un fichier presentation.txt, puis transmettez-le directement à curl comme suit :

curl -H 'Content-Type: application/json' -X POST -d @presentation.txt \
  'https://generativelanguage.googleapis.com/v1beta/models/gemini-1.0-pro-latest:generateContent?key='${GOOGLE_API_KEY}

Dans cet exemple, vous définissez les valeurs suivantes dans l'URL :

• v1beta spécifie la version de l'API.
• gemini-1.0-pro-latest spécifie Gemini 1.0 Pro comme modèle et utilise le dernier instantané.
• generateContent spécifie la méthode API que vous appelez.

Un résultat semblable aux lignes suivantes doit s'afficher :

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "* **Credibility:** The audience must trust that you are an expert on the subject matter and that you have their best interests at heart.\n* **Clearness:** Your message must be easy to understand and follow. Avoid using jargon or technical terms that your audience may not be familiar with.\n* **Concreteness:** Use specific examples and data to support your arguments. Avoid making vague or general claims.\n* **Emotional appeal:** In addition to appealing to the audience's logical side, you should also try to connect with them on an emotional level. Use storytelling, humor, and personal anecdotes to make your points more memorable and engaging.\n* **Strong closing:** End your presentation with a strong call to action. Tell the audience what you want them to do and why it is important for them to do it."
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [...]
    }
  ],
  "promptFeedback": {
    "safetyRatings": [...]
  }
}

Pour plus de lisibilité, voici la sortie du terminal au format standard :

• Crédibilité : l'audience doit avoir confiance en votre expertise sur le sujet et croire que vous avez à cœur ses meilleurs intérêts.
• Clarté : votre message doit être facile à comprendre et à suivre. Évitez d'utiliser du jargon ou des termes techniques que votre audience ne connaît peut-être pas.
• Concrétude : utilisez des exemples et des données spécifiques pour étayer vos arguments. Évitez les affirmations vagues ou générales.
• Appel aux émotions : en plus de faire appel à la logique de votre audience, essayez également de créer un lien émotionnel avec elle. Utilisez des histoires, de l'humour et des anecdotes personnelles pour rendre vos propos plus mémorables et attrayants.
• Conclusion percutante : terminez votre présentation par une incitation à l'action percutante. Dites à votre audience ce que vous attendez d'elle et pourquoi c'est important pour elle.

Pour en savoir plus sur les autres paramètres, y compris generationConfig et safetySettings, consultez les guides sur les requêtes et la sécurité.

4. Appeler l'API Gemini depuis Apps Script

1. Accédez à script.new. Un fichier Apps Script code.gs est créé automatiquement pour vous.
2. Placez le curseur sur le fichier code.gs, puis cliquez sur > Renommer.
3. Renommez le fichier en utils.gs.
4. Dans le fichier, supprimez la fonction myFunction pour que le fichier soit vide.

Ajoutez votre clé API au projet

1. Dans le menu de navigation, sélectionnez Paramètres du projet.
2. Sous Propriétés du script, cliquez sur Ajouter une propriété de script.
3. Sous Propriété, saisissez GOOGLE_API_KEY.
4. Sous Valeur, saisissez votre clé API provenant de Google AI Studio.

5. Cliquez sur Enregistrer les propriétés du script.
6. Revenez à l'éditeur.

Ajouter le code de l'API Gemini

Dans le fichier utils.gs, procédez comme suit :

Configurez la clé API et le point de terminaison :

const properties = PropertiesService.getScriptProperties().getProperties();
const geminiApiKey = properties['GOOGLE_API_KEY'];
const geminiEndpoint = `https://generativelanguage.googleapis.com/v1beta/models/gemini-1.0-pro-latest:generateContent?key=${geminiApiKey}`;

1. Ajoutez la fonction suivante qui appelle l'API Gemini avec un prompt spécifique :

function callGemini(prompt, temperature=0) {
  const payload = {
    "contents": [
      {
        "parts": [
          {
            "text": prompt
          },
        ]
      }
    ], 
    "generationConfig":  {
      "temperature": temperature,
    },
  };

  const options = { 
    'method' : 'post',
    'contentType': 'application/json',
    'payload': JSON.stringify(payload)
  };

  const response = UrlFetchApp.fetch(geminiEndpoint, options);
  const data = JSON.parse(response);
  const content = data["candidates"][0]["content"]["parts"][0]["text"];
  return content;
}

2. Ajoutez la fonction suivante qui définit le prompt :

function testGemini() {
  const prompt = "The best thing since sliced bread is";
  const output = callGemini(prompt);
  console.log(prompt, output);
}

Tester

1. Cliquez sur Enregistrer.
2. Sélectionnez testGemini dans la liste déroulante des fonctions, puis cliquez sur .
3. Acceptez les autorisations nécessaires. Votre code devrait s'exécuter et vous devriez voir des résultats dans le journal d'exécution.

Ça a marché !

5. Appeler l'API Gemini avec des images

L'une des fonctionnalités les plus puissantes de la famille de modèles Gemini est la prise en charge des entrées multimodales, ce qui signifie que vous pouvez fournir plus que du texte. Dans cette section, vous allez ajouter une fonction qui appelle l'API Gemini avec une image.

• En haut du fichier utils.gs, après la déclaration const geminiEndpoint existante, ajoutez la ligne suivante :

const geminiProVisionEndpoint = `https://generativelanguage.googleapis.com/v1beta/models/gemini-1.0-pro-vision-latest:generateContent?key=${geminiApiKey}`;

Ajouter le code Gemini Vision

1. Ajoutez une fonction au fichier utils.gs pour appeler ce point de terminaison nouvellement ajouté :

function callGeminiProVision(prompt, image, temperature=0) {
  const imageData = Utilities.base64Encode(image.getAs('image/png').getBytes());

  const payload = {
    "contents": [
      {
        "parts": [
          {
            "text": prompt
          },
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": imageData
            }
          }          
        ]
      }
    ], 
    "generationConfig":  {
      "temperature": temperature,
    },
  };

  const options = { 
    'method' : 'post',
    'contentType': 'application/json',
    'payload': JSON.stringify(payload)
  };

  const response = UrlFetchApp.fetch(geminiProVisionEndpoint, options);
  const data = JSON.parse(response);
  const content = data["candidates"][0]["content"]["parts"][0]["text"];
  return content;
}

2. Ajoutez la fonction de test suivante :

function testGeminiVision() {
  const prompt = "Provide a fun fact about this object.";
  const image = UrlFetchApp.fetch('https://storage.googleapis.com/generativeai-downloads/images/instrument.jpg').getBlob();
  const output = callGeminiProVision(prompt, image);
  console.log(prompt, output);
}

Cette fonction charge une image de test depuis Internet et la transmet à la fonction que vous avez définie. Plus tard, vous le connecterez pour utiliser un graphique à partir d'une feuille de calcul. Il s'agit donc uniquement d'un test.

Tester

• Enregistrez et exécutez la fonction testGeminiVision, puis examinez le résultat.

6. Appeler l'API Gemini avec des outils

En plus du texte et des images, vous pouvez également fournir l'accès à des outils dans vos requêtes.

Ajouter le code de gestion des outils

• Ajoutez une fonction au fichier utils.gs qui accepte une spécification d'outil :

function callGeminiWithTools(prompt, tools, temperature=0) {
  const payload = {
    "contents": [
      {
        "parts": [
          {
            "text": prompt
          },
        ]
      }
    ], 
    "tools" : tools,
    "generationConfig":  {
      "temperature": temperature,
    },    
  };

  const options = { 
    'method' : 'post',
    'contentType': 'application/json',
    'payload': JSON.stringify(payload)
  };

  const response = UrlFetchApp.fetch(geminiEndpoint, options);
  const data = JSON.parse(response);
  const content = data["candidates"][0]["content"]["parts"][0]["functionCall"];
  return content;
}

Pour en savoir plus sur ce schéma et les champs disponibles, consultez la documentation de référence de l'API FunctionDeclaration.

Tester

1. Définissez un outil que le modèle peut utiliser pour trouver la date et l'heure actuelles :

function testGeminiTools() {
  const prompt = "Tell me how many days there are left in this month.";
  const tools = {
    "function_declarations": [
      {
        "name": "datetime",
        "description": "Returns the current date and time as a formatted string.",
        "parameters": {
          "type": "string"
        }
      }
    ]
  };
  const output = callGeminiWithTools(prompt, tools);
  console.log(prompt, output);
}

Le format utilisé ici est le schéma FunctionDeclaration. Vous n'appelez pas réellement la fonction date et heure. Vous recevez uniquement une indication que le modèle a demandé un appel de fonction. Vous gérerez les appels de fonction lors d'une étape ultérieure.

2. Enregistrez et exécutez la fonction testGeminiTools pour afficher le résultat.

7. Présentation des intégrations de démonstration avec Google Workspace

Maintenant que vous comprenez comment fonctionne l'appel de fonction, vous pouvez facilement étendre les capacités du modèle Gemini à d'autres services. Dans les sections suivantes, vous allez créer des intégrations avec des produits Google Workspace, tels que Google Drive, Google Slides et Google Sheets. Voici un schéma simplifié :

En résumé, lorsqu'une requête utilisateur est reçue, vous utilisez l'appel de fonction de l'API Gemini pour déterminer l'outil à utiliser. Vous allez créer trois outils qui peuvent effectuer les opérations suivantes :

• Configurer une réunion La fonction setupMeeting() du diagramme appelle l'API Gemini 1.0 Pro pour résumer un blog dans Google Drive et ajouter le résumé à une réunion nouvellement créée dans Google Agenda.
• Rédige un e-mail en fonction des insights d'un graphique. La fonction draftEmail() du diagramme appelle Gemini 1.0 Pro Vision pour analyser un graphique dans Google Sheets et rédiger un e-mail dans Gmail en fonction de l'analyse.
• Créez un squelette de présentation. La fonction createDeck() du diagramme appelle Gemini 1.0 Pro pour générer des puces pour une présentation dans Google Slides.

Pour chaque outil, vous devez effectuer les trois opérations suivantes :

1. Déterminez si la réponse d'appel de fonction de l'API Gemini demande d'appeler cet outil spécifique dans un bloc if...else.
2. Ajoutez la fonction réelle pour implémenter la fonctionnalité de l'outil.
3. Déclarez l'outil avec l'API Gemini afin que le modèle Gemini connaisse son existence et puisse renvoyer la réponse d'appel de fonction appropriée.

8. Configurer une réunion avec Apps Script

Vous automatisez d'abord la configuration d'une réunion dans Google Agenda, mais vous ajoutez également une description, qui est un résumé d'un fichier dans Google Drive.

Pour cela, procédez comme suit :

1. Téléchargez ce fichier texte, qui est la copie texte du blog sur le lancement de Gemini 1.5 Pro.
2. Importez le fichier dans le dossier racine de Google Drive.
3. Dans l'éditeur, créez un fichier main.gs, puis ajoutez le code suivant :

function main() {
  const userQuery = "Set up a meeting at 10AM tomorrow with Helen to discuss the news in the Gemini-blog.txt file.";

  var tool_use = callGeminiWithTools(userQuery, WORKSPACE_TOOLS);
  Logger.log(tool_use);
  
  if(tool_use['name'] == "setupMeeting") {
    setupMeeting(tool_use['args']['time'], tool_use['args']['recipient'], tool_use['args']['filename']);
    Logger.log("Your meeting has been set up.");
 }
  else
    Logger.log("no proper tool found");
}

Ici, vous appelez la fonctionnalité d'appel de fonction de l'API Gemini. Ensuite, vous devez définir la fonction de l'outil.

4. À gauche de l'éditeur, à côté de Services, cliquez sur + Ajouter un service > API Google Agenda > Ajouter. Cela permet d'activer le service avancé Google Agenda, dont vous aurez besoin pour utiliser certaines API avancées ultérieurement.

5. Dans votre fichier utils.gs, ajoutez le code suivant :

function attachFileToMeeting(event, file, fileName) {
  // Get the iCal ID for the event.
  const iCalEventId = event.getId();

  // Log the ID and title for debugging.
  console.log(`iCal event ID: ${iCalEventId}`);
  console.log(`event Title: ${event.getTitle()}`);

  // Set up the options for listing the event with the advanced Google Calendar service.
  const options = {
      iCalUID: iCalEventId,
    };

  // Use the primary calendar as the calendar ID to list events.
  const calendarId = 'primary';

  // Use the advanced Google Calendar service to list the event.
  const calEvents = Calendar.Events.list(calendarId, options);

  // Get the Calendar ID used by the advanced Google Calendar service.
  const eventId = calEvents.items[0].id;

  // Get the file URL for the attachment.
  const fileUrl = file.getUrl();

    // Set up the patch options to add the file.
    var patch = {
      attachments: [{
        'fileUrl': fileUrl,
        'title': fileName
      }]
    };

    // Patch the event to add the file as an attachment.
    Calendar.Events.patch(patch, 'primary', eventId, {"supportsAttachments": true});  
}

function setupMeeting(time, recipient, filename) {
  const files = DriveApp.getFilesByName(filename);
  const file = files.next();
  const blogContent = file.getAs("text/*").getDataAsString();
  
  var geminiOutput = callGemini("Give me a really short title of this blog and a summary with less than three sentences. Please return the result as a JSON with two fields: title and summary. \n" +  blogContent);
  // The Gemini model likes to enclose the JSON with ```json and ```
  geminiOutput = JSON.parse(geminiOutput.replace(/```(?:json|)/g, ""));  
  const title = geminiOutput['title'];
  const fileSummary = geminiOutput['summary'];

  const event = CalendarApp.getDefaultCalendar().createEventFromDescription(`meet ${recipient} at ${time} to discuss "${title}"`); 
  event.setDescription(fileSummary);
  attachFileToMeeting(event, file, filename);
}

Ce code effectue les opérations suivantes :

• La fonction setupMeeting() parcourt votre Google Drive et trouve le fichier Gemini-blog.txt. Ce nom de fichier est renvoyé automatiquement par l'appel de fonction de l'API Gemini à l'étape 3.
• La fonction setupMeeting() appelle l'API Gemini pour résumer le contenu du fichier, configure une réunion avec CalendarApp à l'aide d'une description en texte libre et ajoute le résumé à la réunion.
• La fonction setupMeeting() appelle la fonction attachFileToMeeting() pour utiliser le service Google Agenda avancé afin de joindre le fichier du blog à la réunion.

Remarque : Dans cet atelier de programmation, vous demandez explicitement au modèle Gemini 1.0 Pro de renvoyer le résultat sous forme de JSON valide dans l'invite. Pour les modèles plus récents comme Gemini 1.5 Pro, vous pouvez utiliser directement le modèle JSON.

6. En haut du fichier utils.gs, ajoutez le code suivant :

const WORKSPACE_TOOLS = {
 "function_declarations": [
   {
     "name": "setupMeeting",
     "description": "Sets up a meeting in Google Calendar.",
     "parameters": {
       "type": "object",
       "properties": {
         "time": {
           "type": "string",
           "description": "The time of the meeting."
         },
         "recipient": {
           "type": "string",
           "description": "The name of the recipient."
         },   
         "filename": {
           "type": "string",
           "description": "The name of the file."
         },                     
       },
       "required": [
         "time",
         "recipient",
         "filename"
       ]
     }
   },
   // You add tools here.        
 ]
};

7. Dans l'éditeur, revenez au fichier main.gs et cliquez sur .
8. Si Google Workspace vous demande l'autorisation d'exécuter le script, cliquez sur OK.

Au bout de quelques secondes, le journal d'exécution affiche un message vous informant que votre réunion est configurée.

9. Dans Google Agenda, recherchez la réunion avec le résumé et la pièce jointe.

9. Rédiger un e-mail avec Apps Script

Ensuite, vous automatiserez la rédaction d'un e-mail dans Gmail. Voici le scénario : supposons que vous effectuiez une analyse de données dans Google Sheets. Vous mettez tous les chiffres en place et créez un graphique. Vous souhaitez utiliser l'API Gemini Pro Vision pour rédiger un e-mail basé sur le graphique.

Pour cela, procédez comme suit :

1. Ouvrez cette feuille de calcul, puis cliquez sur Fichier > Créer une copie.
2. Dans la zone de texte Nom de la boîte de dialogue Copier le document, remplacez le nom par défaut Copy of CollegeExpenses par CollegeExpenses.
3. Dans le fichier main.gs, remplacez la requête utilisateur précédente par une nouvelle, puis ajoutez le code suivant à l'instruction if...else :

function main() {
  // const userQuery = "Set up a meeting at 5PM with Helen to discuss the news in the Gemini-1.5-blog.txt file.";  
  const userQuery = "Draft an email for Mary with insights from the chart in the CollegeExpenses sheet.";

  if(...) {...}
  // Add this code
  else if(tool_use['name'] == "draftEmail") {
    draftEmail(tool_use['args']['sheet_name'], tool_use['args']['recipient']);
    Logger.log("Check your Gmail to review the draft");
  }
  else {...}

}

4. Dans votre fichier utils.gs, ajoutez le code suivant :

function draftEmail(sheet_name, recipient) {
  
  const prompt = `Compose the email body for ${recipient} with your insights for this chart. Use information in this chart only and do not do historical comparisons. Be concise.`;

  var files = DriveApp.getFilesByName(sheet_name);
  var sheet = SpreadsheetApp.openById(files.next().getId()).getSheetByName("Sheet1");
  var expenseChart = sheet.getCharts()[0];

  var chartFile = DriveApp.createFile(expenseChart.getBlob().setName("ExpenseChart.png"));
  var emailBody = callGeminiProVision(prompt, expenseChart);
  GmailApp.createDraft(recipient+"@demo-email-provider.com", "College expenses", emailBody, {
      attachments: [chartFile.getAs(MimeType.PNG)],
      name: 'myname'
  });
}

Cette fonction récupère le graphique des dépenses universitaires de la feuille et l'envoie à Gemini Pro Vision pour rédiger l'e-mail. Gemini Pro Vision extrait les informations du graphique et rédige le corps de l'e-mail à votre place.

5. Dans le fichier utils.gs, ajoutez le code suivant à l'objet WORKSPACE_TOOLS après le commentaire You add tools here :

  WORKSPACE_TOOLS = {
    "function_declarations": [
      // You add tools here.

      {
        "name": "draftEmail",
        "description": "Write an email by analyzing data or charts in a Google Sheets file.",
        "parameters": {
          "type": "object",
          "properties": {
            "sheet_name": {
              "type": "string",
              "description": "The name of the sheet to analyze."
            },
            "recipient": {
              "type": "string",
              "description": "The name of the recipient."
            },            
          },
          "required": [
            "sheet_name",
            "recipient"
          ]
        }
      },   


    ]
  };

6. Dans l'éditeur, revenez au fichier main.gs, puis cliquez sur .
7. Attendez 10 à 20 secondes, puis ouvrez Gmail. Un brouillon d'e-mail semblable à celui-ci doit s'afficher :

Vous pouvez réviser le brouillon d'e-mail avant de l'envoyer. L'e-mail est entièrement rédigé par Gemini Pro Vision après que vous lui avez fourni une courte requête et le graphique.

Remarque : Il est recommandé de vérifier et de personnaliser le brouillon avant de l'envoyer.

10. Créer une présentation squelette avec Apps Script

Vous allez ensuite automatiser la création d'une présentation squelette dans Google Slides avec Apps Script.

Pour cela, procédez comme suit :

1. Dans le fichier main.gs, remplacez la requête utilisateur précédente par une nouvelle, puis ajoutez le code suivant à l'instruction if...else :

function main() {
  // const userQuery = "Draft an email for Mary with insights from the chart in the CollegeExpenses sheet.";
  const userQuery = "Help me put together a deck about water conservation.";

  if(...) {...}
  // Add this code
  else if(tool_use['name'] == 'createDeck') {
    deckURL = createDeck(tool_use['args']['topic']);
    Logger.log("Deck URL: " + deckURL);
  }
  else {...}

}

2. Dans votre fichier utils.gs, ajoutez le code suivant :

function createDeck(topic) {
  const prompt = `I'm preparing a ${NUM_SLIDES}-slide deck to discuss ${topic}. Please help me brainstorm and generate main bullet points for each slide. Keep the title of each slide short. Please produce the result as a valid JSON so that I can pass it to other APIs.`;
  
  var geminiOutput = callGemini(prompt, 0.4);
  // The Gemini model likes to enclose the JSON with ```json and ```
  geminiOutput = geminiOutput.replace(/```(?:json|)/g, "");
  const bulletPoints = JSON.parse(geminiOutput);
    
  // Create a Google Slides presentation.
  const presentation = SlidesApp.create("My New Presentation");

  // Set up the opening slide.
  var slide = presentation.getSlides()[0]; 
  var shapes = slide.getShapes();
  shapes[0].getText().setText(topic);

  var body;
  for (var i = 0; i < NUM_SLIDES; i++) {
      slide = presentation.appendSlide(SlidesApp.PredefinedLayout.TITLE_AND_BODY);
      shapes = slide.getShapes();
      // Set title.
      shapes[0].getText().setText(bulletPoints['slides'][i]['title']);
  
      // Set body.
      body = "";
      for (var j = 0; j < bulletPoints['slides'][i]['bullets'].length; j++) {
        body += '* ' + bulletPoints['slides'][i]['bullets'][j] + '\n';
      }
      shapes[1].getText().setText(body);
  } 

  return presentation.getUrl();
}

Remarque : Dans cet atelier de programmation, vous demandez explicitement au modèle Gemini 1.0 Pro de renvoyer le résultat sous forme de JSON valide dans l'invite. Pour les modèles plus récents comme Gemini 1.5 Pro, vous pouvez utiliser directement le modèle JSON.

Cette fonction appelle l'API Gemini pour générer des idées sur un sujet spécifique et renvoie les puces au format

de JSON, puis utilisez Apps Script pour remplir un jeu de diapositives squelette.

3. Dans le fichier utils.gs, ajoutez le code suivant à l'objet WORKSPACE_TOOLS après le commentaire You add tools here :

  WORKSPACE_TOOLS = {
    "function_declarations": [
      // You add tools here.

      {
        "name": "createDeck",
        "description": "Build a simple presentation deck with Google Slides and return the URL.",
        "parameters": {
          "type": "object",
          "properties": {
            "topic": {
              "type": "string",
              "description": "The topic that the presentation is about."
            },
          },
          "required": [
            "topic"
          ]
        }
      },


    ]
  };

4. En haut du fichier utils.gs, définissez la constante suivante :

const NUM_SLIDES = 3;

Il s'agit du nombre de diapositives que le modèle Gemini crée en plus de la diapositive d'ouverture.

5. Dans l'éditeur, revenez au fichier main.gs, puis cliquez sur . Au bout de quelques secondes, l'URL d'une présentation s'affiche dans le journal d'exécution.
6. Ouvrez l'URL dans votre navigateur. Vous devriez voir un squelette de présentation rempli de puces.

Remarque : Les diapositives sont très basiques, mais vous pouvez facilement utiliser Apps Script pour ajuster la mise en page ou ajouter des éléments visuels afin de les rendre plus élaborées.

11. Idées à explorer

Au-delà de ces trois intégrations, vous pouvez explorer les idées suivantes :

• Créez un chatbot dans Google Chat. L'un des cas d'utilisation les plus populaires des grands modèles de langage (LLM) est la création d'un chatbot. L'API Gemini permet de créer facilement un chatbot pour Google Chat. Pour en savoir plus, consultez l'API Google Chat et l'atelier de programmation Créer des applications pour Google Chat avec Gemini.
• Génération augmentée par récupération (RAG) avec vos propres données dans Google Drive ou Keep. Dans cet atelier de programmation, vous n'utiliserez qu'un seul fichier texte pour la synthèse. Toutefois, vous pouvez également utiliser le contenu de votre Google Drive et Keep personnels (notes, PDF et images, par exemple) avec l'API Gemini, une base de données vectorielle et, éventuellement, un outil d'orchestration tel que LangChain pour effectuer une récupération et génération augmentées (RAG) et personnaliser la réponse du modèle en fonction de vos données.
• Utilisez la fonctionnalité d'appel de fonction multitour de l'API Gemini. L'appel de fonction de l'API Gemini n'est pas limité à un tour. Vous pouvez utiliser l'appel de fonction multitour pour des tâches encore plus complexes.
• Allez au-delà de Google Workspace. Maintenant que vous savez comment intégrer l'API Gemini à Google Workspace, vous pouvez aller au-delà de Google Workspace et exploiter d'autres API.

12. Félicitations

Vous avez découvert les capacités multimodales et l'appel de fonction de l'API Gemini. Vous les avez utilisés pour automatiser certaines tâches Google Workspace avec Apps Script.

En savoir plus

• Modèles d'IA pour l'API Gemini
• Appel de fonction Gemini
• Google Workspace Apps Script