ה-SDK של Agent Platform ל-Python עוזר לכם לבצע אוטומציה של הטמעת נתונים, אימון מודלים וקבלת חיזויים ב-Gemini Enterprise Agent Platform. ה-Vertex AI SDK משתמש בקוד Python כדי לגשת ל-Agent Platform API, כך שתוכלו לבצע באופן פרוגרמטי את רוב הפעולות שאפשר לבצע במסוף Google Cloud .
כדי ללמוד איך להתקין או לעדכן את Agent Platform SDK ל-Python, אפשר לעיין במאמר התקנת Agent Platform SDK ל-Python. מידע נוסף זמין במאמרי העזרה של Agent Platform SDK ל-Python.
למה כדאי להשתמש ב-Vertex AI SDK
מומלץ להשתמש ב-SDK של Agent Platform ל-Python אם אתם מהנדסי למידת מכונה (ML) ובינה מלאכותית (AI) מנוסים או מדעני נתונים שרוצים להפוך את תהליך העבודה לאוטומטי באמצעות תכנות. Agent Platform SDK ל-Python דומה לספריית הלקוח של Gemini Enterprise Agent Platform Python, אבל Vertex AI SDK הוא ברמה גבוהה יותר ופחות מפורט. מידע נוסף זמין במאמר ההבדלים בין ה-SDK לספריית הלקוח.
כתיבת קוד באמצעות Agent Platform SDK ל-Python
כדי להשתמש ב-Agent Platform SDK ל-Python:
כדי להתקין את חבילת
google-cloud-aiplatform, שכוללת את Agent Platform SDK for Python ואת ספריית הלקוח של Python ל-Gemini Enterprise Agent Platform, מריצים את הפקודה הבאה בסביבה הווירטואלית:pip install --upgrade google-cloud-aiplatformכדי לייבא את מרחב השמות
google.cloud.aiplatform, משתמשים בקוד הבא:from google.cloud import aiplatform-
אם אתם משתמשים במעטפת מקומית, אתם צריכים ליצור פרטי כניסה לאימות מקומי עבור חשבון המשתמש:
gcloud auth application-default login
אם אתם משתמשים ב-Cloud Shell, אין צורך לבצע את הפעולה הזו.
אם מוחזרת שגיאת אימות ואתם משתמשים בספק זהויות חיצוני (IdP), ודאו ש נכנסתם ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
מידע על Agent Platform SDK ל-Python
אפשר לעיין במקורות המידע הבאים:
סקירה כללית של מחלקות Vertex AI SDK: מאמר שמציג את המחלקות והפונקציות העיקריות ב-Vertex AI SDK.
מאמרי עזרה ל-Python עבור Gemini Enterprise Agent Platform: מכילה מאמרי עזרה לכל מרחבי השמות, המחלקות, השיטות והמאפיינים בחבילה
google-cloud-aiplatform, שכוללת את Vertex AI SDK, את Vertex AI SDK בגרסת טרום-השקה (Preview) ואת ספריות הלקוח של Gemini Enterprise Agent Platform.
התנסות בדוגמאות קוד ובמדריכים
במדריכים ל-Notebook מוצג איך להשתמש ב-Agent Platform SDK for Python כחלק מתהליך עבודה גדול יותר. מידע נוסף זמין במאמר בנושא מדריכים לשימוש ב-Gemini Enterprise Agent Platform.
בדוגמאות הקוד במאגר Agent Platform SDK for Python ב-GitHub מוסבר איך לבצע משימות ספציפיות. מידע נוסף זמין במאגר Agent Platform SDK for Python ב-GitHub.
הסבר על ההבדלים בין Vertex AI SDK וספריית הלקוח
כשמתקינים את Agent Platform SDK for Python, מותקנת גם ספריית הלקוח של Python ל-Gemini Enterprise Agent Platform. Vertex AI SDK וספריית הלקוח של Python ל-Gemini Enterprise Agent Platform מספקות פונקציונליות דומה עם רמות שונות של גרנולריות. Vertex AI SDK פועל ברמה גבוהה יותר של הפשטה בהשוואה לספריית הלקוח, והוא מתאים לרוב תהליכי העבודה הנפוצים של מדעי הנתונים. אם אתם צריכים פונקציונליות ברמה נמוכה יותר, אתם יכולים להשתמש בספריית הלקוח של Python ל-Gemini Enterprise Agent Platform.
Vertex AI SDK זמין ל-Python, וספריית לקוח של Gemini Enterprise Agent Platform זמינה ל-Python, ל-Java ול-Node.js. מידע על התקנה של ספריית הלקוח של Java או Node.js מופיע במאמר התקנה של ספריות הלקוח של Gemini Enterprise Agent Platform. אם אין ספריית לקוח בשפת התכנות המועדפת עליכם, אתם יכולים להשתמש ב-API ל-REST של פלטפורמת הסוכנים של Gemini Enterprise. מידע נוסף זמין במאמר Gemini Enterprise Agent Platform REST reference.
שימוש משולב בספריית הלקוח וב-SDK של Python ל-Gemini Enterprise Agent Platform
אם אתם משתמשים ב-Agent Platform SDK ל-Python ומגלים שאתם צריכים גמישות או שליטה רבה יותר, או אם אתם צריכים שיטה שלא נכללת ב-Vertex AI SDK, אתם יכולים להשתמש בספריית הלקוח של Gemini Enterprise Agent Platform ל-Python באותו תהליך עבודה. ספריית הלקוח של Gemini Enterprise Agent Platform ל-Python משתמשת במרחב שמות שונה כדי לגשת ל-Agent Platform API. אפשר להשתמש במרחבי השמות של ספריית הלקוח ושל Agent Platform SDK ל-Python באותו סקריפט Python על ידי הוספת שורה של import לכל אחד מהם בסקריפט Python.
ייבוא מרחב השמות של ספריית הלקוח Python של Gemini Enterprise Agent Platform
מרחב השמות של ספריית הלקוח של Python ב-Gemini Enterprise Agent Platform הוא google.cloud.aiplatform.gapic. מרחב השמות הזה ממופה למרחב השמות google.cloud.aiplatform_v1. אפשר להשתמש בשני מרחבי השמות האלה לסירוגין. כדי לייבא את ספריית הלקוח של Python, צריך לכלול אחד מהבאים בסקריפט Python:
from google.cloud import aiplatform_v1
from google.cloud.aiplatform import gapic