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

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

הגדרת פרויקט

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

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

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

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

  4. Enable the Gemini Enterprise Agent Platform 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

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

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

  7. Enable the Gemini Enterprise Agent Platform 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

    8.

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

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

    המסוף

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

    gcloud

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

    2. אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-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. אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

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

      gcloud components update
gcloud components install beta

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

      gcloud auth application-default login

      אם אתם משתמשים ב-Cloud Shell, אין צורך לבצע את הפעולה הזו.

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

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