أنشِئ مراجعًا للشرائح المستنِدة إلى الذكاء الاصطناعي باستخدام Gemini

تجميع وتشغيل وتخصيص إضافة لمراجعي الشرائح في Google Workspace العروض التقديمية التي تتضمن مشروع الترميز هذا ما إذا كنت تقوم بعرض تقديمي واحد في الأسبوع أو واحدة في السنة، يمكن لمعظمنا استخدام القليل من المساعدة في تصحيحها. هل تميل إلى وضع الكثير في الشريحة؟ ربما نسيت تقسيم عرضك التقديمي باستخدام العناصر المرئية؟ قد يكون لديك أيضًا مجموعة من الإرشادات من مؤسستك حول وعروضك التقديمية الفعالة. هل قرأت هذه الأخبار مؤخرًا؟

مستشار "العروض التقديمية من Google" هو عبارة عن إضافة مفتوحة المصدر في Google Workspace تستخدم الذكاء الاصطناعي (AI) لمراجعة عروضك التقديمية وتقديم الملاحظات بشأنها متى احتجت إليها. يستخدم المشروع صور ونص Gemini API من Google ميزات المعالجة لتحليل "العروض التقديمية من Google" وفقًا لمجموعة من الإرشادات ويتيح لك معرفة مدى امتثالك لهذه الإرشادات والأفضل من ذلك، يمكنك تخصيص هذه الإرشادات لاتباع توصيات مؤسستك، أو تذكيرك بتحسين عروضك التقديمية بناءً على القواعد التي تحددها نفسك.

للحصول على نظرة عامة بالفيديو على المشروع وكيفية تمديده، بما في ذلك الرؤى من الأشخاص الذين أنشأوا هذه الصفحة، يمكنك الاطّلاع على مراجِع الشرائح المستنِدة إلى الذكاء الاصطناعي (AI) - Build with Google الذكاء الاصطناعي بخلاف ذلك، يمكنك البدء في تمديد المشروع باتباع التعليمات التالية.

تشغيل إضافة "مستشار العروض التقديمية" كشريط جانبي في "العروض التقديمية من Google" الشكل 1. إضافة "مستشار العروض التقديمية" في "العروض التقديمية من Google" التي تعمل كلوحة شريط جانبي.

إعداد المشروع

توجهك هذه التعليمات خلال إعداد مشروع "مستشار العروض التقديمية". للتطوير والاختبار. تتمثل الخطوات العامة في إنشاء Google Apps مشروع نص برمجي، وإعداد مشروع Google Cloud للوصول إلى واجهة برمجة التطبيقات، والإعداد بعض خصائص النص البرمجي للمشروع.

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

يتم تشغيل مشروع "مستشار العروض التقديمية" هذا الإضافة لـ العروض التقديمية من Google. تقوم بإعداد المشروع باستخدام واجهة ويب العروض التقديمية من Google، عليك إنشاء مشروع "برمجة تطبيقات Google" للرمز.

لإنشاء مشروع "برمجة تطبيقات Google" جديد، اتّبِع الخطوات التالية:

  1. انتقِل إلى تطبيق "العروض التقديمية من Google" على الويب في Google. زيادة الإنتاجية والتعاون.
  2. افتح عرضًا تقديميًا حاليًا أو أنشئ عرضًا تقديميًا جديدًا.
  3. في العرض التقديمي في "العروض التقديمية من Google"، اختَر الإضافات > برمجة التطبيقات:

عند إكمال هذه الخطوات، من المفترض أن يكون لديك مشروع بلا عنوان جديد في واجهة مستخدم الويب لبرمجة التطبيقات المرفقة بالعرض التقديمي حيث بدأت. قم بتسمية المشروع لتسهيل العثور عليه.

لتسمية مشروع "برمجة تطبيقات Google":

  1. في واجهة الويب لبرمجة التطبيقات، اختَر نص مشروع بلا عنوان.
  2. في مربّع الحوار "إعادة تسمية المشروع"، اكتب: My Slides Advisor، ثم اختَر إعادة تسمية.

تجهيز ملفات المشروع

يحتوي مشروع "مستشار العروض التقديمية" على 5 ملفات رموز، وتحتاج إلى إعداد هذه الملفات قبل أن تتمكّن من نسخ الرمز إلى مشروع "برمجة تطبيقات Google" الجديد هذا القسم يصف كيفية إعداد المشروع والحصول على الكود.

لإعداد ملفات المشروع:

  1. افتح واجهة الويب لـ "برمجة تطبيقات Google" التي تحتوي على مستشار "العروض التقديمية من Google". مشروعك.
  2. في القائمة الجانبية اليمنى، حدد < &gt; المحرِّر.
  3. أعد تسمية ملف Code.gs إلى main.gs من خلال تمرير مؤشر الماوس فوق Code.gs. اسم ملف الرمز، مع اختيار إعادة تسمية من قائمة السياق، عند إدخال main. تعمل الواجهة على تثبيت الإضافة gs .تلقائيًا.
  4. يمكنك إظهار ملف بيان appscript.json للمشروع من خلال اختيار رمز الترس (إعدادات المشروع) في القائمة الجانبية اليمنى، ثم لتفعيل نافذة إظهار "appscript.json" ملف البيان.
  5. في واجهة الويب لبرمجة التطبيقات، في القائمة الجانبية اليمنى، حدد < &gt; المحرِّر.
  6. أنشئ ملف رمز ui.gs هو اختيار رمز + (علامة الجمع) على اليسار. من عنوان الملفات، مع اختيار النص البرمجي وإدخال ui.
  7. كرِّر الخطوة السابقة لإنشاء slides.gs وai.gs ملفات التعليمات البرمجية.

يجب أن يحتوي مشروع "برمجة تطبيقات Google" الآن على ملفات الرموز الخمسة التالية، والتي تكون فارغة في الغالب:

  • appscript.json
  • main.gs
  • ui.gs
  • slides.gs
  • ai.gs

للخطوة التالية، احصل على رمز المشروع من المستودع وانسخه إلى مشروع "برمجة تطبيقات Google"

الحصول على رمز المشروع

تتم استضافة رمز مشروع "العروض التقديمية من Google" في مستودع رموز. إِنْتَ تحتاج إلى نسخ هذا الرمز إلى مشروع "برمجة تطبيقات Google" للعمل معه. هذا النمط كيفية الحصول على كود المشروع.

للحصول على رمز المشروع:

  1. انتقل إلى مستودع رموز المشروع لملف بيان المشروع، appsscript.json
  2. انسخ محتوى ملف الرمز هذا إلى الحافظة.
  3. انتقِل مرة أخرى إلى واجهة الويب لبرمجة التطبيقات، واختَر appsscript.json، ولصق الرمز في أداة تعديل الرموز ستحل محل أي رمز سابق.
  4. كرر هذا الإجراء مع ملفات الرموز الأربعة الأخرى:
    • نسخ main.js الرمز إلى ملف main.gs.
    • نسخ ui.js التعليمات البرمجية إلى ملف ui.gs.
    • نسخ slides.js التعليمات البرمجية إلى ملف slides.gs.
    • نسخ ai.js الرمز البرمجي إلى ملف ai.gs.

ربط مشروع على Google Cloud

يستخدم هذا المشروع مشروعًا على Google Cloud للوصول إلى نماذج Gemini المستنِدة إلى الذكاء الاصطناعي. Google توفّر السحابة الإلكترونية خصوصية بيانات محدَّدة ، بالإضافة إلى مجموعة من خدمات البرامج المفيدة لإنشاء وتطبيقات مثل Slides Advisor. ربط رمز الإضافة بواجهة Gemini API من خلال إنشاء مشروع على Google Cloud ومنحه إمكانية الوصول إلى AI API، وإنشاء حساب خدمة للمشروع، وإنشاء مفتاح لحساب الخدمة، وتثبيت هذا المفتاح في لمشروعك الإضافي.

إعداد مشروع على السحابة الإلكترونية

المشروع على Google Cloud الذي تستخدمه للربط بواجهة Gemini API يجب أن يتضمّن Vertex AI تم تفعيل خدمة واجهة برمجة التطبيقات، وستحتاج إلى إنشاء اتصال تمت مصادقته من إضافة مستشار الشرائح في هذا المشروع. تتطلّب أيضًا Vertex AI API في المشاريع التي تستخدمها.

لإعداد مشروع على السحابة الإلكترونية ومنحه إذن الوصول إلى Vertex AI API، اتّبِع الخطوات التالية:

  1. انتقِل إلى وحدة تحكُّم Google Cloud وتسجيل الدخول إذا لزم الأمر.
  2. اختيار مشروع حالي على Cloud في وحدة التحكّم في Google Cloud أو إنشاء علامة جديدة
  3. في وحدة التحكّم صفحة لوحة البيانات مشروعك، في لوحة واجهات برمجة التطبيقات، انقر على الانتقال إلى نظرة عامة على واجهات برمجة التطبيقات، أو انتقِل إلى https://console.cloud.google.com/apis/.
  4. في صفحة واجهات برمجة التطبيقات والخدمات، في أعلى الصفحة، اختَر + تفعيل واجهات برمجة التطبيقات والخدمات:
  5. في صفحة مكتبة واجهة برمجة التطبيقات، ابحث عن vertex ai api، ثم اختَر Vertex AI API، ثم انقر على الزر تفعيل.
  6. إذا لم تكن نشطة بالفعل، يجب تفعيل الفوترة لحسابك على Google Cloud. ثم تفعيل AI API من خلال النقر على الزر تفعيل في صفحة وحدة تحكُّم Vertex AI API
  7. تأكَّد من تفعيل Vertex AI API من خلال الانتقال إلى واجهات برمجة التطبيقات والخدمات لمشروعك. من المفترض أن يظهر لك الآن Vertex AI API مدرَج في هذه الصفحة.

إنشاء حساب خدمة

تتطلّب إضافة "مستشار العروض التقديمية" اتصالاً تمت مصادقًا عليه مع السحابة الإلكترونية. للوصول إلى Vertex AI API ونماذج Gemini. أنت تقوم بإنشاء اتصال عن طريق إنشاء حساب الخدمة في مشروعك على Google Cloud الذي يمكنه الوصول إلى Vertex AI API مستشار "العروض التقديمية من Google" يتصل مشروعك باستخدام حساب الخدمة هذا.

لإنشاء حساب خدمة لإضافة "مستشار العروض التقديمية":

  1. في وحدة تحكُّم Google Cloud، انتقِل إلى واجهات برمجة التطبيقات والخدمات الخاصة بمشروع Cloud.
  2. في الجانب الأيمن من الصفحة، اختَر بيانات الاعتماد.
  3. في أعلى الصفحة، اختَر + إنشاء بيانات الاعتماد > حساب الخدمة:
  4. في صفحة إنشاء حساب خدمة، تفاصيل حساب الخدمة أدخِل اسمًا لحساب الخدمة ورقم تعريفه ووصفًا.
  5. أنشِئ حساب الخدمة من خلال النقر على إنشاء ومتابعة.
  6. في قسم منح حساب الخدمة هذا الإذن بالوصول إلى المشروع، اختَر عنصر التحكم الدور.
  7. في الحقل فلترة، ابحث عن الخيار مستخدم Vertex AI. مجموعة الأذونات، ثم اختَر متابعة.
  8. أكمِل عملية إنشاء حساب الخدمة هذا من خلال النقر على تم.

للحصول على مزيد من المعلومات حول إنشاء حسابات الخدمة، اطلع على Google Cloud إنشاء حسابات الخدمة التوثيق.

إنشاء مفتاح حساب الخدمة وتثبيته

يجب أن يتمكّن مشروع "مستشار العروض التقديمية" من مصادقة حساب الخدمة. قمت بإنشائه في الإجراء السابق. يمكنك تفعيل هذه المصادقة من خلال إنشاء مفتاح لحساب الخدمة وضبط هذا المفتاح في "العروض التقديمية من Google" مشروع "برمجة تطبيقات مستشار" كخاصية نص برمجي الإجراء التالي تشرح كيفية إنشاء المفتاح وتهيئته في مشروعك.

لإنشاء مفتاح حساب خدمة وضبطه، اتّبِع الخطوات التالية:

  1. في وحدة تحكُّم Google Cloud، انتقِل إلى واجهات برمجة التطبيقات والخدمات مشروعك على Google Cloud
  2. في الجانب الأيمن من الصفحة، اختَر بيانات الاعتماد.
  3. في قسم حسابات الخدمة، ابحث عن حساب الخدمة الذي يمكنك إنشاء عنوان البريد الإلكتروني للحساب أو رمز القلم الرصاص لتعديله.
  4. في نافذة تعديل حساب الخدمة، بالقرب من أعلى الصفحة، اختَر عنوان علامة التبويب KEYS.
  5. في قسم المفاتيح، اختَر إضافة مفتاح > إنشاء مفتاح جديد
  6. في مربّع الحوار إنشاء مفتاح خاص لـ...، اختَر JSON ثم إنشاء: تؤدي هذه الخطوة إلى إنشاء ملف مفتاح باسم projectid-hashcode.json. وتنزيله تلقائيًا على جهاز الكمبيوتر.
  7. افتح ملف projectid-hashcode.json الذي تم تنزيله وانسخ المحتوى.
  8. افتح واجهة الويب لـ "برمجة تطبيقات Google" التي تحتوي على مستشار "العروض التقديمية من Google". مشروعه، وفي القائمة الجانبية اليمنى، اختَر طريقة عرض الإعدادات.
  9. في قسم خصائص النص البرمجي، حدد الزر تعديل النص البرمجي. خصائص النص البرمجي، ثم على الزر إضافة موقع نص برمجي.
  10. في حقل الموقع الجديد، أدخِل SERVICE_ACCOUNT_KEY، وفي القيمة، انسخ محتوى الملف الذي تم تنزيله. projectid-hashcode.json.
  11. احفظ الموقع الجديد عن طريق اختيار الزر حفظ خصائص النص البرمجي.

لمزيد من المعلومات عن إنشاء مفاتيح حساب الخدمة، يُرجى الاطّلاع على مقالة Google Cloud. إنشاء مفاتيح حساب الخدمة وحذفها التوثيق.

اختبار مشروع الإضافة

لوحة شرائح في Google Workspace مع رمز &quot;مستشار العروض التقديمية&quot; يتطلب اختبار مشروع "مستشار العروض التقديمية" إنشاء عملية نشر تجريبية. رمز الإضافة، ثم تثبيت هذا النشر التجريبي. في هذا الاختبار المشروع، سيكون المشروع متاحًا فقط في العرض التقديمي من Google. الذي بدأت فيه إضافة "برمجة تطبيقات Google" في المشروع، وفي لا توجد عروض تقديمية أخرى والعروض التقديمية. يمكنك معرفة المزيد حول نشر الإضافة لاستخدامها على نطاق أوسع في مستندات "برمجة تطبيقات Google Workspace" إنشاء عمليات النشر وإدارتها الموضوع.

لنشر رمز مشروع برمجة التطبيقات واختباره:

  1. أعلى واجهة الويب لبرمجة التطبيقات، اختَر نشر >. اختبار عمليات النشر.
  2. في مربّع الحوار اختبار عمليات النشر بجانب اختيار نوع، اختَر رمز الترس وإضافة Google Workspace.
  3. بجانب التطبيقات: عنوان "العروض التقديمية من Google"، اختَر الزر تثبيت.
  4. اترك الإعدادات التلقائية لخيار اختبار أحدث رمز واختَر تم.
  5. التنقّل في العرض التقديمي في "العروض التقديمية من Google" المرتبط ببرمجة التطبيقات المشروع وإعادة تحميل صفحة الويب.
  6. في أسفل يسار تطبيق الويب "العروض التقديمية من Google"، اختَر ( &lt;) لفتح اللوحة الجانبية، ثم انقر على رمز العين بالأبيض والأسود افتح لوحة مرشد الشرائح.

بعد إكمال هذه الخطوة وتشغيل الإضافة بنجاح، يمكنك بدء وتعديله ليستخدم إرشادات مختلفة أو يتبع سير عمل مختلف. يمكنك الاطّلاع على للحصول على إرشادات حول كيفية إجراء بعض التعديلات الأساسية على إضافة "مستشار العروض التقديمية"

تعديل سلوك المراجعة

يمكنك تغيير سلوك مراجعة مستشار الشرائح، من حيث التي تحصل عليها من Gemini API وواجهة المستخدم التي يوفّرها إضافة، عن طريق تعديل رمز مشروعها. يركز هذا البرنامج التعليمي على تغيير مطالبة إرشادات لتعديل سلوك مراجعة شرائح العرض التقديمي. بالنسبة لمزيد من المعلومات حول توسيع واجهة مستخدم "العروض التقديمية من Google" باستخدام "برمجة تطبيقات Google" الرؤية تمديد "العروض التقديمية من Google".

تغيير إرشادات المراجعة

يأتي مستشار الشرائح برمجيًا بمجموعة أساسية من إرشادات مراجعة الشرائح مع فئات البساطة، والألوان وأسلوب الخط، والبنية والمسافة البيضاء، والرسومات والأيقونات. إرشادات المراجعة هي مجرد تعليمات نصية. مضمّنة في طلب من خلال Gemini API، مع صورة لقطة الشريحة المحددة وأي ملاحظات للمحاضر.

يمكنك تغيير سلوك مراجعة الإضافة من خلال تغيير النص على التعليمات على سبيل المثال، يمكنك توجيه نموذج Gemini لإخراج مراجعة بتقييم الفئة في نفس سطر عنوان الفئة، أو تغيير اسم الفئة.

لتغيير موقع تقييم الفئة واسم الفئة:

  1. افتح واجهة الويب لـ "برمجة تطبيقات Google" التي تحتوي على مستشار "العروض التقديمية من Google". مشروعك. وإذا لزم الأمر، انتقل إلى نافذة المشروع عن طريق فتح نافذة عرض تقديمي في "العروض التقديمية من Google" يحتوي على مشروع "برمجة تطبيقات Google" مع اختيار الإضافات > برمجة التطبيقات:
  2. في القائمة الجانبية اليمنى، حدد < &gt; المحرِّر، ثم اختَر ai.gs.
  3. في ملف الرمز ai.gs، حدِّد موقع ثابت السلسلة SYSTEM_PROMPT. وعدِّل التعليمات على النحو التالي بالخط الغامق: 
    const SYSTEM_PROMPT = `
...
For each of the following categories evaluate the given slide. Score each
category on a scale of 0 to 100, show the score next to the category heading,
and concisely explain the reasoning. Do not suggest improvements if the score
is 80 or above.
  4. في ثابت سلسلة SYSTEM_PROMPT نفسه، غيِّر Simplicity نص الفئة إلى Message: 
    const SYSTEM_PROMPT = `
...
* Message -- Slides should focus on one main idea per slide and ...
  5. احفظ التغييرات في ملف الرمز ai.gs.
  6. التنقّل في العرض التقديمي في "العروض التقديمية من Google" المرتبط ببرمجة التطبيقات ثم أعد تحميل صفحة الويب واختبر التغييرات التي تم إجراؤها على الوظيفة الإضافية إعادة تشغيله.

إذا لم تكن قد أعددت سابقًا نشرًا تجريبيًا لإضافة "مستشار العروض التقديمية"، اتبع التعليمات الواردة في اختبار مشروع الإضافة:

يمكنك إزالة تعليمات فئة المراجعة أو استبدالها أو إعادة كتابتها في سلسلة SYSTEM_PROMPT ثابتة لمطابقة متطلبات المراجعة. إذا أردت لتجربة مناهج مختلفة لطلبات المراجعة أو إعادة كتابة المراجعة بأكملها يمكنك الاطّلاع على Google AI Studio على الويب التطبيق. يتيح لك هذا التطبيق إنشاء نماذج أوّلية لطلبات Gemini واختبارها وحفظها في واجهة سهلة الاستخدام، ويستخدم Gemini API نفسها التي يستخدمها "مستشار في العروض التقديمية" مشروعك. لمزيد من المعلومات عن استخدام AI Studio، يُرجى الاطّلاع على دليل البدء السريع حول AI Studio

تغيير إعدادات سلوك النموذج

توفّر Gemini API العديد من الإعدادات لتغيير التشغيل العام النموذج استجابةً لمطالبة الطلب. وعلى وجه الخصوص، ستتغيّر درجة الحرارة المحدد للنموذج تعيين مقدار الاختلاف المسموح به في النموذج استجابة، حيث يمثل الصفر أدنى قيمة و1 يمثل أعلى قيمة. ضبط هذه القيمة القيمة 0.1 ينتج عنها ردود متسقة للغاية، ولكن قد يبدو هذا السلوك متكررًا وأقل فائدة للمستخدمين الذين يتلقّون ملاحظات حول المراجعات ننصحك بتعيين أعلى من درجة الحرارة، ونضع في اعتبارك أنه كلما ارتفعت درجة الحرارة، أكثر تناسقًا يمكن أن تكون نتائجك، والتي يمكن أن تشمل تنفيذ التعليمات بشكل مختلف، وحتى تجاهل بعض التعليمات تمامًا.

لزيادة درجة حرارة الردود على المراجعات:

  1. افتح واجهة الويب لـ "برمجة تطبيقات Google" التي تحتوي على مستشار "العروض التقديمية من Google". مشروعك.
  2. في القائمة الجانبية اليمنى، حدد < &gt; المحرِّر، ثم اختَر ai.gs.

  3. في ملف الرمز ai.gs، حدِّد موقع الدالة analyzeSlides() تعديل ثابت generationConfig من خلال ضبط القيمة temperature إلى 0.3:

    function analyzeSlides(slide) {

    const generationConfig = {
        temperature: 0.3,
        maxOutputTokens: 1024 * 2,
    };

  4. احفظ التغييرات في ملف الرمز ai.gs.

  5. التنقّل في العرض التقديمي في "العروض التقديمية من Google" المرتبط ببرمجة التطبيقات ثم أعد تحميل صفحة الويب واختبر التغييرات التي تم إجراؤها على الوظيفة الإضافية إعادة تشغيله.

لمزيد من المعلومات حول إعدادات ضبط سلوك النموذج، يُرجى مراجعة Gemini وثائق واجهة برمجة التطبيقات الخاصة GenerationConfig

مراجع إضافية

لمزيد من المعلومات عن مشروع "مستشار العروض التقديمية"، يُرجى الاطّلاع على مستودع الرموز البرمجية. إذا كنت بحاجة إلى مساعدة في إنشاء التطبيق أو تريد التعاون مع مطوِّرين آخرين، يُرجى الاطّلاع على خادم Discord في منتدى Google Developers لمزيد من مشاريع "الإنشاء باستخدام الذكاء الاصطناعي من Google"، اطّلِع على قائمة تشغيل الفيديوهات.