הגדרה וקביעת הגדרות

במאמר הזה מוסבר איך להגדיר הגדרות ראשוניות אחרי שמתקינים את התוסף Google Cloud Data Agent Kit IDE.

לפני שמתחילים

לפני שמתחילים, צריך לבצע את השלבים במאמר בנושא התקנת Data Agent Kit, כולל בחירת השירותים שרוצים להשתמש בהם. בקטעים בתפריט של Google Cloud Data Agent Kit שמתייחסים לשירותים שלא בחרתם, מוצגת ההודעה integration is not enabled עד שתבחרו אותם.

הגדרת Google Cloud הפרויקט והאזור

אם עדיין לא הגדרתם את הפרויקט והאזור, אתם יכולים לעשות זאת על ידי ביצוע השלבים הבאים.

  1. כדי לפתוח את עורך ההגדרות של Data Cloud, לוחצים על הסמל Google Cloud Data Agent Kit בסרגל הפעילות.
  2. מרחיבים את הגדרות ולוחצים על הגדרות.
  3. לוחצים על נפוץ.
  4. בוחרים את מזהה הפרויקט ואת האזור. מזהה הפרויקט צריך להיות זהה למזהה הפרויקט שציינתם ב-CLI של gcloud.
  5. לוחצים על Save.

בדיקת התפקידים הנדרשים

כשבוחרים את השירותים שרוצים להשתמש בהם, Data Agent Kit בודק את התפקידים שלכם בניהול זהויות והרשאות גישה (IAM).

  1. כדי לפתוח את עורך ההגדרות של Data Cloud, לוחצים על הסמל Google Cloud Data Agent Kit בסרגל הפעילות.
  2. מרחיבים את הגדרות ולוחצים על הגדרות.
  3. לוחצים על Service Integrations (שילובים של שירותים).

  4. בוחרים את השירותים שרוצים להשתמש בהם ולוחצים על הבא.

    אם חסרים לכם תפקידים או ממשקי API נדרשים, ייפתח הדף Missing permissions (הרשאות חסרות). הרשימה כוללת את הרשאות ה-IAM המומלצות לכל שירות נבחר ואת ממשקי ה-API שצריך להפעיל.

  5. כדי לקבל את ההרשאות שחסרות לכם לשימוש ב-Data Agent Kit, לוחצים על רשימת אימייל כדי לשלוח את הרשימה לאדמין, או על העתקת רשימה. צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM המתאימים בפרויקט. מידע נוסף על הקצאת תפקידים מופיע במאמר ניהול הגישה לפרויקטים, לתיקיות ולארגונים.

הגדרת האזור ב-BigQuery

  1. כדי לפתוח את עורך ההגדרות של Data Cloud, לוחצים על הסמל Google Cloud Data Agent Kit בסרגל הפעילות.
  2. מרחיבים את הגדרות ולוחצים על הגדרות.
  3. בוחרים באפשרות BigQuery.
  4. בוחרים אזור ב-BigQuery.
  5. לוחצים על Save.

צפייה בסביבות זמן ריצה ללא שרת (serverless) ל-Apache Spark

  1. כדי לפתוח את עורך ההגדרות של Data Cloud, לוחצים על הסמל Google Cloud Data Agent Kit בסרגל הפעילות.
  2. מרחיבים את הגדרות ולוחצים על הגדרות.
  3. בוחרים באפשרות Apache Spark. מוצגות כל סביבות זמן הריצה ללא שרתים של הפרויקט.
  4. כדי לראות את ההגדרות של סביבת זמן ריצה בלי שרת (serverless), לוחצים על השם שלה.

יצירת סביבת ריצה ללא שרת (serverless) ל-Apache Spark

  1. כדי לפתוח את עורך ההגדרות של Data Cloud, לוחצים על הסמל Google Cloud Data Agent Kit בסרגל הפעילות.
  2. מרחיבים את הגדרות ולוחצים על הגדרות.
  3. בוחרים באפשרות Apache Spark.
  4. לוחצים על יצירה.
  5. ממלאים את השדות ולוחצים על שמירה.

מחיקה של סביבת ריצה Serverless ל-Apache Spark

  1. כדי לפתוח את עורך ההגדרות של Data Cloud, לוחצים על הסמל Google Cloud Data Agent Kit בסרגל הפעילות.
  2. מרחיבים את הגדרות ולוחצים על הגדרות.
  3. בוחרים באפשרות Apache Spark.
  4. לצד זמן הריצה ללא שרת שרוצים למחוק, לוחצים על מחיקה.

הגדרת הכלי לתזמון

  1. כדי לפתוח את עורך ההגדרות של Google Cloud Data Agent Kit, לוחצים על הסמל Google Cloud Data Agent Kit בסרגל הפעילות.
  2. מרחיבים את הגדרות ולוחצים על הגדרות.
  3. לוחצים על כלי התזמון.
  4. בוחרים פרויקט ואזור. הפרויקט והאזור לא צריכים להיות זהים לפרויקט ולאזור שבחרתם בכרטיסייה 'כללי'.
  5. בוחרים סביבה של Managed Service for Apache Airflow כדי להגדיר תהליכי עבודה.
  6. לוחצים על Save.

התקנת יחסי תלות

חלק מהפעולות ב-Google Cloud Data Agent Kit מחייבות התקנה של תוכנה נוספת אחרי התקנת התוסף. במקרים מסוימים, תתבקשו להביע הסכמה להתקנה אוטומטית. במקרים אחרים, צריך להתקין את התוכנה באופן ידני.

Orchestration Pipelines

כדי לעבוד עם Orchestration Pipelines ב-IDE, צריך להתקין את הרכיבים הבאים:

קובצי Notebook

הנוטבוקים שנוצרים על ידי Google Cloud Data Agent Kit כוללים תא %pip install --upgrade bigframes עם הערה. אם BigQuery DataFrames לא מותקן בגרעין, מבטלים את ההערה ומריצים את התא הזה לפני שמריצים את שאר ה-Notebook.

כדי לאפשר לסוכן להריץ תאי קוד במחברות, אפשר להפעיל את ההגדרה google.datacloud.executeCellToolForNotebookMCP בהגדרות של סביבת הפיתוח המשולבת. ההגדרה הזו מפעילה את הכלי execute_cell עבור Notebook Model Context Protocol‏ (MCP).

פתרון בעיות

אם נתקלתם בבעיות, נסו לצאת מ-Google Cloud Data Agent Kit ומ-CLI של gcloud ואז להיכנס שוב. כדי למצוא שיטות נוספות לאבחון ולפתרון של שגיאות בהגדרה, אפשר לעיין במאמר פתרון בעיות ב-Data Agent Kit.

דיווח על בעיה

כדי לדווח על בעיה:

  1. בתפריט Google Cloud Data Agent Kit בסרגל הפעילות, לוחצים על Report bug (דיווח על באג).
  2. בטופס שנפתח, מתעדים את הבעיה ולוחצים על שליחה.

המאמרים הבאים