پنل «پرسش» در ویرایشگر کد Earth Engine از Gemini برای کمک به شما در نوشتن، درک، اشکالزدایی و بهینهسازی اسکریپتهایتان استفاده میکند. این ابزار به عنوان یک دستیار هوش مصنوعی محاورهای که مستقیماً در ویرایشگر کد ادغام شده است، عمل میکند تا تجزیه و تحلیل جغرافیایی و توسعه اسکریپت شما را ساده کند.
رابط کاربری و ابزارها
پنل دستیار هوش مصنوعی در پنل سمت راست ویرایشگر کد Earth Engine قرار دارد. برای باز کردن آن، روی تب Ask در کنار تبهای Inspector ، Console و Tasks کلیک کنید.
پنل «پرسش» شامل چندین کنترل و ابزار است که به شما در مدیریت تعامل با هوش مصنوعی کمک میکند.
دکمهها و کنترلها
- ارسال / توقف : درخواست شما را به دستیار ارسال میکند. این دکمه در حین تولید، به یک نماد توقف تبدیل میشود که به شما امکان میدهد درخواست را لغو کنید. همچنین میتوانید از کلید
enter/returnبرای ارسال استفاده کنید. - گفتگوی جدید : تاریخچه گفتگو را پاک میکند و یک جلسه جدید را آغاز میکند.
- راهنما : پنجرهای حاوی اطلاعات مربوط به ویژگی، صورتحساب و شرایط را باز میکند.
- انتخاب مدل : یک منوی کشویی که به شما امکان میدهد مدل Gemini مورد استفاده را انتخاب کنید. بسته به سطح کلید API شما، ممکن است برخی از مدلها کار نکنند. انتخاب شما برای جلسه بعدی ذخیره خواهد شد.
- تنظیمات ابزار : منویی که به شما امکان میدهد ابزارهای خاصی را برای استفاده دستیار فعال یا غیرفعال کنید. انتخاب شما برای جلسه بعدی ذخیره میشود.
- کپی (بلوکهای کد) : کد تولید شده را در کلیپبورد شما کپی میکند.
- درج (بلوکهای کد) : کد تولید شده را در ویرایشگر اسکریپت شما وارد میکند. اگر ویرایشگر خالی نباشد، یک کادر محاورهای تفاوت را نشان میدهد که تغییرات را برای بررسی شما برجسته میکند.
- بازسازی : یک دکمهی «امتحان مجدد» در پایین آخرین پاسخ ظاهر میشود تا اعلان را دوباره اجرا کند.
- شمارنده توکن : تعداد توکنهای استفاده شده در جلسه مکالمه فعلی را نمایش میدهد. از این برای نظارت بر میزان استفاده خود در مقایسه با محدودیتهای کلید API خود استفاده کنید.
گزینههای ابزار
شما میتوانید ابزارهای زیر را برای بهبود پاسخهای دستیار فعال کنید. توجه داشته باشید که فعال کردن ابزارها، زمینههای اضافی (مانند مستندات یا نتایج جستجو) را به درخواستهای شما اضافه میکند که ممکن است منجر به استفاده بیشتر از توکن شود.
- اسناد : جستجو در اسناد عمومی Earth Engine برای ارائه کد و توضیحات دقیق.
- جستجوی مجموعه دادهها : مجموعه دادهها را در کاتالوگ دادههای موتور زمین جستجو میکند.
- جستجوی گوگل : پاسخهای موجود در نتایج جستجوی گوگل را برای ارائه اطلاعات بهروز از وب، بررسی میکند. توجه داشته باشید که ابزار جستجوی گوگل را نمیتوان همزمان با ابزار جستجوی Docs یا Dataset استفاده کرد. فعال کردن جستجوی گوگل بهطور خودکار سایر ابزارها را در رابط کاربری غیرفعال میکند.
پیشنیازها
برای ارسال درخواست به مدل، این ویژگی از کلید API Gemini شما استفاده میکند.
نحوه دریافت کلید API جمینی
شما میتوانید کلیدهای API مربوط به Gemini را در زیر پروژه ابری خود در Google AI Studio ایجاد یا مشاهده کنید.
- به کلیدهای API استودیوی هوش مصنوعی گوگل بروید.
- روی ایجاد کلید API کلیک کنید و گزینهای را برای ایجاد کلید خود انتخاب کنید.
برای اطلاعات بیشتر در مورد کلیدهای API Gemini، به مستندات کلید API Gemini مراجعه کنید.
کلید API خود را در ویرایشگر کد پیکربندی کنید
وقتی کلید API خود را دریافت کردید، باید آن را به ویرایشگر کد اضافه کنید:
- در پنل «پرسش»، روی نماد کلید در کادر ورودی چت کلیک کنید.
- کلید API خود را در کادر محاورهای که ظاهر میشود، جایگذاری کنید.
- در صورت تمایل، کادر را علامت بزنید تا کلید برای جلسات آینده ذخیره شود و روی تأیید کلیک کنید.
زمینه خودکار
برای ارائه کمکهای مرتبط، ویژگی «پرسش» بهطور خودکار متن زیر را با هر درخواستی درج میکند:
- متن کامل اسکریپت فعلی شما در ویرایشگر.
- هرگونه دارایی و هندسه وارداتی.
- تاریخچه چت جلسه فعلی.
عیب یابی خطاهای کنسول
دستیار هوش مصنوعی مستقیماً با کنسول ویرایشگر کد یکپارچه شده است تا به شما در حل سریع خطاهای زمان اجرا کمک کند:
- اگر اسکریپت شما با خطایی مواجه شد، در تب Console به دنبال کارت خطای قرمز رنگ بگردید.
- روی دکمه عیبیابی روی کارت خطا کلیک کنید.
- این به طور خودکار پنل «پرسش» را باز میکند و یک پیام فوری خودکار تولید شده حاوی پیام خطا و متن مربوطه از اسکریپت شما را برای ارسال شما در صف قرار میدهد.
مثالهای پیشنهادی
شما میتوانید با تایپ مستقیم در کادر چت، از دستیار بخواهید در انجام کارهای مختلفی به شما کمک کند. در اینجا چند نمونه از آنچه میتوانید بپرسید، بر اساس وظیفه دستهبندی شده است:
تولید کد و گردش کار
- «اسکریپتی بنویسید که تصاویر Sentinel-2 را برای سال ۲۰۲۳ در شرق آفریقا بارگذاری کند، پوشش ابری کمتر از ۱۰٪ را فیلتر کند، میانگین NDVI را محاسبه کند و آن را با یک پالت تجسم سفید به سبز به نقشه اضافه کند.»
- «یک ترکیب بدون ابر از تصاویر لندست ۹ برای تابستان ۲۰۲۴ در اروپای مرکزی ایجاد کنید و آن را به فضای ذخیرهسازی ابری من منتقل کنید.»
برنامههای موتور زمین
- «کدی بنویسید که یک نقشه دوبخشی از برنامه Earth Engine ایجاد کند تا تصاویر سالهای ۲۰۲۰ و ۲۰۲۴ را در کنار هم مقایسه کند.»
- «یک پنل در سمت چپ با یک منوی کشویی برای انتخاب سال و یک دکمه برای بهروزرسانی نقشه اضافه کنید.»
- «برای طبقهبندی پوشش زمین نمایش داده شده، یک راهنمای سفارشی به نقشه اضافه کنید.»
اشکالزدایی
- «من با خطای «محدودیت حافظه کاربر بیش از حد مجاز است» مواجه میشوم. چگونه میتوانم این مشکل را حل کنم؟»
- «نقشه من لایهای را نشان میدهد که هیچ واریانسی در مقادیر پیکسلها ندارد، این چیزی نیست که انتظار داشتم، چه مشکلی پیش آمده؟»
- «چرا هنگام اجرای این محاسبه با خطای 'Image.select: Band 'NDVI' not found' مواجه میشوم؟»
توضیح
- «توضیح دهید که تابع
ee.Reducer.mean().combine()در خط ۱۵ اسکریپت من چه کاری انجام میدهد.» - «تفاوت بین
ee.Image.clip()وee.Image.mask()چیست؟»
بهینهسازی
- «آیا میتوانید عملیات نقشه مجموعه تصاویر را برای اجرای کارآمدتر بهینه کنید؟»
- «چگونه میتوانم این عملیات
reduceRegionsرا روی چندضلعیها و تصاویر زیادی بازنویسی کنم تا از وقفه زمانی جلوگیری شود؟»
صورتحساب و هزینهها
استفاده از این ویژگی نیاز به کلید API Gemini شما دارد. هزینهها تابع قیمتگذاری API Gemini و سطح سهمیه کلید شما هستند.
- سطح رایگان : رابط برنامهنویسی نرمافزار Gemini یک سطح رایگان (با محدودیتهایی) ارائه میدهد.
- سطح پولی : اگر از کلید API سطح پولی استفاده کنید، صرف نظر از ثبت پروژه خاص Earth Engine شما، هزینهای برای آن دریافت خواهد شد.
برای جزئیات بیشتر، به قیمتگذاری API Gemini مراجعه کنید.
نظارت بر میزان مصرف و کنترل هزینهها
شما میتوانید کلیدها را مدیریت کنید و میزان استفاده و هزینهها را مستقیماً در AI Studio مشاهده کنید.
- سطح، میزان استفاده، محدودیتها و هزینههای کلید API خود را در رابط کاربری AI Studio بررسی کنید.
- در تب Spend در AI Studio، سقف هزینه ماهانه را تعیین کنید.
دادهها و حریم خصوصی
دادههای شما مطابق با شرایط خدمات Gemini API مدیریت میشوند. حتماً آنها را در مورد استفاده از اعلانها و محتوای تولید شده بررسی کنید.
بازخورد
به ما در بهبود کمک کنید! بازخورد خود را در هر زمان با کلیک بر روی دکمه بازخورد در گوشه سمت راست بالای ویرایشگر کد به اشتراک بگذارید. از گزینه ارسال بازخورد ویرایشگر کد استفاده کنید. ما به طور فعال این بازخوردها را میخوانیم تا عملکرد مدل را بهبود بخشیم و ویژگیها را اولویتبندی کنیم.