גישה לקטגוריות ולקבצים ב-Cloud Storage במופע של סביבת עבודה של Agent Platform ב-JupyterLab.

בדף הזה מוסבר איך לטעון קטגוריה של Cloud Storage לממשק JupyterLab של מופע Gemini Enterprise Agent Platform Workbench, כדי שתוכלו לעיין בקבצים שמאוחסנים ב-Cloud Storage. אפשר גם לפתוח ולערוך קבצים שתואמים ל-JupyterLab, כמו קובצי טקסט וקובצי מחברת (IPYNB).

סקירה כללית

מופעים של Agent Platform Workbench כוללים שילוב של Cloud Storage שמאפשר לכם לטעון קטגוריה של Cloud Storage. המשמעות היא שאתם יכולים לעיין בתוכן של מאגר המידע ולעבוד עם קבצים תואמים מתוך הממשק של JupyterLab.

אתם יכולים לגשת לכל הקטגוריות והקבצים של Cloud Storage שהמופע שלכם יכול לגשת אליהם באותו פרויקט כמו המופע של Agent Platform Workbench.

הערה: הגישה שלכם ל-Cloud Storage מתוך המופע של Agent Platform Workbench נקבעת לפי המשתמש היחיד או חשבון השירות שדרכם הענקתם גישה למופע. לדוגמה, אם הענקתם לחשבון שירות ספציפי גישה למופע שלכם, אתם צריכים להעניק לחשבון השירות הזה גם גישה לקטגוריות של Cloud Storage שבהן אתם רוצים להשתמש ב-JupyterLab.

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

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

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Notebooks API.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Notebooks API.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

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

כדי לקבל את ההרשאות שדרושות בשביל לטעון קטגוריה של Cloud Storage למופע של Agent Platform Workbench, אתם צריכים לבקש מהאדמין לתת לכם את התפקידים הבאים ב-IAM:

• ‫Notebooks Runner (roles/notebooks.runner) בפרויקט
• משתמש באובייקט אחסון (roles/storage.objectUser) בחשבון השירות של מופע Agent Platform Workbench

להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

הרשאה שנדרשת כדי להפעיל טעינה של אחסון משותף

כדי להפעיל את האפשרות של צירוף אחסון משותף במופע של Agent Platform Workbench, צריך לבקש מהאדמין להעניק לחשבון השירות של מופע Agent Platform Workbench את ההרשאה storage.buckets.list בפרויקט.

ההרשאה storage.buckets.list נדרשת כדי שהלחצן Mount shared storage יופיע בממשק JupyterLab של מופע Agent Platform Workbench.

יצירת קטגוריה ומופע של Agent Platform Workbench

צריכה להיות לכם גישה לפחות לקטגוריה אחת של Cloud Storage באותו פרויקט שבו נמצא המופע של Agent Platform Workbench.

1. אם צריך ליצור קטגוריה של Cloud Storage, אפשר לעיין במאמר יצירת קטגוריה.
2. אם עדיין לא עשיתם זאת, יוצרים מופע של Agent Platform Workbench באותו פרויקט שבו נמצאת הקטגוריה של Cloud Storage.

פתיחת JupyterLab

1. נכנסים לדף Instances במסוף Google Cloud .

   כניסה לדף Instances

2. לצד השם של מכונת Agent Platform Workbench, לוחצים על Open JupyterLab.

   מופע של Agent Platform Workbench ייפתח ב-JupyterLab.

טעינת הקטגוריה של Cloud Storage

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

1. ב-JupyterLab, מוודאים שהכרטיסייה  File Browser נבחרה.

2. בסרגל הצד הימני, לוחצים על הלחצן  Mount shared storage (הוספת אחסון משותף). אם הלחצן לא מופיע, גוררים את הצד השמאלי של סרגל הצד כדי להרחיב אותו עד שהלחצן יופיע.

   

3. בשדה שם הקטגוריה, מזינים את שם הקטגוריה של Cloud Storage שרוצים לטעון.

4. לוחצים על Mount (העלאה).

5. קטגוריית Cloud Storage תופיע כתיקייה בכרטיסייה סייר הקבצים בסרגל הצד הימני. לוחצים לחיצה כפולה על התיקייה כדי לפתוח אותה ולעיין בתוכן שלה.

פתרון בעיות

כדי למצוא שיטות לאבחון ולפתרון בעיות בהרכבת קטגוריה של Cloud Storage במכונה, ראו פתרון בעיות ב-Agent Platform Workbench.

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

• מידע נוסף על Cloud Storage

• איך שולחים שאילתות לנתונים ב-BigQuery מתוך JupyterLab