התקנה של ספריות הלקוח של Gemini Enterprise Agent Platform

ספריות לקוח מספקות חוויית שימוש אופטימלית למפתחים שקוראים ל-Agent Platform API. ספריות הלקוח משתמשות במוסכמות הטבעיות של כל שפה נתמכת, ומפחיתות את כמות הקוד שחוזר על עצמו (boilerplate) שצריך לכתוב. במדריך הבא מוסבר איך להתקין את הספריות ולהגדיר אימות לשימוש בהן בסביבת פיתוח מקומית.

לפני שמתחילים

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

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

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

  5. Enable the Agent Platform API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    6.

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

    gcloud auth application-default login

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

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

ספריות לקוח

Agent Platform מספקת ספריות לקוח לשפות הבאות. בוחרים את השפה הרצויה.

C#‎

מריצים את הפקודה הבאה כדי להוסיף את הפניה לחבילה Google.Cloud.AIPlatform.V1 לקובץ הפרויקט:

dotnet add package Google.Cloud.AIPlatform.V1

התנסות בדוגמאות קוד

כדי לראות או לקבל דוגמאות קוד ספציפיות, אפשר לעבור למאגר dotnet-aiplatform ב-GitHub.

מסמכי עזר של ספריות לקוח

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

Java

אם משתמשים ב-Maven, מוסיפים את הקוד הבא ליחסי התלות:

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>google-cloud-aiplatform</artifactId>
  <version>3.35.0</version>
</dependency>

אם משתמשים ב-Gradle, צריך להוסיף את הקוד הבא ליחסי התלות:

compile 'com.google.cloud:google-cloud-aiplatform:3.35.0'

אם משתמשים ב-sbt, צריך להוסיף את הקוד הבא ליחסי התלות:

libraryDependencies += "com.google.cloud" % "google-cloud-aiplatform" % "3.35.0"

התנסות בדוגמאות קוד

כדי לראות או לקבל דוגמאות קוד ספציפיות, אפשר לעבור למאגר java-aiplatform ב-GitHub.

מסמכי עזר של ספריות לקוח

מידע נוסף זמין במסמכי העזרה של ספריית הלקוח של Agent Platform ל-Java.

Node.js

לפני שמתקינים את הספרייה, צריך להכין את הסביבה לפיתוח Node.js.

מריצים את הפקודה הבאה בסביבה כדי להתקין את ספריית הלקוח:

npm install @google-cloud/aiplatform

מסמכי עזר של ספריות לקוח

מידע נוסף זמין במאמרי העזרה בנושא ספריית הלקוח של Agent Platform ל-Node.js.

Python

ספריית הלקוח של Python ל-Gemini Enterprise Agent Platform מותקנת כשמתקינים את Agent Platform SDK ל-Python.

מידע נוסף זמין במאמר בנושא התקנת Agent Platform SDK for Python.

המשך

לפני שמתקינים את הספרייה, צריך להכין את הסביבה לפיתוח ב-Go.

עיון בחבילות הזמינות

כדאי לעיין בחבילות ה-API Go הזמינות של Agent Platform כדי לקבוע איזו חבילה הכי מתאימה לצרכים של הפרויקט:

  • ‫Package cloud.google.com/go/vertexai (מומלץ)

    ‫vertexai היא חבילה שנכתבה על ידי בני אדם ומספקת גישה ליכולות ולתכונות נפוצות.

    מומלץ להשתמש בחבילה הזו כנקודת התחלה לרוב המפתחים שיוצרים באמצעות Agent Platform API. כדי לגשת ליכולות ולתכונות שעדיין לא נכללות בחבילה הזו, אפשר להשתמש ב-aiplatform שנוצר אוטומטית.

  • Package cloud.google.com/go/aiplatform

    ‫aiplatform היא חבילה שנוצרה אוטומטית.

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

התקנה

  • ‫Package cloud.google.com/go/vertexai (מומלץ)

    מריצים את הפקודה הבאה כדי להתקין את החבילה הזו בסביבה:

    go get cloud.google.com/go/vertexai

  • Package cloud.google.com/go/aiplatform

    מריצים את הפקודה הבאה כדי להתקין את החבילה הזו בסביבה:

    go get cloud.google.com/go/aiplatform

דוגמאות

מסמכי עזר של ספריות לקוח

מידע נוסף על הספרייה זמין במסמכי העזרה של ספריית הלקוח של Agent Platform ל-Go: