מדריך מהיר: יצירת טקסט באמצעות Vertex AI

בדף הזה מוסבר איך להשתמש בשירות המתקדם Vertex AI של Apps Script כדי להנחות את מודל Gemini 2.5 Flash ליצור טקסט.

מידע נוסף על שירות Vertex AI מתקדם מופיע במאמרי העזרה.

טקסט שנוצר על ידי AI משירות מתקדם של Vertex AI ב-Apps Script.
איור 1. התשובה של שירות Vertex AI ביומן הביצוע של Apps Script.

מטרות

  • מגדירים את הסביבה.
  • יוצרים פרויקט Apps Script שמשתמש בשירות המתקדם של Vertex AI.
  • מריצים את הסקריפט כדי ליצור טקסט.

דרישות מוקדמות

הגדרת הסביבה

בקטע הזה מוסבר איך להגדיר את הסביבה במסוף Google Cloud וב-Apps Script.

הפעלה של Vertex AI API בפרויקט ב-Cloud

  1. במסוף Google Cloud, פותחים את הפרויקט ב-Google Cloud ומפעילים את Vertex AI API:

    הפעלה של ה-API

  2. מוודאים שאתם מפעילים את ה-API בפרויקט הנכון בענן ולוחצים על הבא.

  3. מוודאים שמפעילים את ה-API הנכון ולוחצים על הפעלה.

יצירה והגדרה של פרויקט Apps Script

כדי ליצור ולהגדיר את פרויקט Apps Script, מבצעים את השלבים הבאים:

  1. עוברים אל script.google.com.
  2. לוחצים על פרויקט חדש כדי ליצור פרויקט Apps Script.
  3. בפינה הימנית העליונה, לוחצים על פרויקט ללא שם.
  4. נותנים לתסריט את השם Vertex AI quickstart ולוחצים על Rename (שינוי שם).

הגדרת שירות מתקדם של Vertex AI

כדי להפעיל את השירות המתקדם של Vertex AI ולהגדיר את הקוד:

  1. בכלי לעריכת סקריפטים, עוברים אל Services (שירותים) ולוחצים על Add a service (הוספת שירות)הסמל להוספת שירות.
  2. בתפריט הנפתח, בוחרים באפשרות Vertex AI API ולוחצים על הוספה.

  3. פותחים את הקובץ Code.gs ומחליפים את התוכן שלו בקוד הבא:

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

    מחליפים את GOOGLE_CLOUD_PROJECT_ID במזהה הפרויקט של פרויקט Cloud.

  4. לוחצים על שמירה סמל השמירה.

בדיקת הסקריפט

  1. בכלי לעריכת סקריפטים, לוחצים על הפעלה כדי להריץ את הפונקציה main.
  2. אם מוצגת בקשה, מאשרים את הסקריפט.
  3. לוחצים על יומן הביצוע כדי לראות את התגובה מ-Vertex AI.

‫Vertex AI מחזיר תשובה לשאלה, What is Apps Script in one sentence?. לדוגמה, יומן הביצוע מחזיר תגובה כמו זו:

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.

הסרת המשאבים

כדי להימנע מחיובים בחשבון Google Cloud בגלל השימוש במשאבים שנעשה במסגרת המדריך הזה, מומלץ למחוק את פרויקט Cloud.

  1. במסוף Google Cloud, עוברים לדף Manage resources. לוחצים על תפריט > IAM & Admin > Manage Resources.

    כניסה ל-Resource Manager

  2. ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים למחוק ולוחצים על Delete .
  3. כדי למחוק את הפרויקט, כותבים את מזהה הפרויקט בתיבת הדו-שיח ולוחצים על Shut down.

כדי להימנע מחיובים בחשבון Google Cloud על המשאבים שבהם השתמשתם במדריך למתחילים הזה, מומלץ למחוק את פרויקט הענן.