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

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

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

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

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

  • משתמשים חדשים: משתמשים חדשים ב- 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 שזמינות במצב אקספרס מופיעים במאמר Agent Platform in express mode REST API reference.

בנוסף, לקוחות ב- 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