Service Vertex AI

Le service Vertex AI vous permet d'utiliser l'API Vertex AI dans Apps Script. Cette API vous donne accès à Gemini et à d'autres modèles d'IA générative pour la génération de texte, d'images et plus encore.

Prérequis

• Un projet Google Cloud avec facturation activée. Pour vérifier si la facturation est activée pour un projet existant, consultez Vérifier l'état de facturation de vos projets. Pour créer un projet et configurer la facturation, consultez Créer un projet Google Cloud.

• Dans la console Google Cloud, accédez à votre projet Cloud et activez l'API Vertex AI :

  Activer l'API

• Configurez votre projet Apps Script :

  • Activez le service Vertex AI. Pour savoir comment procéder, consultez Services Google avancés.
  • Dans les paramètres du projet, ajoutez votre projet Cloud.

Référence

Pour en savoir plus sur ce service, consultez la documentation de référence de l'API Vertex AI. Comme tous les services avancés d'Apps Script, le service Vertex AI utilise les mêmes objets, méthodes et paramètres que l'API publique.

Exemple de code

L'exemple de code suivant utilise la version 1 de l'API Vertex AI.

Générer du texte

Cet exemple de code montre comment demander au modèle Gemini 2.5 Flash de générer du texte. La fonction renvoie la sortie au journal d'exécution d'Apps Script.

/**
 * 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.