Guide de démarrage rapide : Générer du texte à l'aide de Vertex AI

Cette page explique comment utiliser le service avancé Vertex AI d'Apps Script pour inviter le modèle Gemini 2.5 Flash à générer du texte.

Pour en savoir plus sur le service avancé Vertex AI, consultez la documentation de référence.

Texte généré par l'IA à partir du service avancé Vertex AI d'Apps Script.
Figure 1. Réponse du service Vertex AI dans le journal d'exécution Apps Script.

Objectifs

  • configurer votre environnement ;
  • Créez un projet Apps Script qui utilise le service avancé Vertex AI.
  • Exécutez le script pour générer du texte.

Prérequis

Configurer votre environnement

Cette section explique comment configurer votre environnement dans la console Google Cloud et Apps Script.

Activer l'API Vertex AI dans votre projet Cloud

  1. Dans la console Google Cloud, ouvrez votre projet Google Cloud et activez l'API Vertex AI :

    Activer l'API

  2. Vérifiez que vous activez l'API dans le bon projet Cloud, puis cliquez sur Suivant.

  3. Vérifiez que vous activez la bonne API, puis cliquez sur Activer.

Créer et configurer votre projet Apps Script

Pour créer et configurer votre projet Apps Script, procédez comme suit :

  1. Accédez à script.google.com.
  2. Cliquez sur Nouveau projet pour créer un projet Apps Script.
  3. En haut à gauche, cliquez sur Projet sans titre.
  4. Nommez votre script Démarrage rapide de Vertex AI, puis cliquez sur Renommer.

Configurer le service avancé Vertex AI

Pour activer le service avancé Vertex AI et configurer le code, procédez comme suit :

  1. Dans l'éditeur de script, accédez à Services, puis cliquez sur Ajouter un service Icône permettant d'ajouter un service.
  2. Dans le menu déroulant, sélectionnez API Vertex AI, puis cliquez sur Ajouter.

  3. Ouvrez le fichier Code.gs et remplacez son contenu par le code suivant :

    /**
 * 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.';
}

    Remplacez GOOGLE_CLOUD_PROJECT_ID par l'ID de votre projet Cloud.

  4. Cliquez sur Enregistrer Icône d'enregistrement.

Tester le script

  1. Dans l'éditeur de script, cliquez sur Exécuter pour exécuter la fonction main.
  2. Si vous y êtes invité, autorisez le script.
  3. Cliquez sur Journal d'exécution pour afficher la réponse de Vertex AI.

Vertex AI renvoie une réponse à la question, What is Apps Script in one sentence?. Par exemple, le journal d'exécution renvoie une réponse semblable à la suivante :

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.

Effectuer un nettoyage

Pour éviter que les ressources utilisées dans ce tutoriel soient facturées sur votre compte Google Cloud, nous vous recommandons de supprimer le projet Cloud.

  1. Dans la console Google Cloud, accédez à la page Gérer les ressources. Cliquez sur Menu > IAM et administration > Gérer les ressources.

    Accéder au gestionnaire de ressources

  2. Dans la liste des projets, sélectionnez celui que vous souhaitez supprimer, puis cliquez sur Supprimer .
  3. Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour supprimer le projet.

Pour éviter que les ressources utilisées dans ce guide de démarrage rapide soient facturées sur votre compte Google Cloud, nous vous recommandons de supprimer le projet Cloud.