הגדרת ההגדרות של כלי AI למפתחים

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

לפני שמתחילים

חשוב לוודא שיש לכם את הפריטים הבאים:

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

  • מהדורות נתמכות: כדי לגשת לכלי למפתחים מבוססי-AI, למשתמשים צריך להיות מינוי למהדורת Gemini Enterprise Standard, ‏Plus, ‏Standard Emerging Market או תשלום לפי שימוש.

  • אזורים נתמכים: מידע נוסף על הזמינות באזורים ועל מגבלות התכונות מופיע במאמר מיקום אחסון הנתונים במהדורות Gemini Enterprise Standard ו-Plus וב-Gemini Notebook.

  • תפקידים נדרשים: כדי לקבוע את ההגדרות של כלי למפתחים מבוססי-AI, צריך להיות לכם התפקיד אדמין ב-Gemini Enterprise (roles/discoveryengine.agentspaceAdmin).

  • ממשקי ה-API הנדרשים: בפרויקט צריך להפעיל את ממשקי ה-API הבאים:

    • ‫Discovery Engine API ‏(discoveryengine.googleapis.com): מספק שירותי פלטפורמה מרכזיים, אמצעי בקרה לאבטחה ולתאימות וניהול הגדרות ל-Gemini Enterprise.
    • ‫Business AI Code API ‏(businessaicode.googleapis.com): מספק יצירת קוד מבוסס-AI ל-Antigravity ב-Gemini Enterprise. כדי לאפשר לחשבונות משתמשים מורשים להגיע לשירות מהפרויקט, צריך להפעיל את ה-API הזה בפרויקט.

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

הפעלת כלי ה-AI למפתחים

הזמינות של כלי הפיתוח מבוססי ה-AI תלויה בסוג המינוי שלכם ל-Gemini Enterprise:

  • מינויים חדשים ל-Standard, ל-Plus או לתשלום לפי שימוש: כלי למפתחים מבוססי-AI מופעלים כברירת מחדל במיקום שבו רכשתם את המינוי, אם יש תמיכה במיקום או באזור הזה.

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

כדי להפעיל באופן ידני את כלי הפיתוח מבוססי ה-AI במינוי קיים ל-Gemini Enterprise, צריך לבצע את השלבים הבאים:

  1. במסוף Google Cloud , נכנסים לדף Gemini Enterprise.

    אל Gemini Enterprise

  2. לוחצים על הגדרות ובוחרים בכרטיסייה כלי למפתחי AI.

  3. מפעילים את המתג כלי AI למפתחים.

  4. קובעים את ההגדרות בקטעים אבטחה, תאימות, תכונות וזמינות המודל.

קבע הגדרות אבטחה

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

ניהול מדיניות אבטחה

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

הגדרה תיאור סטטוס ברירת המחדל
מחוץ למדיניות הגישה לקבצים מציינים את רמת ההרשאה של הנציג לגישה לקבצים מחוץ לתיקיות העבודה שהוקצו לו. אלה האפשרויות הזמינות:
  • ‫Deny: מונעת מהסוכן לגשת לקבצים מחוץ לתיקיות העבודה שלו.
  • תמיד לשאול: המשתמש מתבקש לתת הרשאה לפני שהסוכן ניגש לקבצים מחוץ לתיקיות העבודה שלו.
  • Allow: הסוכן יכול לגשת לקבצים מחוץ לתיקיות העבודה שלו בלי להציג בקשה.
דחייה
מצב הרצה אוטומטית מהטרמינל כשההגדרה הזו מופעלת, הסוכנים יכולים להריץ פקודות טרמינל באופן אוטומטי כדי לייעל תהליכי עבודה מרובי-שלבים. אלה האפשרויות הזמינות:
  • דרישת בדיקה: המשתמש מתבקש לאשר לפני הפעלת פקודת מסוף כלשהי.
  • ‫Proceed in sandbox: הפקודות מופעלות באופן אוטומטי בסביבה מאובטחת ומבודדת.
  • ‫Always proceed: הפקודות מופעלות באופן אוטומטי בסביבה הנוכחית בלי להציג בקשה.
תמיד להמשיך
מצב ארגז חול (sandbox) כדאי להפעיל את ההגדרה הזו כדי להגביל את כלי הנציג לארגז חול מקומי, מאובטח ומבודד. מושבת

ניהול הגישה לאינטרנט החיצוני

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

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

ההגדרה הזו חלה רק על סוכן הדפדפן Antigravity. כדי להפעיל את סוכן הדפדפן ב-Antigravity, מקלידים את הפקודה /browser בשדה הצ'אט.

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

ניהול Model Context Protocol‏ (MCP)

אתם יכולים להגדיר גישה לשרתי Model Context Protocol‏ (MCP), שמאפשרים לסוכני AI לגשת בצורה מאובטחת למקורות נתונים ולכלים נוספים.

הגדרה תיאור סטטוס ברירת המחדל
שרתי MCP צריך להפעיל את ההגדרה הזו כדי לנהל את הגישה לשרתים של Model Context Protocol ‏(MCP) ולהרחיב בצורה מאובטחת את הקשר הנתונים של ה-AI.

צריך להשתמש ב-MCP כדי להשתמש בסביבות פיתוח משולבות (IDE) שתומכות ב-Agent Client Protocol ‏(ACP), כמו Android Studio ו-JetBrains IDE. בסביבות כאלה, אמצעי הבקרה של האדמינים פועלים כמיטב יכולתם, כי סביבות הפיתוח המשולבות יכולות להחדיר כלי MCP משלהן שלא כפופים לאכיפה.

מושבת
הגדרת שרת מותרת ההגדרה הזו מאפשרת לאדמינים לקבוע הגדרות ספציפיות לשרתים כדי לגשת לשרת MCP. האדמינים מגדירים את רשימת ההיתרים כאובייקט JSON עם הגדרות לשרתי MCP מקומיים ומרוחקים. בממשק המשתמש מתבצע אימות בזמן אמת של השדות הבאים:
  • שרתי MCP מקומיים (local_servers):
    • ‫id (מחרוזת): המזהה הייחודי של שרת ה-MCP.
    • ‫command (מחרוזת, אופציונלי): הפקודה להפעלת שרת ה-MCP המקומי. אם מציינים ערך, הוא מבטל את ההגדרה המקומית של המשתמש.
    • ‫args (מערך של מחרוזות, אופציונלי): הארגומנטים שמועברים לפקודה. אם מציינים אותם, הם מבטלים את ההגדרות המקומיות של המשתמש.
  • שרתי MCP מרוחקים (remote_servers):
    • ‫id (מחרוזת): המזהה הייחודי של שרת ה-MCP.
    • ‫url (מחרוזת, אופציונלי): כתובת ה-URL של נקודת הקצה של שרת ה-MCP המרוחק. חובה לשרתים מרוחקים בהתאמה אישית, ואופציונלי לשרתים מרוחקים שהוגדרו מראש.

הגדרה לדוגמה

{
  "mcpServers": {
    "local_servers": [
      {
        "id": "gopls-mcp-server",
        "command": "go",
        "args": [
          "run",
          "golang.org/x/tools/gopls@latest",
          "mcp"
        ]
      }
    ],
    "remote_servers": [
      {
        "id": "bigquery"
      },
      {
        "id": "custom-remote-server",
        "url": "https://mcp.example.com/mcp"
      }
    ]
  }
}
לא מוגדר

קביעת הגדרות תאימות

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

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

קביעת הגדרות התכונה

חלק מהתכונות של Antigravity מציעות יכולות אג'נטיות מתקדמות, כדי לעזור למפתחים להתמודד עם משימות מורכבות. התכונות האלה יכולות להגדיל את השימוש בטוקנים ואת העלויות, לכן כדאי להשתמש בהגדרות שבקטע הזה כדי לקבוע את הגישה של המשתמשים בארגון. כדי לגשת לתכונות שהופעלו, המשתמשים צריכים להשתמש באפליקציית Antigravity בגרסה 2.18.0 ואילך, או ב-Antigravity CLI בגרסה 1.2.10 ואילך. כדי להשתמש בפקודה /swarm, צריך להתקין את אפליקציית Antigravity בגרסה 2.32.0 ואילך, או את Antigravity CLI בגרסה 1.5.7 ואילך.

כדי להפעיל או להשבית תכונה, פועלים לפי השלבים הבאים:

  1. במסוף Google Cloud , נכנסים לדף Gemini Enterprise.

    Gemini Enterprise

  2. לוחצים על הגדרות ובוחרים בכרטיסייה כלי למפתחי AI.

  3. בקטע תכונות, לוחצים על עריכה.

  4. מפעילים או משביתים את המתג של כל אחת מהתכונות.

    הגדרה תיאור סטטוס ברירת המחדל
    הפקודה /boost כשההגדרה הזו מופעלת, המשתמשים יכולים להריץ היררכיה מדורגת של כמה סוכנים כדי לפתור אתגרים אלגוריתמיים מורכבים ולבצע משימות ניפוי באגים מעמיקות. מידע נוסף זמין במאמר שיפור החשיבה המעמיקה. מופעל
    הפקודה /teamwork כדאי להפעיל את ההגדרה הזו כדי לאפשר למשתמשים לפרוס מסגרת מתואמת של סוכני משנה אוטונומיים לביצוע פרויקטים ארוכי טווח בקנה מידה גדול (גרסת טרום-השקה). מידע נוסף זמין במאמר צוותי סוכנים ב-Teamwork. בגרסאות קודמות של Antigravity, הפקודה הזו נקראת /teamwork-preview.

    ההגדרה הזו קובעת גם את הפקודה /swarm, שמאפשרת למשתמשים להפעיל צוות של סוכנים שמתואמים באמצעות לוח הודעות משותף. כשההגדרה הזו מושבתת, המשתמשים לא יכולים להשתמש באף אחת מהפקודות.

    מופעל
  5. לוחצים על Save.

הגדרת הזמינות של המודל

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

נקודות מרכזיות שצריך לשים לב אליהן לפני שמגדירים מודלים

לפני שאתם מגדירים מודלים, כדאי להביא בחשבון את הנקודות הבאות:

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

  • מיקום אחסון הנתונים: מודלים בגרסת טרום-השקה והמודל ליצירת תמונות Gemini 3 Pro זמינים רק באזור global. לכן, הם לא תומכים בהתחייבויות לגבי מיקום אחסון הנתונים (DRZ) או עיבוד אזורי של למידת מכונה (ML) בארה"ב או במספר אזורים באיחוד האירופי.

  • הסקה וטיפול בנתונים במודלים של צד שלישי: מודלים של צד שלישי זמינים רק אחרי שאדמין מפעיל אותם ומאשר את התנאים של הספק. כשמפתח בוחר מודל של צד שלישי שמופעל, Gemini Enterprise שולח למודל את ההנחיה ואת הקשר הקוד שנדרש לבקשה הזו, עם אותם עיבוד והגנות כמו במודלים של Gemini. ההנחיות והתשובות לא משמשות לאימון מודלים. הסקת מסקנות ממודלים של צד שלישי זמינה במיקומים global,‏ us ו-eu. אין תמיכה באזורים בתוך המדינה. כדי לראות את רשימת המדינות והאזורים שיש להם גישה למודל, עיינו במאמר של Anthropic בנושא מדינות ואזורים נתמכים. מידע נוסף על מיקום אחסון הנתונים זמין במאמר מיקום אחסון הנתונים במהדורות Gemini Enterprise Standard ו-Plus וב-Gemini Notebook.

  • גילוי נאות לגבי ביצוע וחיוב משולבים: מודלים של Gemini מנצלים את הקרדיטים של המושבים במהדורה המשותפת של הארגון, ואילו מודלים של צד שלישי שהאדמין הפעיל מחויבים לפי שימוש בחשבון לחיוב ב-Cloud. כשמפתח בוחר מודל של צד שלישי שמופעל (כמו Anthropic Claude Opus 5.5 או Anthropic Claude Sonnet 5.5) למשימות העיקריות של הסקת מסקנות, תכנון, תזמור כלים ויצירת קוד, Antigravity ממשיך להשתמש במודלים קלים של Gemini ברקע לתיאום בצד הלקוח – כמו ניהול הקשר וסיכומים – וב-Gemini 3 Pro Image ליצירת תמונות. השימוש במודלים האלה עשוי להיות כרוך בחיובים. מידע נוסף זמין במאמרים מכסות ושימוש בתשלום לפי שימוש ומעקב אחרי השימוש בטוקנים של מודלים של צד שלישי.

הגדרת מודלים מורשים

אתם יכולים להגדיר מודלים מורשים כדי לקבוע אילו מודלים של AI יהיו זמינים לכלים למפתחים.

ההגדרה דגמים מורשים של Antigravity פועלת כרשימת היתרים:

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

כדי להגדיר מודלים מורשים:

  1. במסוף Google Cloud , נכנסים לדף Gemini Enterprise.

    אל Gemini Enterprise

  2. לוחצים על הגדרות ואז על הכרטיסייה כלי למפתחי AI.

  3. בקטע זמינות המודל, לוחצים על עריכה.

  4. בשדה מודלים מורשים של Antigravity, בוחרים את המודלים שרוצים לאשר. כדי לאשר את כל המודלים הנתמכים, משאירים את השדה ריק.

  5. לוחצים על Save.

הגדרה תיאור סטטוס ברירת המחדל
מודלים מורשים של Antigravity מציינים באילו מודלים של AI מותר לכלי Antigravity להשתמש בפרויקט. כדי לאפשר את כל מודלי Gemini הנתמכים, צריך להשאיר את השדה ריק. אם מציינים רשימה מותאמת אישית של מודלים, ההגדרה פועלת כרשימת היתרים, וצריך להוסיף באופן ידני מודלים חדשים או מודלים שלא נבחרו כדי שיהיו זמינים. בנוסף למודלים של Gemini שנוצרו על ידי Google, האדמינים יכולים להביע הסכמה להפעלת מודלים של צד שלישי, כולל Anthropic Claude Opus 5.5 ו-Anthropic Claude Sonnet 5.5. מידע על היכולות, המגבלות והערכות הבטיחות של כל מודל מופיע בכרטיסי המידע של Anthropic Claude Opus 5.5 ו-Anthropic Claude Sonnet 5.5. ריק (כל מודלי Gemini מותרים). מודלים של צד שלישי מושבתים כברירת מחדל וצריך לקבל את הסכמת האדמין כדי להפעיל אותם.

מודלים נתמכים

כלי פיתוח מבוססי-AI (אפליקציית Antigravity, Antigravity CLI ו-Antigravity לסביבות פיתוח משולבות) תומכים במודלים הבאים של Gemini ובמודלים של שותפים. משתמש עם רישיון הוא מפתח שהוקצה לו רישיון מושב פעיל ל-Gemini Enterprise (בתוכנית Standard,‏ Plus או תשלום על פי שימוש). מידע נוסף על ניהול רישיונות

השם המוצג של המודל ספק זמינות ב-Gemini Enterprise
‫Gemini 4 Hydrogen Google האפשרות מופעלת כברירת מחדל למשתמשים עם רישיון כשבחירת המודל שמוגדר כברירת מחדל פעילה (רשימה ריקה). אם מוגדרת רשימת מודלים בהתאמה אישית, צריך לבחור את המודל באופן ידני.
Gemini 4 Carbon Google האפשרות מופעלת כברירת מחדל למשתמשים עם רישיון כשבחירת המודל שמוגדר כברירת מחדל פעילה (רשימה ריקה). אם מוגדרת רשימת מודלים בהתאמה אישית, צריך לבחור את המודל באופן ידני.
‫Gemini 4 Argon Google האפשרות מופעלת כברירת מחדל למשתמשים עם רישיון כשבחירת המודל שמוגדר כברירת מחדל פעילה (רשימה ריקה). אם מוגדרת רשימת מודלים בהתאמה אישית, צריך לבחור את המודל באופן ידני.
Gemini 3.8 Flash Google ההגדרה מופעלת כברירת מחדל למשתמשים עם רישיון כשבחירת המודל שמוגדר כברירת מחדל פעילה. אם מוגדרת רשימת מודלים בהתאמה אישית, צריך לבחור את המודל באופן ידני.
Gemini 3.7 Flash Google ההגדרה מופעלת כברירת מחדל למשתמשים עם רישיון כשבחירת המודל שמוגדר כברירת מחדל פעילה. אם מוגדרת רשימת מודלים בהתאמה אישית, צריך לבחור את המודל באופן ידני.
‫Gemini 3.6 Flash Google ההגדרה מופעלת כברירת מחדל למשתמשים עם רישיון כשבחירת המודל שמוגדר כברירת מחדל פעילה. אם מוגדרת רשימת מודלים בהתאמה אישית, צריך לבחור את המודל באופן ידני.
‫Gemini 3.1 Pro (גרסת טרום-השקה ‒ Preview) Google ההגדרה מופעלת כברירת מחדל למשתמשים עם רישיון כשבחירת המודל שמוגדר כברירת מחדל פעילה. אם מוגדרת רשימת מודלים בהתאמה אישית, צריך לבחור את המודל באופן ידני.
Anthropic Claude Opus 5.5 Anthropic מושבתת כברירת מחדל. האדמין צריך להביע הסכמה (ראו הפעלה או השבתה של מודלים של צד שלישי).
Anthropic Claude Sonnet 5.5 Anthropic מושבתת כברירת מחדל. האדמין צריך להביע הסכמה (ראו הפעלה או השבתה של מודלים של צד שלישי).

מידע נוסף על מכסות וקרדיטים משותפים למהדורות זמין במאמרים מכסות ותשלום לפי שימוש והגדרת תשלום לפי שימוש אחרי שחורגים מהמכסה. כדי לראות את המחירים של מודלים של צד שלישי, עיינו במק"טים של החיוב ב-Cloud עבור Anthropic Claude Opus 5.5 ו-Anthropic Claude Sonnet 5.5.

רמת החשיבה במודלים של צד שלישי

מפתחים יכולים להשתמש במודלים Anthropic Claude Opus 5.5 ו-Anthropic Claude Sonnet 5.5 ברמת חשיבה נמוכה, בינונית, גבוהה או מקסימלית. כל רמה מופיעה כרשומה נפרדת בבורר המודלים, לדוגמה Anthropic Claude Opus 5.5 (High). בינוני היא ברירת המחדל. כשמפעילים מודל של צד שלישי, כל רמות החשיבה שלו זמינות למפתחים. אי אפשר להגביל רמות חשיבה ספציפיות.

הפעלה או השבתה של מודלים של צד שלישי

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

כדי להפעיל או לנהל מודלים של צד שלישי (כמו Anthropic Claude Opus 5.5 ו-Anthropic Claude Sonnet 5.5) במסוף Google Cloud :

  1. במסוף Google Cloud , נכנסים לדף Gemini Enterprise.

    אל Gemini Enterprise

  2. לוחצים על הגדרות ואז על הכרטיסייה כלי למפתחי AI.

  3. בהגדרה מודלים מורשים של Antigravity, מפעילים את המתג של המודל של הצד השלישי שרוצים להפעיל.

  4. בתיבת הדו-שיח המוטמעת של התנאים וההגבלות שמופיעה, קוראים ומאשרים את התנאים של הצד השלישי.

אם משביתים מודל של צד שלישי, המפתחים מאבדים את הגישה אליו זמן קצר לאחר מכן.

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

במאמרי העזרה של Antigravity Enterprise מוסבר למפתחים איך להיכנס ל-Antigravity ולבחור מודלים.

שיקולי אבטחה במודלים של צד שלישי

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

  • הבעת הסכמה של אדמינים: מודלים של צד שלישי מושבתים כברירת מחדל. המפתחים יכולים להשתמש במודל של צד שלישי רק אחרי שהאדמין מפעיל אותו.
  • אמצעי הגנה של הספק: מודלים של צד שלישי כוללים את אמצעי ההגנה המובנים של הספק. מידע נוסף זמין במאמר בטיחות ב-Claude.
  • מדיניות האבטחה: מדיניות האבטחה וההגדרות של גישה לאינטרנט חיצוני שאתם קובעים חלות על הסוכנים, בלי קשר למודל שהמפתח בוחר.

שיטות מומלצות

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

פתרון בעיות

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

פתרון בעיות בהפעלת כלי AI למפתחים

אם אתם לא מצליחים להפעיל את כלי הפיתוח מבוססי ה-AI או לקבוע את ההגדרות במסוףGoogle Cloud , או אם המפתחים מקבלים את השגיאה No license available for this project and location כשהם נכנסים ל-Google Antigravity, בדקו את הדרישות הבאות:

המחאה רזולוציה
זכאות למינוי ולחיוב מוודאים שבפרויקט Google Cloud ובמיקום במספר אזורים (global,‏ us או eu) שנבחרו יש מינוי פעיל ל-Gemini Enterprise (לא מינוי לתקופת ניסיון) (Standard,‏ Plus,‏ Standard Emerging Market או Pay-as-you-go), ושהם מקושרים לחשבון משודרג לחיוב בממשק בניהול עצמי (אונליין), לחשבון לחיוב ב-Cloud שמחויב באמצעות חשבוניות או לחשבון משני לחיוב של חשבון לחיוב באמצעות חשבוניות. מינויים לתקופת ניסיון בחינם כוללים כלים למפתחי AI, עם מכסה מוגבלת, רק אם הפרויקט מקושר לחשבון לחיוב באמצעות חשבוניות. אם החשבון לחיוב עדיין ב Google Cloud תקופת הניסיון בחינם, שדרגו אותו לחשבון לחיוב בתשלום כדי להשתמש בכלי למפתחים של AI. אי אפשר להשתמש בקרדיטים ששולמו מראש בחשבונות משנה שמנוהלים על ידי מפיצים. לשגיאות שקשורות לחיוב, קראו את המאמר פתרון בעיות שקשורות לחיוב.
הקצאת מושבים ובחירת פרויקטים מוודאים שהמפתחים בוחרים את הפרויקט Google Cloud שבו הרישיונות מופצים כשהם נכנסים לחשבון, ושיש מקומות פנויים במינוי במיקום שנבחר. אם כל המושבים הוקצו, צריך להוסיף מושבים למינוי או להקצות מושב למשתמש בדף ניהול משתמשים.
מתג כלי ה-AI למפתחים במינויים קיימים, אדמין צריך להפעיל ידנית את המתג כלי פיתוח מבוססי-AI בקטע Gemini Enterprise‏ > הגדרות > כלי פיתוח מבוססי-AI לכל מיקום במספר אזורים (global,‏ us או eu). מידע נוסף זמין במאמר הפעלת כלי פיתוח מבוססי-AI.
לקוח Antigravity נתמך מוודאים שהמפתחים משתמשים בלקוח שנתמך ברמת הארגון: אפליקציית Antigravity, ‏Antigravity CLI (agy), ‏Antigravity לסביבות פיתוח משולבות (Visual Studio Code, ‏Visual Studio, ‏JetBrains IDEs, ‏Zed ו-Xcode) או Android Studio. מידע נוסף זמין במאמר סקירה כללית של כלי למפתחי AI.
התפקיד הנדרש ב-IAM מקצים למשתמשים את התפקיד Gemini Enterprise User (roles/discoveryengine.agentspaceUser) בפרויקט, או תפקיד בהתאמה אישית עם הרשאות לכלי פיתוח מבוססי-AI. תפקיד האדמין (roles/discoveryengine.agentspaceAdmin) לבדו לא מעניק למשתמש הקצה גישה למפתחים.
חסר סוכן שירות אם בקשות של כלי למפתחים מבוססי-AI נכשלות עם השגיאה Service agent SERVICE_AGENT_EMAIL not found, צריך ליצור מחדש את סוכן השירות כמו שמתואר במאמר תיקון סוכן שירות חסר.

תיקון סוכן שירות חסר

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

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

Service agent SERVICE_AGENT_EMAIL not found.

כדי לתקן את השגיאה, צריך ליצור מחדש את סוכן השירות באחת מהשיטות הבאות.

שימוש במסוף Google Cloud

  1. במסוף Google Cloud , נכנסים לדף Gemini Enterprise.

    אל Gemini Enterprise

  2. לוחצים על הגדרות ובוחרים בכרטיסייה כלי למפתחי AI.

  3. משביתים את המתג כלי AI למפתחים.

  4. מפעילים שוב את המתג כלי AI למפתחים.

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

שימוש ב-CLI של gcloud

  1. יוצרים את סוכן השירות:

    gcloud beta services identity create \
        --service=businessaicode.googleapis.com \
        --project=PROJECT_ID
    

    מחליפים את PROJECT_ID במזהה הפרויקט.

    פלט הפקודה כולל את כתובת האימייל של סוכן השירות.

  2. מקצים לסוכן השירות את התפקיד Business AI Code Service Agent ‏(roles/businessaicode.serviceAgent). הפקודה gcloud beta services identity create לא מקצה את התפקיד הזה באופן אוטומטי.

    gcloud projects add-iam-policy-binding PROJECT_ID \
        --member="serviceAccount:SERVICE_AGENT_EMAIL" \
        --role="roles/businessaicode.serviceAgent"
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫PROJECT_ID: מזהה הפרויקט.
    • ‫SERVICE_AGENT_EMAIL: כתובת האימייל של סוכן השירות מהפלט של השלב הקודם או מהודעת השגיאה.

מידע נוסף זמין במאמר gcloud beta services identity create.

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