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

תצוגה מקדימה

השימוש בתכונה הזו כפוף לתנאי השימוש במוצרים בשלב טרום-GA, שמפורטים בחלק "תנאי שירות הכלליים" בתנאים הספציפיים של השירות. השימוש בתכונות בגרסת טרום-GA הוא "כפי שהן" (As is), ויכול להיות שהתמיכה בהן תהיה מוגבלת. מידע נוסף זמין בקטע תיאור שלבי ההשקה.

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

מידע נוסף על Agent Platform במצב אקספרס זמין בשאלות הנפוצות על מצב אקספרס ב-Google Cloud.

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

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

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

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

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

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

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

• הדרכה: Agent Studio במצב אקספרס
• הדרכה: Agent Platform API במצב אקספרס

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

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

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

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

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

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

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

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:

   • google-genai ב-PyPI
   • python-genai ב-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 של 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.

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

1. במסוף Google Cloud , נכנסים לדף מפתחות API:

   לדף 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. לוחצים על Activate now (הפעלה עכשיו) ופועלים לפי ההוראות.

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

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