הגדרת Gemini Cloud Assist

המסוף

1. עוברים לדף ניהול Gemini.

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

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

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

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

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

   2. מוודאים שממשקי ה-API הנדרשים מופעלים: Gemini Cloud Assist API ו-Gemini for Google Cloud API.

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

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

   5. בוחרים באפשרות הפעלת Gemini Cloud Assist ללא עלות.

5. לוחצים על שמירה.

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

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

      כניסה לדף IAM & Admin

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

   3. בחלונית Edit access לוחצים על add Add another role.

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

   5. לוחצים על Add another role ובוחרים את התפקיד Recommender Viewer.

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

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate 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
   

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

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

3. מקצים תפקידי 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/recommender.viewer.

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

API

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

1. מפעילים את Gemini Cloud Assist API באמצעות ה-method 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. מקצים תפקידי 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/recommender.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 בפרויקט.

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