היכרות עם Agent Platform SDK ל-Python

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

במאמר התקנה של Agent Platform SDK ל-Python מוסבר איך להתקין או לעדכן את Agent Platform SDK ל-Python. מידע נוסף מופיע במאמרי העזרה של Agent Platform SDK for Python API.

למה כדאי להשתמש ב-Agent Platform SDK

מומלץ להשתמש ב-SDK של Agent Platform ל-Python אם אתם מהנדסי למידת מכונה (ML) ובינה מלאכותית (AI) מנוסים או מדעני נתונים שרוצים להפוך את תהליך העבודה שלהם לאוטומטי באמצעות תכנות. ‫Agent Platform SDK ל-Python דומה לספריית הלקוח של Gemini Enterprise Agent Platform ל-Python, אבל Agent Platform SDK הוא ברמה גבוהה יותר ופחות מפורט. מידע נוסף זמין במאמר הסבר על ההבדלים בין SDK לבין ספריית לקוח.

כתיבת קוד באמצעות Agent Platform SDK ל-Python

כדי להשתמש ב-Agent Platform SDK ל-Python:

  1. כדי להתקין את חבילת google-cloud-aiplatform, שכוללת גם את Agent Platform SDK for Python וגם את ספריית הלקוח של Python ב-Gemini Enterprise Agent Platform, מריצים את הפקודה הבאה בסביבה הווירטואלית:

    pip install --upgrade google-cloud-aiplatform
    
  2. משתמשים בקוד הבא כדי לייבא את מרחב השמות google.cloud.aiplatform:

    from google.cloud import aiplatform
    
  3. אם אתם משתמשים במעטפת מקומית, צריך ליצור פרטי כניסה לאימות מקומי עבור חשבון המשתמש:

    gcloud auth application-default login

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

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

מידע על Agent Platform SDK ל-Python

מידע נוסף זמין במאמרי העזרה הבאים:

התנסות בדוגמאות קוד ובמדריכים

במדריכים ל-Notebook מוצגות דוגמאות לשימוש ב-Agent Platform SDK for Python כחלק מתהליך עבודה גדול יותר. מידע נוסף על Gemini Enterprise Agent Platform notebook tutorials

בדוגמאות הקוד במאגר Agent Platform SDK for Python GitHub אפשר לראות איך לבצע משימות ספציפיות. מידע נוסף זמין במאגר GitHub של Agent Platform SDK for Python.

הסבר על ההבדלים בין Agent Platform SDK לבין ספריות לקוח

כשמתקינים את Agent Platform SDK for Python, מותקנת גם ספריית הלקוח של Gemini Enterprise Agent Platform Python. ערכת ה-SDK של Agent Platform וספריית הלקוח של Python של Gemini Enterprise Agent Platform מספקות פונקציונליות דומה עם רמות פירוט שונות. ערכת ה-SDK של Agent Platform פועלת ברמת הפשטה גבוהה יותר מאשר ספריית הלקוח, והיא מתאימה לרוב תהליכי העבודה הנפוצים במדע הנתונים. אם אתם צריכים פונקציונליות ברמה נמוכה יותר, אתם יכולים להשתמש בספריית הלקוח של Python ל-Gemini Enterprise Agent Platform.

‫Agent Platform 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 ומגלים שאתם צריכים גמישות או שליטה רבה יותר, או אם אתם צריכים שיטה שלא נכללת ב-Agent Platform SDK, אתם יכולים להשתמש בספריית הלקוח של Gemini Enterprise Agent Platform Python באותו תהליך עבודה. ספריית הלקוח של Python ל-Gemini Enterprise Agent Platform משתמשת במרחב שמות שונה כדי לגשת ל-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

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