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

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

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

לפני שמתחילים, צריך לבצע את השלבים שמפורטים במאמר בנושא התקנת התוסף.

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

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

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

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

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

  3. עוברים אל Common (משותף) > Required Permissions (הרשאות נדרשות).

    בעמודה Access מצוין אם אתם מוגדרים כחשבון ראשי בתפקיד הנדרש.

  4. כדי לקבל את ההרשאות שחסרות לכם לשימוש בתוסף Data Agent Kit ל-VS Code, אתם צריכים לבקש מהאדמין להקצות לכם את תפקידי ניהול הזהויות והרשאות הגישה (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.

בדיקת המיומנויות של הסוכן

התוסף Data Agent Kit ל-VS Code כולל מיומנויות של סוכנים שאפשר להשתמש בהן בתהליכי העבודה.

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

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

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

Orchestration Pipelines

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

קובצי Notebook

כשמנסים לבצע פעולה שדורשת את הפעולות הבאות, סביבת הפיתוח המשולבת (IDE) מבקשת את ההסכמה שלכם ואז מתקינה את התוכנה בשבילכם:

  • ‫BigQuery DataFrames (גרסה 2.36 ואילך)
  • Anywidget
  • BigQuery ML

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

פתרון בעיות

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

דיווח על בעיה

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

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

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