تستخدِم لوحة "اسأل" في "محرّر رموز Earth Engine" نموذج Gemini لمساعدتك في كتابة النصوص البرمجية وفهمها وتصحيح أخطائها وتحسينها. وهي تعمل كمساعد محادثة مستنِد إلى الذكاء الاصطناعي ومدمَج مباشرةً في "محرّر الرموز" لتبسيط عملية تحليل البيانات الجغرافية المكانية وتطوير النصوص البرمجية.
الواجهة والأدوات
تقع لوحة المساعد المستنِد إلى الذكاء الاصطناعي في الجزء الأيمن من "محرّر رموز Earth Engine". لفتحها، انقر على علامة التبويب اسأل بجانب علامات التبويب أداة الفحص، وحدة التحكّم والمهام.
تتضمّن لوحة "اسأل" العديد من عناصر التحكّم والأدوات التي تساعدك في إدارة تفاعلك مع الذكاء الاصطناعي.
الأزرار وعناصر التحكّم
- إرسال / إيقاف: يرسِل طلبك إلى المساعد. يتحوّل الزر إلى رمز إيقاف أثناء عملية الإنشاء، ما يتيح لك إلغاء الطلب. يمكنك أيضًا استخدام المفتاح
enter/returnللإرسال. - محادثة جديدة: يمحو سجلّ المحادثات ويبدأ جلسة جديدة.
- مساعدة: يفتح مربّع حوار يتضمّن معلومات عن الميزة والفوترة و الشروط.
- اختيار النموذج: قائمة منسدلة تتيح لك اختيار نموذج Gemini الذي تريد استخدامه. قد لا تعمل بعض النماذج استنادًا إلى مستوى مفتاح واجهة برمجة التطبيقات. سيتم حفظ اختيارك للجلسة التالية.
- أزرار تبديل الأدوات: قائمة تتيح لك تفعيل أدوات معيّنة أو إيقافها ليستخدمها المساعد. سيتم حفظ اختيارك للجلسة التالية.
- نسخ (مجموعات الرموز): ينسخ الرمز الذي تم إنشاؤه إلى الحافظة.
- إدراج (مجموعات الرموز): يُدرِج الرمز الذي تم إنشاؤه في محرّر النصوص البرمجية. إذا لم يكن المحرّر فارغًا، سيظهر مربّع حوار يعرض الاختلافات ويبرز التغييرات لتتمكّن من مراجعتها.
- إعادة الإنشاء: يظهر زر إعادة المحاولة في أسفل الردّ الأخير لـ إعادة تشغيل الطلب.
- عداد الرموز: يعرض عدد الرموز المستخدَمة في جلسة المحادثة الحالية. يمكنك استخدام هذا العداد لمراقبة استخدامك مقارنةً بحدود مفتاح واجهة برمجة التطبيقات.
خيارات الأداة
يمكنك تفعيل الأدوات التالية لتحسين ردود المساعد. يُرجى العِلم أنّ تفعيل الأدوات يضيف سياقًا إضافيًا (مثل المستندات أو نتائج البحث) إلى طلباتك، ما قد يؤدي إلى زيادة استخدام الرموز.
- المستندات: يبحث في المستندات العلنية الخاصة بـ Earth Engine لتقديم رموز وتفسيرات دقيقة.
- بحث مجموعة البيانات: يبحث عن مجموعات البيانات في كتالوج بيانات Earth Engine.
- بحث Google: يستند إلى نتائج "بحث Google" لتقديم معلومات حديثة من الويب. يُرجى العِلم أنّه لا يمكن استخدام أداة "بحث Google" في الوقت نفسه مع أداة "المستندات" أو أداة "بحث مجموعة البيانات". سيؤدي تفعيل "بحث Google" تلقائيًا إلى عدم توفّر الأدوات الأخرى في واجهة المستخدم.
المتطلبات الأساسية
لإرسال طلبات إلى النموذج، تستخدِم هذه الميزة مفتاح Gemini API الخاص بك.
كيفية الحصول على مفتاح Gemini API
يمكنك إنشاء مفاتيح Gemini API أو عرضها ضمن مشروعك على السحابة الإلكترونية في Google AI Studio.
- انتقِل إلى مفاتيح واجهة برمجة التطبيقات في Google AI Studio.
- انقر على إنشاء مفتاح واجهة برمجة التطبيقات واختَر خيارًا لإنشاء مفتاحك.
لمزيد من المعلومات عن مفاتيح Gemini API، يُرجى الاطّلاع على مستندات مفتاح Gemini API.
إعداد مفتاح واجهة برمجة التطبيقات في "محرّر الرموز"
بعد الحصول على مفتاح واجهة برمجة التطبيقات، عليك إضافته إلى "محرّر الرموز":
- في لوحة "اسأل"، انقر على رمز المفتاح في مربّع إدخال المحادثة.
- ألصِق مفتاح واجهة برمجة التطبيقات في مربّع الحوار الذي يظهر.
- يمكنك اختياريًا وضع علامة في المربّع لحفظ المفتاح للجلسات المستقبلية والنقر على حسنًا.
السياق التلقائي
لتقديم مساعدة ذات صلة، تتضمّن ميزة "اسأل" تلقائيًا السياق التالي مع كل طلب:
- النص الكامل للنص البرمجي الحالي في المحرّر
- أي مواد عرض وأشكال هندسية مستورَدة
- سجلّ المحادثات للجلسة الحالية
تحديد مشاكل أخطاء وحدة التحكّم وحلّها
تم دمج المساعد المستنِد إلى الذكاء الاصطناعي مباشرةً مع وحدة تحكّم "محرّر الرموز" لمساعدتك في حلّ أخطاء وقت التشغيل بسرعة:
- إذا واجه النص البرمجي خطأً، ابحث عن بطاقة الخطأ الحمراء في علامة التبويب وحدة التحكّم.
- انقر على الزر تحديد المشاكل وحلّها في بطاقة الخطأ.
- يؤدي هذا الإجراء تلقائيًا إلى فتح لوحة "اسأل" ووضع رسالة طلب تم إنشاؤها تلقائيًا في قائمة الانتظار، تحتوي على رسالة الخطأ والسياق ذي الصلة من النص البرمجي لتتمكّن من إرسالها.
أمثلة على الطلبات
يمكنك أن تطلب من المساعد المساعدة في مجموعة متنوّعة من المهام عن طريق الكتابة مباشرةً في مربّع المحادثة. في ما يلي بعض الأمثلة على ما يمكنك طلبه، مصنّفة حسب المهمة:
إنشاء الرموز البرمجية ومهام سير العمل
- "اكتب نصًا برمجيًا لتحميل صور Sentinel-2 لعام 2023 فوق شرق أفريقيا، وفلترة الصور التي تقل فيها نسبة الغطاء السحابي عن %10، وحساب متوسط مؤشر NDVI، وإضافته إلى الخريطة باستخدام لوحة عرض مرئي تتدرّج من الأبيض إلى الأخضر".
- "أنشئ صورة مركّبة خالية من السحب من Landsat 9 لفصل الصيف في عام 2024 في وسط أوروبا، وصدِّرها إلى حزمة التخزين على السحابة الإلكترونية".
تطبيقات Earth Engine
- "اكتب رمزًا لإنشاء خريطة لوحة مقسّمة في تطبيق Earth Engine لمقارنة الصور من عامَي 2020 و2024 جنبًا إلى جنب".
- "أضِف لوحة على الجانب الأيسر تتضمّن قائمة منسدلة لاختيار عام وزرًا لإعادة تحميل الخريطة".
- "أضِف وسيلة إيضاح مخصّصة إلى الخريطة لتصنيف الغطاء الأرضي المعروض".
تصحيح الأخطاء
- "تظهر لي رسالة الخطأ "تم تجاوز الحدّ الأقصى لذاكرة المستخدم". كيف يمكنني حلّ هذه المشكلة؟"
- "تعرض خريطتي طبقة بدون أي تباين في قيم وحدات البكسل، وهذا ليس ما توقّعته. ما المشكلة؟"
- "لماذا تظهر لي رسالة الخطأ "Image.select: Band 'NDVI' not found" عند تشغيل هذه العملية الحسابية؟"
الشرح
- "اشرح ما يفعله الرمز
ee.Reducer.mean().combine()في السطر 15 من النص البرمجي". - "ما هو الفرق بين
ee.Image.clip()وee.Image.mask()؟"
تحسين
- "هل يمكنك تحسين عملية الخريطة لمجموعة الصور هذه لتشغيلها بكفاءة أكبر؟"
- "كيف يمكنني إعادة كتابة عملية
reduceRegionsهذه على العديد من المضلّعات والصور لتجنُّب انتهاء المهلة؟"
الفوترة والتكاليف
يتطلّب استخدام هذه الميزة مفتاح Gemini API الخاص بك. تخضع التكاليف لتسعير Gemini API ومستوى الحصة المخصّصة لمفتاحك.
- المستوى المجاني: يقدّم Gemini API مستوى مجانيًا (مع حدود).
- المستوى المدفوع: إذا كنت تستخدِم مفتاح واجهة برمجة تطبيقات على مستوى مدفوع، سيتم تحصيل رسوم بغض النظر عن تسجيل مشروعك المحدّد على Earth Engine.
لمزيد من التفاصيل، يُرجى الاطّلاع على تسعير Gemini API.
مراقبة الاستخدام والتحكّم في التكاليف
يمكنك إدارة المفاتيح وعرض الاستخدام والتكاليف مباشرةً في AI Studio.
- اطّلِع على مستوى مفتاح واجهة برمجة التطبيقات والاستخدام والحدود والإنفاق في واجهة AI Studio.
- اضبط حدًا أقصى للإنفاق الشهري في علامة التبويب "الإنفاق" في AI Studio.
البيانات والخصوصية
تتم معالجة بياناتك وفقًا لـ بنود الخدمة في Gemini API. يُرجى مراجعتها بعناية لمعرفة المزيد عن استخدام الطلبات والمحتوى الذي تم إنشاؤه.
الملاحظات
نرحّب بأي مساعدة لتحسين خدماتنا. يمكنك مشاركة ملاحظاتك في أي وقت بالنقر على زر الملاحظات في أعلى يسار "محرّر الرموز". استخدِم خيار إرسال ملاحظات عن "محرّر الرموز". نقرأ هذه الملاحظات بفعالية لتحسين أداء النموذج وتحديد أولويات الميزات.