شروع سریع: تولید متن با استفاده از Vertex AI

این صفحه نحوه استفاده از سرویس پیشرفته هوش مصنوعی Vertex از Apps Script را برای وادار کردن مدل Gemini 2.5 Flash به تولید متن توضیح می‌دهد.

برای کسب اطلاعات بیشتر در مورد سرویس پیشرفته Vertex AI، به مستندات مرجع مراجعه کنید.

متن تولید شده توسط هوش مصنوعی از سرویس پیشرفته هوش مصنوعی Vertex شرکت Apps Script.
شکل ۱. پاسخ سرویس Vertex AI در گزارش اجرای Apps Script.

اهداف

  • محیط خود را تنظیم کنید.
  • یک پروژه Apps Script ایجاد کنید که از سرویس پیشرفته Vertex AI استفاده کند.
  • اسکریپت را برای تولید متن اجرا کنید.

پیش‌نیازها

محیط خود را تنظیم کنید

این بخش نحوه پیکربندی و تنظیم محیط شما در کنسول Google Cloud و Apps Script را توضیح می‌دهد.

فعال کردن Vertex AI API در پروژه ابری شما

  1. در کنسول Google Cloud، پروژه Google Cloud خود را باز کنید و Vertex AI API را فعال کنید:

    فعال کردن API

  2. تأیید کنید که API را در پروژه Cloud صحیح فعال می‌کنید، سپس روی Next کلیک کنید.

  3. تأیید کنید که API صحیح را فعال می‌کنید، سپس روی فعال کردن کلیک کنید.

پروژه Apps Script خود را ایجاد و تنظیم کنید

برای ایجاد و تنظیم پروژه Apps Script خود، مراحل زیر را انجام دهید:

  1. به script.google.com بروید.
  2. برای ایجاد یک پروژه Apps Script روی New project کلیک کنید.
  3. در بالا سمت چپ، روی «پروژه بدون عنوان» کلیک کنید.
  4. نام اسکریپت خود را Vertex AI quickstart بگذارید و روی Rename کلیک کنید.

سرویس پیشرفته Vertex AI را راه‌اندازی کنید

برای فعال کردن سرویس پیشرفته Vertex AI و تنظیم کد، موارد زیر را انجام دهید:

  1. در ویرایشگر اسکریپت، به بخش خدمات (Services) بروید و روی افزودن سرویس (Add a service) کلیک کنید. آیکون اضافه کردن سرویس .
  2. در منوی کشویی، Vertex AI API را انتخاب کرده و روی Add کلیک کنید.

  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 ، روی Run کلیک کنید.
  2. در صورت درخواست، اسکریپت را تأیید کنید.
  3. برای مشاهده پاسخ از Vertex AI، روی Execution log کلیک کنید.

هوش مصنوعی ورتکس 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. در کنسول گوگل کلود، به صفحه مدیریت منابع بروید. منو > مدیریت و دسترسی به منابع (IAM & Admin) > مدیریت منابع (Manage Resources) کلیک کنید.

    به مدیریت منابع بروید

  2. در لیست پروژه‌ها، پروژه‌ای را که می‌خواهید حذف کنید انتخاب کنید و سپس روی «حذف کلیک کنید.
  3. در کادر محاوره‌ای، شناسه پروژه را تایپ کنید و سپس برای حذف پروژه، روی خاموش کردن (Shut down) کلیک کنید.

برای جلوگیری از تحمیل هزینه به حساب Google Cloud خود برای منابع استفاده شده در این راهنمای سریع، توصیه می‌کنیم پروژه Cloud را حذف کنید.