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

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.