הגדרת פרויקט וסביבת פיתוח

כדי להתחיל להשתמש ב-Gemini Enterprise Agent Platform, בדף הזה מוסבר איך ליצור פרויקט ב- Google Cloud ולהפעיל את ממשקי ה-API של Agent Platform. אם אין לכם את ההרשאות לבצע את המשימות האלה, בקשו מאדמין להגדיר פרויקט ולהפעיל בשבילכם את Gemini Enterprise Agent Platform. בנוסף, נסביר איך להגדיר את Google Cloud CLI בסביבת הפיתוח המקומית.

הגדרת פרויקט

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

  1. 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.

    Go to project selector

  2. Verify that billing is enabled for your Google Cloud project.

  3. Enable the Gemini Enterprise Agent Platform API, if it is not already enabled.

    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

מגדירים אימות

    צריך לבחור את הכרטיסיות הרלוונטיות לאופן שבו תכננתם לגשת ל-API:

    המסוף

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

    gcloud

    1. התקינו את ה-CLI של Google Cloud.

    2. הגדירו שה-CLI של gcloud ישתמש בזהות המאוחדת שלכם.

      איך נכנסים ל-CLI של gcloud באמצעות הזהות המאוחדת?

    3. כדי לאתחל את ה-CLI של gcloud, הריצו את הפקודה הבאה: 

      gcloud init

    4. אחרי שתאתחלו את ה-CLI של gcloud, עדכנו אותו והתקינו את הרכיבים הנדרשים: 

      gcloud components update
gcloud components install beta

    כדי להגדיר את ה-CLI של gcloud כך שיבצע התחזות לחשבון שירות כדי לאמת ל-Google APIs, במקום להשתמש בפרטי הכניסה של המשתמש, מריצים את הפקודה הבאה: 

    gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

    מידע נוסף מופיע במאמר התחזות לחשבון שירות.

    ספריות לקוח

    כדי להשתמש בספריות לקוח בסביבת פיתוח מקומית, מתקינים ומפעילים את ה-CLI של gcloud, ואז מגדירים את Application Default Credentials באמצעות פרטי הכניסה של המשתמש.

    1. התקינו את ה-CLI של Google Cloud.

    2. הגדירו שה-CLI של gcloud ישתמש בזהות המאוחדת שלכם.

      איך נכנסים ל-CLI של gcloud באמצעות הזהות המאוחדת?

    3. אחרי שתאתחלו את ה-CLI של gcloud, עדכנו אותו והתקינו את הרכיבים הנדרשים: 

      gcloud components update
gcloud components install beta

    4. יוצרים פרטי כניסה לאימות מקומי בחשבון המשתמש: 

      gcloud auth application-default login

      אם מופיעה שגיאת אימות, ודאו ש נכנסתם ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם.

    למידע נוסף, ראו הגדרת ADC לסביבת פיתוח מקומית במאמרי העזרה בנושא אימות Google Cloud .

    כדי להגדיר את קובץ ה-ADC המקומי כך שיבצע התחזות לחשבון שירות כדי לאמת ל-Google APIs, במקום להשתמש בפרטי הכניסה של המשתמש, מריצים את הפקודה הבאה: 

    gcloud auth application-default login --impersonate-service-account=SERVICE_ACCT_EMAIL

    מידע נוסף מופיע במאמר התחזות לחשבון שירות.

    REST

    כדי להשתמש ב-API בארכיטקטורת REST בסביבת פיתוח מקומית, צריך להשתמש בפרטי הכניסה שאתם נותנים ל-CLI של gcloud.

    1. התקינו את ה-CLI של Google Cloud.

    2. הגדירו שה-CLI של gcloud ישתמש בזהות המאוחדת שלכם.

      איך נכנסים ל-CLI של gcloud באמצעות הזהות המאוחדת?

    3. אחרי שתאתחלו את ה-CLI של gcloud, עדכנו אותו והתקינו את הרכיבים הנדרשים: 

      gcloud components update
gcloud components install beta

    מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Google Cloud .

    אתם יכולים להשתמש בהתחזות לחשבון שירות כדי ליצור טוקן גישה לבקשות API בארכיטקטורת REST. מידע נוסף מופיע במאמר חשבון שירות שבוצעה אליו התחזות.

    במאמר הגדרת Application Default Credentials לקוד שפועל ב- Google Cloud, שבמסמכי התיעוד של Google Cloud בנושא אימות, מוסבר איך מגדירים אימות בסביבת ייצור.

לבקש מאדמין להגדיר בשבילכם פרויקט ב-Gemini Enterprise Agent Platform

בקטע הזה מוסבר איך אדמינים יכולים להקצות את התפקידים שנדרשים כדי להשתמש ב-Gemini Enterprise Agent Platform.

  1. בוחרים שם ומזהה לפרויקט שיעזרו לכם לזהות אותו. אם אתם חלק מארגון או מתכננים ליצור כמה פרויקטים, כדאי לחשוב על מוסכמות למתן שמות ועל היררכיות של תיקיות שאתם פועלים לפיהן, או שתוכלו לפעול לפיהן, כדי שארגון הפרויקטים יהיה ברור.
  2. התפקידים הנדרשים:
    1. הגישה לרוב היכולות של Gemini Enterprise Agent Platform ניתנת באמצעות התפקיד משתמש ב-Agent Platform (roles/aiplatform.user) ב-IAM, והוא אמור להספיק לרוב המשתמשים ב-Gemini Enterprise Agent Platform. כדי לקבל שליטה מלאה במשאבים של Gemini Enterprise Agent Platform, אתם יכולים לבקש את התפקיד אדמין של פלטפורמת הסוכנים (roles/aiplatform.admin). במאמר בקרת גישה באמצעות IAM ב-Gemini Enterprise Agent Platform מוסבר בהרחבה על ההבדלים בין התפקידים האלה לבין תפקידים אחרים ב-Gemini Enterprise Agent Platform.
    2. אם אתם מתכוונים להשתמש גם במכונות של Gemini Enterprise Agent Platform Workbench ב- Google Cloud, בקשו מהאדמין לתת לכם את התפקיד אדמין של Notebooks ‏(roles/notebooks.admin) ב-IAM בפרויקט, וגם את התפקיד משתמש בחשבון שירות ‏((roles/iam.serviceAccountUser)) ב-IAM בפרויקט או בחשבון השירות שמשמש כברירת מחדל ב-Compute Engine.
    3. בנוסף, כדי להפעיל את ממשקי ה-API הנדרשים, צריך את תפקיד ה-IAM Service Usage Admin ((roles/serviceusage.serviceUsageAdmin)) או שהאדמין יפעיל בשבילכם את ממשקי ה-API לפי השלבים הראשונים.
  3. בקשו מהאדמין להפעיל בשבילכם את ממשקי ה-API של Agent Platform. אם קיבלתם את התפקיד אדמין של שימוש בשירות ((roles/serviceusage.serviceUsageAdmin)) ב-IAM, תוכלו לעשות את זה בעצמכם.

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