בחלונית השאלות בכלי לעריכת קוד ב-Earth Engine, Gemini עוזר לכם לכתוב, להבין, לנפות באגים ולבצע אופטימיזציה של הסקריפטים. הוא פועל כ-AI בממשק שיחה שמשולב ישירות ב-Code Editor, כדי לייעל את הניתוח הגיאו-מרחבי ואת פיתוח הסקריפטים.
ממשק וכלים
חלונית העוזר מבוסס-AI נמצאת בחלונית הימנית של כלי העריכה של קוד Earth Engine. כדי לפתוח אותו, לוחצים על הכרטיסייה יש לך שאלה ל-Gemini? לצד הכרטיסיות כלי הבדיקה, מסוף ומשימות.
בחלונית השאלות יש כמה אמצעי בקרה וכלים שיעזרו לכם לנהל את האינטראקציה עם ה-AI.
לחצנים ואמצעי בקרה
- שליחה / הפסקה: שולח את ההנחיה שלכם אל העוזר הדיגיטלי. במהלך היצירה, הכפתור משתנה לסמל עצירה שמאפשר לכם לבטל את הבקשה. אפשר גם להשתמש במקש
enter/returnכדי לשלוח. - שיחה חדשה: מחיקת היסטוריית השיחה והתחלת סשן חדש.
- עזרה: פותח תיבת דו-שיח עם מידע על התכונה, החיוב והתנאים.
- בחירת מודל: תפריט נפתח שמאפשר לכם לבחור באיזה מודל של Gemini להשתמש. יכול להיות שחלק מהדגמים לא יפעלו בהתאם לרמת מפתח ה-API שלכם. הבחירה שלכם תישמר לסשן הבא.
- החלפת כלים: תפריט שמאפשר להפעיל או להשבית כלים ספציפיים לשימוש של העוזר הדיגיטלי. הבחירה שלכם תישמר לסשן הבא.
- העתקה (בלוקי קוד): מעתיקה את הקוד שנוצר ללוח.
- הוספה (בלוקי קוד): מוסיפה את הקוד שנוצר לכלי לעריכת סקריפטים. אם העורך לא ריק, מוצג דו-שיח של הבדלים שמדגיש את השינויים לבדיקה.
- יצירה מחדש: בתחתית התשובה האחרונה מופיע לחצן לניסיון חוזר של ההנחיה.
- מונה טוקנים: מציג את מספר הטוקנים שנעשה בהם שימוש בסשן הנוכחי של השיחה. אפשר להשתמש בזה כדי לעקוב אחרי השימוש שלכם בהשוואה למגבלות של מפתח ה-API.
אפשרויות לכלים
אתם יכולים להפעיל את הכלים הבאים כדי לשפר את התשובות של העוזר הדיגיטלי. הערה: הפעלת כלים מוסיפה הקשר נוסף (כמו תיעוד או תוצאות חיפוש) לבקשות שלכם, ולכן עשויה להגדיל את השימוש באסימונים.
- מסמכים: חיפוש בתיעוד הציבורי של Earth Engine כדי לספק קוד והסברים מדויקים.
- חיפוש במאגרי מידע: חיפוש במאגרי מידע בקטלוג הנתונים של Earth Engine.
- חיפוש Google: התשובות מבוססות על תוצאות החיפוש ב-Google כדי לספק מידע עדכני מהאינטרנט. שימו לב: אי אפשר להשתמש בכלי של חיפוש Google בו-זמנית עם Docs או עם הכלי לחיפוש מערכי נתונים. הפעלת חיפוש Google תגרום לכך שהכלים האחרים לא יהיו זמינים בממשק המשתמש.
דרישות מוקדמות
כדי לשלוח בקשות למודל, התכונה הזו משתמשת במפתח Gemini API שלכם.
איך מקבלים מפתח Gemini API
אתם יכולים ליצור מפתחות Gemini API או לצפות בהם בפרויקט Cloud ב-Google AI Studio.
- עוברים אל מפתחות API של Google AI Studio.
- לוחצים על Create API key ובוחרים באפשרות ליצירת המפתח.
מידע נוסף על מפתחות Gemini API זמין במסמכי התיעוד של Gemini API.
הגדרת מפתח ה-API בעורך הקוד
אחרי שמקבלים את מפתח ה-API, צריך להוסיף אותו לעורך הקוד:
- בחלונית 'שאלות', לוחצים על סמל המפתח בתיבת הקלט של הצ'אט.
- מדביקים את מפתח ה-API בתיבת הדו-שיח שמופיעה.
- אופציונלי: מסמנים את התיבה כדי לשמור את המפתח להפעלות עתידיות ולוחצים על אישור.
הקשר אוטומטי
כדי לספק עזרה רלוונטית, התכונה 'יש לך שאלה?' כוללת אוטומטית את ההקשר הבא בכל בקשה:
- הטקסט המלא של הסקריפט הנוכחי בעורך.
- כל הנכסים והגיאומטריות שיובאו.
- היסטוריית הצ'אט של הסשן הנוכחי.
פתרון בעיות שגיאה במסוף
עוזר ה-AI משולב ישירות במסוף של עורך הקוד כדי לעזור לכם לפתור במהירות שגיאות בזמן ריצה:
- אם התסריט נתקל בשגיאה, מחפשים את כרטיס השגיאה האדום בכרטיסייה Console.
- לוחצים על הלחצן פתרון בעיות בכרטיס השגיאה.
- הפעולה הזו פותחת אוטומטית את החלונית 'שאלות' ומכניסה לתור הודעת הנחיה שנוצרה אוטומטית, שמכילה את הודעת השגיאה ואת ההקשר הרלוונטי מהסקריפט, כדי שתוכלו לשלוח אותה.
הנחיות לדוגמה
אתם יכולים להקליד ישירות בתיבת הצ'אט כדי לבקש מהעוזר הדיגיטלי עזרה במגוון משימות. ריכזנו כאן כמה דוגמאות לשאלות שאפשר לשאול, לפי סוג המשימה:
יצירת קוד ותהליכי עבודה
- "Write a script to load Sentinel-2 imagery for the year 2023 over East Africa, filter for cloud cover less than 10%, calculate the median NDVI, and add it to the map with a white-to-green visualization palette."
- "Create a cloud-free Landsat 9 composite for summer 2024 in Central Europe and export it to my cloud storage bucket."
אפליקציות Earth Engine
- "תכתוב קוד ליצירת מפה עם חלונית מפוצלת באפליקציית Earth Engine כדי להשוות בין תמונות משנת 2020 לבין תמונות משנת 2024 זו לצד זו".
- "תוסיף חלונית בצד ימין עם תפריט נפתח לבחירת שנה ולחצן לרענון המפה".
- "הוספת מקרא מותאם אישית למפה לסיווג של כיסוי הקרקע שמוצג".
ניפוי באגים
- "קיבלתי את השגיאה 'חריגה ממגבלת הזיכרון של המשתמש'. איך אפשר לפתור את הבעיה?"
- "במפה שלי מוצגת שכבה ללא שונות בערכי הפיקסלים. זה לא מה שציפיתי. מה הבעיה?"
- "למה אני מקבל את השגיאה 'Image.select: Band 'NDVI' not found' כשאני מריץ את החישוב הזה?"
הסבר
- "Explain what
ee.Reducer.mean().combine()is doing on line 15 of my script." - "מה ההבדל בין
ee.Image.clip()לביןee.Image.mask()?"
אופטימיזציה
- "תבצע אופטימיזציה לפעולת המיפוי של אוסף התמונות הזה כדי שהיא תפעל בצורה יעילה יותר?"
- "איך אפשר לשכתב את הפעולה
reduceRegionsעל פני הרבה מצולעים ותמונות כדי למנוע פסק זמן?"
חיובים ועלויות
כדי להשתמש בתכונה הזו, צריך מפתח API משלכם ל-Gemini. העלויות כפופות לתמחור של Gemini API ולרמת המכסה של המפתח שלכם.
- Free Tier: Gemini API מציע תוכנית בחינם (עם מגבלות).
- רמת שירות בתשלום: אם משתמשים במפתח API של רמת שירות בתשלום, יחויבו על השימוש בו בלי קשר לרישום הספציפי של הפרויקט ב-Earth Engine.
פרטים נוספים זמינים במאמר תמחור Gemini API.
מעקב אחרי השימוש ובקרה של העלויות
אתם יכולים לנהל מפתחות ולראות את השימוש והעלויות ישירות ב-AI Studio.
- בממשק של AI Studio אפשר לבדוק את הרמה, השימוש, המכסות וההוצאות של מפתח ה-API.
- בכרטיסייה 'הוצאות' ב-AI Studio, מגדירים תקרת הוצאות חודשית.
נתונים ופרטיות
הנתונים שלכם מנוהלים בהתאם לתנאים ולהגבלות של Gemini API. חשוב לעיין בהם כדי להבין איך להשתמש בהנחיות ובתוכן שנוצר.
משוב
נשמח לעזרתך כדי שנוכל להשתפר! אפשר ללחוץ על לחצן המשוב בפינה השמאלית העליונה של כלי עריכת הקוד כדי לשלוח משוב בכל שלב. משתמשים באפשרות שליחת משוב על Code Editor. אנחנו קוראים את המשוב הזה כדי לשפר את ביצועי המודל ולתעדף תכונות.