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

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

בשאלות הנפוצות על מצב אקספרס ב-Google Cloud מוסבר בהרחבה על Agent Platform במצב אקספרס.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

רק המודלים שמפורטים בטבלה שלמעלה נתמכים במצב אקספרס. מודלים ייעודיים של 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 לא זמין במסוףCloud de Confiance במצב אקספרס. כדי להשתמש במודלים נתמכים של Gemini Live API, צריך לשדרג מחשבון במצב אקספרס לחשבון רגיל Cloud de Confiance.

תהליך העבודה של 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.

   במסוף Cloud de Confiance במצב אקספרס, פותחים את 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 שזמינות במצב אקספרס, קראו את מאמרי העזרה של Agent Platform במצב אקספרס API בארכיטקטורת REST.

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

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

כששולחים בקשות 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 במסוף Cloud de Confiance :

   לדף API Keys

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

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

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

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

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

   מעבר אל Agent Studio

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

   לדף החיוב

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

להתחיל להשתמש בכל היכולות והשירותים של Cloud de Confiance by S3NS

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

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

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

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