البدء السريع: إنشاء نص باستخدام Vertex AI

توضّح هذه الصفحة كيفية استخدام خدمة Vertex AI المتقدّمة في Apps Script لطلب نموذج Gemini 2.5 Flash لإنشاء نص.

لمزيد من المعلومات حول خدمة Vertex AI المتقدّمة، يُرجى الاطّلاع على المستندات المرجعية.

نص من إنشاء الذكاء الاصطناعي من خدمة Vertex AI المتقدّمة في Apps Script
الشكل 1. استجابة خدمة Vertex AI في سجلّ تنفيذ "برمجة تطبيقات Google"

الأهداف

  • إعداد البيئة
  • أنشئ مشروعًا في "برمجة تطبيقات Google" يستخدم الخدمة المتقدّمة Vertex AI.
  • شغِّل النص البرمجي لإنشاء النص.

المتطلبات الأساسية

إعداد البيئة

يوضّح هذا القسم كيفية ضبط بيئتك وإعدادها في Google Cloud Console وApps Script.

تفعيل واجهة برمجة التطبيقات Vertex AI API في مشروعك على Google Cloud

  1. في Google Cloud Console، افتح مشروعك على Google Cloud وفعِّل واجهة Vertex AI API باتّباع الخطوات التالية:

    تفعيل واجهة برمجة التطبيقات

  2. تأكَّد من أنّك بصدد تفعيل واجهة برمجة التطبيقات في مشروع Cloud الصحيح، ثم انقر على التالي.

  3. تأكَّد من تفعيل واجهة برمجة التطبيقات الصحيحة، ثم انقر على تفعيل.

إنشاء مشروعك في "برمجة تطبيقات Google" وإعداده

لإنشاء مشروع Apps Script وإعداده، يُرجى اتّباع الخطوات التالية:

  1. انتقِل إلى script.google.com.
  2. انقر على مشروع جديد لإنشاء مشروع Apps Script.
  3. في أعلى يمين الصفحة، انقر على مشروع بدون عنوان.
  4. أدخِل اسمًا للبرنامج النصي Vertex AI quickstart وانقر على إعادة تسمية.

إعداد خدمة Vertex AI المتقدّمة

لتفعيل خدمة Vertex AI المتقدّمة وإعداد الرمز البرمجي، اتّبِع الخطوات التالية:

  1. في محرّر النصوص البرمجية، انتقِل إلى الخدمات وانقر على إضافة خدمة رمز لإضافة خدمة.
  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 بـ معرّف المشروع في مشروعك على السحابة الإلكترونية.

  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 Console، انتقِل إلى صفحة إدارة الموارد. انقر على القائمة > إدارة الهوية وإمكانية الوصول والمشرف > إدارة الموارد.

    الانتقال إلى "إدارة الموارد"

  2. في قائمة المشاريع، اختَر المشروع الذي تريد حذفه، ثم انقر على حذف .
  3. في مربّع الحوار، اكتب رقم تعريف المشروع، ثم انقر على إيقاف لحذف المشروع.

لتجنُّب تحمّل رسوم في حسابك على Google Cloud مقابل الموارد المستخدَمة في هذا الدليل السريع، ننصحك بحذف مشروع Cloud.