הגדרת Gemini Cloud Assist

‫Gemini Cloud Assist עוזר לכם לתכנן, להפעיל ולשפר את האפליקציות והתשתית בענן באמצעות הדרכה מבוססת-AI בהתאם להקשר. כדי שחברי הצוות יוכלו להשתמש בתכונות האלה, אדמין צריך להשלים את ההגדרה הראשונית של פרויקט או תיקייה.

הגדרת Gemini Cloud Assist לפרויקט

כך מגדירים את Gemini Cloud Assist לפרויקט:

המסוף

  1. עוברים לדף אדמין ל-Gemini.

    כניסה לדף Gemini for Google Cloud

  2. בכלי לבחירת פרויקטים בחלק העליון של הדף, בוחרים את משאב הפרויקט.

  3. בוחרים באפשרות Get Gemini Cloud Assist (קבלת Gemini Cloud Assist).

  4. בתיבת הדו-שיח Get Gemini Cloud Assist (קבלת Gemini Cloud Assist):

    1. לוחצים על החץ להרחבה בקטע Required & recommended APIs.

    2. ברשימה Recommended APIs (ממשקי API מומלצים), בוחרים ממשקי API נוספים שרוצים להפעיל כדי לשפר את הביצועים של Gemini Cloud Assist.

    3. אופציונלי: בוחרים באפשרות Help Google improve Cloud Assist by sharing your prompts and answers.

    4. בוחרים באפשרות Enable Gemini Cloud Assist at no cost (הפעלת Gemini Cloud Assist ללא עלות).

  5. לוחצים על Save.

  6. מקצים את התפקידים ב-IAM שנדרשים בשביל Gemini Cloud Assist.

    1. נכנסים לדף IAM & Admin.

      כניסה לדף IAM & Admin

    2. בעמודה Principal, מחפשים את החשבון הראשי שרוצים לתת לו גישה ל-Gemini Cloud Assist, ולוחצים על Edit principal בשורה הזו.

    3. בחלונית גישת עריכה לוחצים על Add another role.

    4. ברשימת התפקידים Select a role בוחרים את Gemini Cloud Assist User.

    5. לוחצים על Add another role ובוחרים באפשרות Cloud Asset Viewer.

    6. אם החשבון הראשי רוצה לקבל עזרה לגבי מוצרים שאין לו גישה אליהם, יכול להיות שתצטרכו לתת לו תפקידי IAM נוספים. כדי לעשות את זה, לוחצים על Add another role ובוחרים תפקידים נוספים. במאמר דרישות IAM לשימוש ב-Gemini Cloud Assist מופיעה טבלה של תפקידי IAM שמאפשרים חוויית שימוש אופטימלית ב-Gemini Cloud Assist במוצרים שונים.

    7. אם הפרויקט שלכם הוא חלק מארגון שמשתמש באילוצים בהתאמה אישית, כדאי לעיין בהרשאות שנדרשות לצ'אט כדי לוודא שהצ'אט של Gemini Cloud Assist לא חסום.

  7. (אופציונלי) קובעים את הגדרות הפרויקט.

gcloud

  1. מפעילים את Cloud Shell במסוף Google Cloud .

    הפעלת Cloud Shell

  2. מפעילים את Gemini Cloud Assist API באמצעות הפקודה gcloud services enable:

    gcloud services enable geminicloudassist.googleapis.com

    בשלב הזה מופעל גם Gemini for Google Cloud API, שנדרש גם כדי להשתמש ב-Gemini Cloud Assist.

    אם רוצים להפעיל את Gemini Cloud Assist API בפרויקט אחר ב-Google Cloud , מוסיפים את הפרמטר --project:

    gcloud services enable geminicloudassist.googleapis.com --project PROJECT_ID

    מחליפים את PROJECT_ID במזהה הפרויקט שבו רוצים להפעיל את Gemini Cloud Assist.

    הפלט אמור להיראות כך:

    Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.

  3. מפעילים ממשקי API נדרשים אחרים באמצעות הפקודה gcloud services enable, כמו שעשיתם כדי להפעיל את Gemini Cloud Assist API:

    gcloud services enable cloudasset.googleapis.com designcenter.googleapis.com appoptimize.googleapis.com apphub.googleapis.com --project PROJECT_ID

  4. (אופציונלי) מפעילים את ממשקי ה-API המומלצים באמצעות הפקודה gcloud services enable, כמו שהפעלתם את Gemini Cloud Assist API.

  5. הקצאת תפקידי IAM בפרויקט ב- Google Cloud מידע נוסף זמין במאמרים הקצאת תפקיד יחיד וgcloud projects add-iam-policy-binding.

    1. מקצים את התפקיד roles/geminicloudassist.user:

      gcloud projects add-iam-policy-binding PROJECT_ID \
  --member=PRINCIPAL --role=roles/geminicloudassist.user

      מחליפים את מה שכתוב בשדות הבאים:

      • ‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud . לדוגמה: 1234567890.
      • ‫PRINCIPAL: המזהה של החשבון הראשי. לדוגמה: user:cloudysanfrancisco@gmail.com.

      תיווצר רשימה של קישורי מדיניות עם הפרטים הבאים:

      - members:
  - user:PRINCIPAL
  role: roles/geminicloudassist.user

    2. חוזרים על השלב הקודם לתפקיד roles/cloudasset.viewer.

    3. אם חשבון המשתמש רוצה לקבל עזרה לגבי מוצרים שאין לו גישה אליהם, יכול להיות שתצטרכו להקצות לו תפקידי IAM נוספים. במאמר דרישות IAM לשימוש ב-Gemini Cloud Assist מופיעה טבלה של תפקידי IAM שמאפשרים חוויית שימוש אופטימלית ב-Gemini Cloud Assist במוצרים שונים.

    4. אם הפרויקט שלכם הוא חלק מארגון שמשתמש באילוצים מותאמים אישית, כדאי לעיין בהרשאות שנדרשות לשימוש בצ'אט כדי לוודא שהצ'אט עם Gemini Cloud Assist לא חסום.

  6. (אופציונלי) קובעים את הגדרות הפרויקט.

API

בהוראות האלה נעשה שימוש ב-cURL כדי להפעיל methods של API.

  1. מפעילים את Gemini Cloud Assist API באמצעות השיטה services.enable:

    curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/geminicloudassist.googleapis.com:enable"

    מחליפים את PROJECT_ID במזהה הפרויקט שבו רוצים להפעיל את Gemini Cloud Assist.

    אם הפקודה מצליחה, היא מחזירה long-running operation, שכולל את השדה name. אתם יכולים להשתמש בערך שבשדה name כדי לבדוק את סטטוס הפעולה.

  2. מפעילים את ממשקי ה-API הנוספים הנדרשים באמצעות השיטה services.enable, כמו שהפעלתם את Gemini Cloud Assist API:

    • cloudasset.googleapis.com
    • designcenter.googleapis.com
    • appoptimize.googleapis.com
    • apphub.googleapis.com

  3. (אופציונלי) מפעילים ממשקי API מומלצים באמצעות השיטה services.enable, כמו שהפעלתם את Gemini Cloud Assist API.

  4. מקצים תפקידי IAM לפרויקט Google Cloud המשויך.

    1. יוצרים קובץ JSON שמכיל את הפרטים הבאים:

        {
    "options": {
      "requestedPolicyVersion": 3
    }
  }

    2. אחזור של מדיניות ה-IAM הקיימת של הפרויקט באמצעות ה-method‏ projects.getIamPolicy:

        curl -X POST --data-binary @JSON_FILE_NAME \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://cloudresourcemanager.googleapis.com/v1/projects/PROJECT_ID:getIamPolicy"

      מחליפים את מה שכתוב בשדות הבאים:

      • ‫JSON_FILE_NAME: הנתיב לקובץ JSON שיצרתם בשלב הקודם.

      • ‫PROJECT_ID: מזהה הפרויקט.

      אם הפעולה בוצעה ללא שגיאות, התגובה מחזירה את מדיניות ה-IAM של הפרויקט.

    3. מעתיקים את מדיניות ה-IAM של הפרויקט לקובץ JSON ריק, ומוסיפים את המידע הבא לתוכן הקיים:

        {
    "role": "roles/geminicloudassist.user",
    "members": [
      "PRINCIPAL"
    ]
  },
  {
    "role": "roles/cloudasset.viewer",
    "members": [
      "PRINCIPAL"
    ]
  }

      מחליפים את PRINCIPAL במזהה של החשבון הראשי שאתם נותנים לו גישה ל-Gemini Cloud Assist.

    4. מחילים את מדיניות ה-IAM המעודכנת על הפרויקט באמצעות ה-method projects.setIamPolicy:

        curl -X POST --data-binary @JSON_FILE_NAME \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://cloudresourcemanager.googleapis.com/v1/projects/PROJECT_ID:setIamPolicy"

      מחליפים את מה שכתוב בשדות הבאים:

      • ‫JSON_FILE_NAME: הנתיב לקובץ JSON שיצרתם בשלב הקודם.

      • ‫PROJECT_ID: מזהה הפרויקט.

      אם הפעולה בוצעה ללא שגיאות, התשובה תחזיר את מדיניות ה-IAM המעודכנת של הפרויקט.

    5. אם חשבון המשתמש רוצה לקבל עזרה במוצרים שאין לו גישה אליהם, יכול להיות שתצטרכו להקצות לו תפקידי IAM נוספים. במאמר דרישות IAM לשימוש ב-Gemini Cloud Assist מופיעה טבלה של תפקידי IAM שמאפשרים חוויית שימוש אופטימלית ב-Gemini Cloud Assist במוצרים שונים.

    6. אם הפרויקט שלכם הוא חלק מארגון שמשתמש באילוצים מותאמים אישית, כדאי לעיין בהרשאות שנדרשות לשימוש בצ'אט כדי לוודא שהצ'אט עם Gemini Cloud Assist לא חסום.

  5. (אופציונלי) מגדירים את ההגדרות של הפרויקט.

הגדרת Gemini Cloud Assist לתיקייה

בשלבים הבאים מוסבר איך להגדיר את Gemini Cloud Assist לתיקייה באמצעות מסוף Google Cloud . אי אפשר להשתמש ב-Google Cloud CLI או ב-API כדי להגדיר את Gemini Cloud Assist לתיקיות.

  1. מפעילים את ממשקי ה-API הנדרשים והמומלצים.

    1. עוברים לדף אדמין ל-Gemini.

      כניסה אל Admin for Gemini

    2. בכלי לבחירת פרויקטים שבחלק העליון של הדף, בוחרים את משאב התיקייה.

    3. בוחרים באפשרות Enable Cloud Assist APIs (הפעלת ממשקי Cloud Assist API).

      מופיעה תיבת הדו-שיח Enable API for existing projects within folder.

    4. בתיבת הדו-שיח Enable API for existing projects within a folder, לוחצים על החץ להרחבה בקטע Required & recommended APIs.

    5. ברשימה Recommended APIs, בוחרים את ממשקי ה-API האופציונליים שרוצים להפעיל.

    6. אופציונלי: בוחרים באפשרות Help Google improve Cloud Assist by sharing your prompts and answers.

    7. לוחצים על Enable Gemini Cloud Assist at no cost.

      בשלב הזה מפעילים את ממשקי ה-API הנדרשים והמומלצים שנבחרו לכל הפרויקטים בתיקייה. אם אתם רוצים להחריג פרויקטים מסוימים בתיקייה, אתם יכולים לחסום את ההפעלה של ה-API על ידי הגדרת אילוץ מדיניות הארגון Restrict Resource Service Usage בפרויקטים האלה. מידע נוסף מופיע במאמר בנושא הגבלת השימוש במשאבים.

  2. מקצים את תפקידי ה-IAM הבאים או יוצרים תפקידים בהתאמה אישית עם הרשאות שוות בתיקייה:

    • Gemini Cloud Assist User
    • Cloud Asset Viewer

    אם חשבון המשתמש רוצה לקבל עזרה לגבי מוצרים שאין לו גישה אליהם, יכול להיות שתצטרכו להקצות לו תפקידי IAM נוספים. במאמר דרישות IAM לשימוש ב-Gemini Cloud Assist מופיעה טבלה של תפקידי IAM שמאפשרים חוויית שימוש אופטימלית ב-Gemini Cloud Assist במוצרים שונים.

  3. אם התיקייה שלכם היא חלק מארגון שמשתמש באילוצים בהתאמה אישית, כדאי לעיין בהרשאות שנדרשות לצ'אט כדי לוודא שהצ'אט עם Gemini Cloud Assist לא חסום.

  4. אם אתם משתמשים ב-Gemini Cloud Assist עם אפליקציות, אתם צריכים להפעיל גם את ניהול האפליקציות ברמת התיקייה. בשלב הזה נוצר פרויקט ניהול שאליו צריך לקשר חשבון לחיוב.

    1. חוזרים לדף Admin for Gemini.

      מעבר אל Admin for Gemini

    2. בוחרים באפשרות הפעלת ניהול אפליקציות.

      מופיע דף ההגדרות IAM & Admin.

    3. בקטע הפעלת אפליקציות בדף, בוחרים באפשרות הפעלה.

      תיבת הדו-שיח Enable application APIs on this folder מופיעה.

    4. לוחצים על הפעלה.

      שורת סטטוס מציגה את ההתקדמות בהפעלת ה-API. דף ההגדרות IAM & Admin יתרענן כשהפעלת ה-API תסתיים.

    5. לוחצים על ניהול החיוב.

      מופיע הדף חשבון מקושר.

    6. בוחרים חשבון לחיוב מהרשימה ולוחצים על Set account.

  5. מקצים את תפקידי ה-IAM שהקציתם לתיקייה בשלב 2, או יוצרים תפקידים בהתאמה אישית עם הרשאות שוות ערך לפרויקט הניהול שנוצר בשלב הקודם.

    מאתרים את פרויקט הניהול של התיקייה:

    1. חוזרים לדף Admin for Gemini.

      כניסה אל Admin for Gemini

    2. בכלי לבחירת פרויקטים שבחלק העליון של הדף, בוחרים את משאב התיקייה.

    3. בוחרים באפשרות ניהול ההגדרות של Gemini Cloud Assist.

      תיבת הדו-שיח Manage Gemini Cloud Assist נפתחת.

    4. שימו לב לפרויקט הניהול.

  6. (אופציונלי) קביעת הגדרות לפרויקטים בתיקייה.

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