סקירה כללית של Gemini Enterprise Agent Platform במצב אקספרס

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

שאלות נפוצות על מצב אקספרס ב-Google Cloud

הרשמה למצב אקספרס

‫Agent Platform זמינה במצב אקספרס למפתחים עם @gmail.com חשבון Google:

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

    פלטפורמת Agent במצב אקספרס נפרדת מתוכניתGoogle Cloud החינמית, ואי אפשר להשתמש בה דרך התוכנית הזו. אם אתם משתמשים בתוכנית החינמית שלGoogle Cloud , עיינו במדריכים האחרים למתחילים בקטע תחילת העבודה.

כדי להירשם ל-Agent Platform במצב אקספרס, פותחים את Express Mode במסוף Google Cloud :

מעבר למצב אקספרס

אחרי שתסיימו את ההגדרה, תוכלו להתחיל להשתמש ב-Agent Platform במצב אקספרס. פשוט עקבו אחרי אחד מהמדריכים הבאים:

מידע על Agent Platform במצב אקספרס

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

כשנרשמים למצב אקספרס, מקבלים גישה אל:

  • התכונות העיקריות של Agent Studio אתם יכולים לבדוק ולהתאים אישית הנחיות למודלים שונים של AI גנרטיבי, ולקבל את הקוד המתאים לשימוש באפליקציה.
  • מפתח API. לאמת בקשות מהאפליקציה.
  • תוכנית בחינם למשתמשים חדשים ב- Google Cloud למשך 90 יום. במהלך 90 הימים של תוכנית בחינם למשתמשים חדשים ב- Google Cloud , אתם יכולים להשתמש בחינם בממשקי ה-API של Agent Platform שתומכים במצב אקספרס, עד למכסות שלהם. לא צריך לספק פרטי חיוב. אתם יכולים להגדיל את המכסות בכל שלב על ידי הפעלת החיוב.

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

בטבלה הבאה מפורטים ההבדלים בין חוויית השימוש במצב אקספרס לבין חוויית השימוש המלאה ב-Agent Platform:

פריט מצב אקספרס ב-Agent Platform בתוכנית בחינם Full Agent Platform
מגבלת זמן 90 ימים ללא הגבלה
השירותים הזמינים שירותי AI גנרטיבי בסיסיים. כל שירותי Google Cloud , כולל Agent Platform.
מקורות נתונים Google Drive כל מקורות הנתונים שזמינים ב- Google Cloud.
מכסה מגבלות התוכנית בחינם. מודלים זמינים והגבלת קצב של יצירת בקשות במצב אקספרס מגבלות רגילות לתשלום לפי שימוש. מידע על מגבלות קצב
הפורמט הרגיל של נקודות קצה ל-API משתמשים בנקודת הקצה הגלובלית בלי מזהה פרויקט או מיקום, ומעבירים את מפתח ה-API בכותרת ה-HTTP ‏x-goog-api-key (או בפרמטרים של שאילתה key). לדוגמה:
https://aiplatform.googleapis.com/v1/publishers/google/models/MODEL_ID:streamGenerateContent 		מציינים את מזהה הפרויקט והמיקום. לדוגמה:
https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent

המודלים הזמינים ומגבלות הקצב במצב אקספרס

במצב אקספרס אתם יכולים לנסות כמה מודלים, כולל מודלים של Gemini Flash. בטבלה הבאה מפורטים המודלים שזמינים במצב אקספרס, יחד עם מגבלות הקצב שלהם:

קטגוריית המודל מודלים זמינים מספר הבקשות המקסימלי לדקה
Gemini gemini-3-pro-image דינמית
gemini-3.1-flash-image דינמית
gemini-3.1-pro-preview דינמית
gemini-3-flash-preview דינמית
gemini-2.5-pro 10
gemini-2.5-flash-image 10
gemini-2.5-flash 10
gemini-2.5-flash-lite 10

במצב אקספרס יש תמיכה רק במודלים שמפורטים בטבלה שלמעלה. מודלים ייעודיים של Gemini Live API, כמו Gemini 3.8 Live‏ (gemini-3.8-live) ו-Gemini 2.5 Flash Live API Native Audio‏ (gemini-live-2.5-flash-native-audio), לא נתמכים במצב אקספרס, ו-Gemini Live API לא זמין במסוףGoogle Cloud במצב אקספרס. כדי להשתמש במודלים נתמכים של Gemini Live API, צריך לשדרג ממצב אקספרס לחשבון Google Cloudרגיל.

תהליך העבודה של Agent Platform במצב אקספרס

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

  1. אחרי שנרשמים למצב אקספרס, אפשר להשתמש ב-Agent Studio כדי לנסות את התכונות של Agent Platform:

    מעבר ל-Agent Studio

    לדוגמה, בוחרים באפשרות Agent Studio > Create prompt כדי ליצור הנחיות מולטי-מודאליות ולשפר אותן באמצעות מגוון מודלים של Gemini.

  2. מקבלים את הקוד של מה שהטמעתם באמצעות ממשק המשתמש.

    בדף ההנחיה, לוחצים על פיתוח באמצעות קוד > קבלת קוד. ייפתח חלונית עם קוד ששולח באופן פרוגרמטי את אותן בקשות שהטמעתם בממשק המשתמש. אתם יכולים לקבל את הקוד בשפת תכנות או ב-curl. אתם יכולים להשתמש ב-Google Colab כדי לנסות את קוד Python.

  3. משתמשים במפתח ה-API כדי לבצע אימות מול Agent Platform API.

    במסוף Google Cloud במצב אקספרס, פותחים את APIs & Services > Credentials:

    כניסה לדף Credentials

    אחר כך מעתיקים את מפתח ה-API של Generative Language לקוד במקום שבו כתוב "YOUR_API_KEY". לדוגמה:

    Python

    ‫Google Gen AI SDK ל-Python זמין ב-PyPI וב-GitHub:

    מידע נוסף זמין בחומר העזר של Python SDK (נפתח בכרטיסייה חדשה). 

    from google import genai

# TODO(developer): Update below line
API_KEY = "YOUR_API_KEY"

client = genai.Client(vertexai=True, api_key=API_KEY)

response = client.models.generate_content(
    model="gemini-3.5-flash",
    contents="Explain bubble sort to me.",
)

print(response.text)
# Example response:
# Bubble Sort is a simple sorting algorithm that repeatedly steps through the list

מה ההבדל במצב אקספרס

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

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

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

כתובת ה-URL של נקודת הקצה הרגילה https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent
כתובת ה-URL של נקודת הקצה במצב אקספרס https://aiplatform.googleapis.com/v1/publishers/google/models/MODEL_ID:streamGenerateContent

כששולחים בקשות REST במצב אקספרס, חשוב לזכור את הפרטים הבאים לגבי נקודת הקצה והאימות:

  • נתיב המודל של בעל האפליקציה ({model}): במאמרי העזרה של ה-API בארכיטקטורת REST של Agent Platform במצב אקספרס, תבניות של נקודות קצה כמו https://aiplatform.googleapis.com/v1/{model}:streamGenerateContent ו-https://aiplatform.googleapis.com/v1beta1/{model}:streamGenerateContent משתמשות ב-{model} כדי לייצג את נתיב המשאב המלא של המודל של בעל האפליקציה (publishers/google/models/MODEL_ID). שניהם מפנים לאותה כתובת URL של נקודת קצה.
  • כותרת אימות של מפתח API: לא צריך להעביר את מפתח ה-API כפרמטר של שאילתה. מעבירים את מפתח ה-API בכותרת ה-HTTP‏ x-goog-api-key (לדוגמה, -H "x-goog-api-key: API_KEY"). אם סביבת הלקוח לא מאפשרת להגדיר כותרות HTTP, אפשר להעביר במקום זאת את פרמטר השאילתה של המערכת key (?key=API_KEY). מידע נוסף זמין במאמר שימוש במפתחות API.

הצגה וניהול של מפתחות API

כדי לאמת באמצעות נקודות קצה ל-API של Agent Platform שתומכות במצב אקספרס, צריך להשתמש במפתח ה-API שנוצר בשבילכם במהלך ההרשמה או בכל מפתח שיצרתם במצב אקספרס. מפתח API הוא מחרוזת מוצפנת שנוצרת אוטומטית כשנרשמים במצב אקספרס. אפשר לראות ולנהל את מפתחות ה-API האלה בדף APIs & Services.

שיטות מומלצות לניהול מפתחות API

כדי לראות ולנהל את מפתחות ה-API:

  1. נכנסים לדף API Keys במסוף Google Cloud :

    לדף API Keys

הפעלה וניהול של החיוב

כדי להגדיל את המכסות ולהסיר את המגבלה של 90 הימים, צריך להפעיל את החיוב.

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

כדי לנהל את החיוב:

  1. עוברים לדף הסקירה הכללית של Agent Studio במצב אקספרס.

    מעבר ל-Agent Studio

  2. במסוף Google Cloud במצב אקספרס, פותחים את Billing:

    כניסה לדף החיוב

  3. ניהול החשבונות לחיוב.

להתחיל להשתמש בכל היכולות והשירותים של Google Cloud

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

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

כדי לשדרג ממצב אקספרס:

  1. עוברים לדף הסקירה הכללית של Agent Studio במצב אקספרס.

    מעבר ל-Agent Studio

  2. לוחצים על הפעלה ופועלים לפי ההוראות.

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

https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent