הגדרת Gemini Cloud Assist

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

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

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

המסוף

  1. עוברים לדף Admin for Gemini.

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

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

  3. לוחצים על Get Gemini Cloud Assist.

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

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

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

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

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

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

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

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

      כניסה לדף IAM & Admin

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

    3. בחלונית גישת עריכה לוחצים על ‎ הוספת תפקיד נוסף‎.

    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 המעודכנת על הפרויקט באמצעות השיטה 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. עוברים לדף Admin for Gemini.

      כניסה ל-Admin for Gemini

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

    3. לוחצים על Enable Cloud Assist APIs.

      מופיעה תיבת הדו-שיח 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
    • צפייה בנכסים בענן

    אם חשבון המשתמש רוצה לקבל עזרה לגבי מוצרים שאין לו גישה אליהם, יכול להיות שתצטרכו להקצות לו תפקידי 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. לוחצים על Manage Gemini Cloud Assist Settings.

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

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

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

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