اطّلِع على دليل Gemini API الجديد والمنتدى الخاص بنا.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

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

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

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

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

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

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

لإنشاء مشروع جديد لبرمجة التطبيقات:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

انتقِل إلى مستودع رموز المشروع لملف بيان المشروع، appsscript.json
انسخ محتوى ملف الرمز هذا إلى الحافظة.
انتقِل مرّة أخرى إلى واجهة الويب لـ "برمجة تطبيقات Google"، واختَر اسم الملف appsscript.json، ثم الصِق الرمز في لوحة محرّر الرموز، مع استبدال أي رمز سابق.
كرِّر هذا الإجراء لملفات التعليمات البرمجية الأربعة الأخرى:
- انسخ التعليمة البرمجية لـ main.js إلى ملف main.gs.
- انسخ رمز ui.js إلى ملف ui.gs.
- انسخ رمز slides.js إلى ملف slides.gs.
- انسخ رمز ai.js إلى ملف ai.gs.

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

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

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

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

لإعداد مشروع على السحابة الإلكترونية مع إمكانية الوصول إلى Vertex AI API:

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

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

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

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

في Google Cloud Console، انتقِل إلى صفحة واجهات برمجة التطبيقات والخدمات الخاصة بمشروعك على Google Cloud.
على يمين الصفحة، اختَر بيانات الاعتماد.
في أعلى الصفحة، اختَر + إنشاء شهادات > حساب الخدمة.
في صفحة إنشاء حساب خدمة، قسم تفاصيل حساب الخدمة، أدخِل اسم حساب الخدمة ورقم تعريفه ووصفه.
أنشِئ حساب الخدمة عن طريق اختيار إنشاء ومتابعة.
في قسم منح حساب الخدمة هذا الإذن بالوصول إلى المشروع، اختَر عنصر التحكّم الدور.
في حقل الفلتر، ابحث عن مجموعة أذونات مستخدم Vertex AI، ثم انقر على متابعة.
أكمِل عملية إنشاء حساب الخدمة هذا من خلال اختيار تمّ.

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

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

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

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

في Google Cloud Console، انتقِل إلى صفحة واجهات برمجة التطبيقات والخدمات لمشروعك على Google Cloud.
على يمين الصفحة، اختَر بيانات الاعتماد.
في القسم حسابات الخدمة، ابحث عن حساب الخدمة الذي أنشأته، واختَر عنوان البريد الإلكتروني للحساب أو رمز القلم الرصاص لتعديله.
في نافذة تعديل حساب الخدمة، بالقرب من أعلى الصفحة، انقر على عنوان علامة التبويب المفاتيح.
في قسم المفاتيح، اختَر إضافة مفتاح > إنشاء مفتاح جديد.
في مربّع الحوار إنشاء مفتاح خاص لـ...، اختَر JSON ثم إنشاء. تؤدّي هذه الخطوة إلى إنشاء ملف رئيسي باسم projectid-hashcode.json وتنزيله تلقائيًا على جهاز الكمبيوتر.
افتح ملف projectid-hashcode.json الذي تمّ تنزيله وانسخ المحتوى.
افتح واجهة الويب لـ "برمجة التطبيقات" التي تحتوي على مشروع مرشد العروض التقديمية، وفي القائمة الجانبية اليمنى، اختَر عرض الإعدادات.
في قسم خصائص النص البرمجي، حدّد الزر تعديل خصائص النص البرمجي، ثم الزر إضافة موقع نص برمجي.
في حقل الموقع الجديد، أدخِل SERVICE_ACCOUNT_KEY، وفي حقل القيمة، انسخ محتوى ملف projectid-hashcode.json الذي تم تنزيله.
احفظ الموقع الجديد عن طريق اختيار الزر حفظ مواقع النص البرمجي.

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

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

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

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

في أعلى واجهة الويب لـ "برمجة تطبيقات Google"، اختَر نشر > عمليات نشر الاختبار.
في مربّع الحوار اختبار عمليات النشر، بجانب اختيار نوع، اختَر رمز الترس وإضافة Google Workspace.
بجانب عنوان التطبيقات: العروض التقديمية، اختَر الزر تثبيت.
اترك الإعدادات التلقائية لـ اختبار أحدث رمز وانقر على تم.
يمكنك التنقّل في العرض التقديمي من "العروض التقديمية من Google" المرتبط بمشروع "برمجة تطبيقات Google" وإعادة تحميل صفحة الويب.
في أسفل يسار تطبيق "العروض التقديمية من Google" على الويب، اختَر الرمز ( < ) لفتح اللوحة الجانبية، ثم اختَر رمز العينين بالأبيض والأسود لفتح لوحة مستشار العروض التقديمية.

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

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

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

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

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

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

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

افتح واجهة الويب لـ "برمجة تطبيقات Google" التي تحتوي على مشروع مستشار العروض التقديمية الخاص بي. إذا لزم الأمر، انتقل إلى نافذة المشروع عن طريق فتح العرض التقديمي من Google الذي يحتوي على مشروع برمجة التطبيقات واختيار الإضافات > برمجة التطبيقات.
من القائمة الجانبية اليمنى، اختَر طريقة عرض < > المحرّر، ثم اختَر اسم الملف ai.gs.

في ملف الترميز 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.

في ثابت سلسلة SYSTEM_PROMPT نفسه، غيِّر نص الفئة Simplicity إلى Message:

const SYSTEM_PROMPT = `
...
* Message -- Slides should focus on one main idea per slide and ...

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

إذا لم يسبق لك إعداد نشر تجريبي للإضافة "مستشار العروض التقديمية من Google"، اتّبِع التعليمات الواردة في اختبار مشروع الإضافة.

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

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

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

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

افتح واجهة الويب لـ "برمجة تطبيقات Google" التي تحتوي على مشروع مستشار العروض التقديمية الخاص بي.
من القائمة الجانبية اليمنى، اختَر طريقة عرض < > المحرّر، ثم اختَر اسم الملف ai.gs.
في ملف الترميز ai.gs، حدِّد موقع الدالة analyzeSlides() وعدِّل الثابت generationConfig من خلال ضبط القيمة temperature على 0.3:
```
function analyzeSlides(slide) {

    const generationConfig = {
        temperature: 0.3,
        maxOutputTokens: 1024 * 2,
    };
```
احفظ التغييرات في ملف رمز ai.gs.
يمكنك التنقّل في العرض التقديمي من "العروض التقديمية من Google" المرتبط بمشروع برمجة التطبيقات وإعادة تحميل صفحة الويب واختبار التغييرات التي تم إجراؤها على الإضافة من خلال إعادة تشغيلها.

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

مراجع إضافية

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