הערה: חבילת המסמכים הזו מיועדת למהדורות Standard,‏ Plus,‏ תשלום לפי שימוש ו-Frontline של Gemini Enterprise. לעיון במסמכי התיעוד של מהדורת Business, אפשר להיכנס אל מרכז העזרה של Gemini Enterprise – מהדורת Business.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

חיבור Antigravity לשער ארגוני

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

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

כלים וגרסאות נתמכים

‫Antigravity Enterprise Gateway תומך בכלים הבאים למפתחי AI:

כלי	גרסת מינימום	פלטפורמות נתמכות
אפליקציית Antigravity	‫2.15.0 ואילך	‫macOS (‏Apple silicon arm64, ‏Intel x86_64), ‏Windows 10 או 11 (64-bit), ‏Linux (‏x86_64)
‫Antigravity CLI ‏ (`agy`)	‫1.2.15 ואילך	‫macOS‏ (arm64), ‏ Linux‏ (x86_64)
‫Antigravity לסביבות פיתוח משולבות (IDE)	‫Visual Studio Code ו-Visual Studio: גרסה 1.2.15 ומעלה של Antigravity CLI, שהתוסף מוריד ומעדכן באופן אוטומטי. ‫JetBrains IDEs ו-Zed (עם שרת ACP): גרסה 1.3.0 ואילך	‫Visual Studio Code,‏ Visual Studio,‏ JetBrains IDEs ו-Zed. מידע נוסף על תוספי IDE זמין במאמר תוספי Antigravity IDE.

בחירת שיטת הגדרה

ההגדרה של Antigravity תלויה באופן הניהול של סביבת הפיתוח:

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

תחנות עבודה ארגוניות מנוהלות

אם החברה מנהלת את המחשב שלכם באמצעות כלי לניהול מכשירים ניידים (MDM), האדמין פורס קובץ admin_settings.json במערכת ההפעלה.

כשפותחים את אפליקציית Antigravity, מריצים את Antigravity CLI או משתמשים ב-Antigravity בסביבות פיתוח משולבות (IDE) נתמכות (Visual Studio Code,‏ Visual Studio,‏ JetBrains IDEs ו-Zed),‏ Antigravity מזהה באופן אוטומטי את ההגדרות האלה ומנתב את הבקשות לשער הארגוני בלי להציג בקשות כניסה נפרדות. אין צורך בהגדרה ידנית.

סביבות, קונטיינרים וארגזי חול בהתאמה אישית

אם אתם עובדים בסביבה לא מנוהלת, כמו מכונה וירטואלית לפיתוח מרחוק, קונטיינר של Docker, מריץ CI/CD אוטומטי או IDE מקומי שלא מנוהל על ידי MDM, אתם צריכים להגדיר את Antigravity על ידי הגדרת משתני סביבה או עדכון של הגדרת הסוכן של ה-IDE.

בטבלה הבאה מתוארים משתני הסביבה שמשמשים להגדרת מצב השער:

משתנה	חובה	תיאור
`AGY_LLM_GATEWAY_URL`	כן	כתובת ה-URL מסוג HTTPS של שער הארגון.
`AGY_LLM_GATEWAY_API_KEY`	כן	מפתח ה-API שהשער שלכם מנפיק. אתם יכולים לקבל את המפתח הזה מהאדמין.
`AGY_LLM_GATEWAY_WIRE_PROTOCOL`	לא	פרוטוקול ה-wire של ה-API. מגדירים את הערך `genai` (ברירת המחדל) לפרוטוקול Gemini API, או את הערך `openai` לפרוטוקול OpenAI Chat Completions.
`AGY_LLM_GATEWAY_CA_CERT`	לא	הנתיב לחבילת אישורי ה-CA הבסיסיים של הארגון. אם המשתנה הזה לא מוגדר, Antigravity משתמש במשתנה הרגיל `SSL_CERT_FILE`.
`AGY_LLM_GATEWAY_MODELS`	לא	רשימה מופרדת בפסיקים של מודלים מותרים.
`AGY_LLM_GATEWAY_HEADERS`	לא	כותרות HTTP בהתאמה אישית, בפורמט `KEY: VALUE`, מופרדות בפסיקים או במעברי שורה. אפשר להשתמש בכותרות האלה כדי לעקוב אחרי מרכזי עלות.

תצורות לדוגמה

בדוגמאות הבאות מוסבר איך להגדיר משתני סביבה של Antigravity Enterprise Gateway לסביבות פיתוח שונות:

מעטפת אינטראקטיבית

בדוגמה הבאה מוסבר איך להגדיר משתני סביבה של שער בפרופיל ההפעלה של המעטפת (כמו ~/.bashrc או ~/.zshrc) לסשנים אינטראקטיביים של מסוף ולתוספים של סביבת פיתוח משולבת (IDE) שמשתלבים עם Antigravity CLI (כמו Visual Studio Code ו-Visual Studio):

# Configure Antigravity Enterprise Gateway
export AGY_LLM_GATEWAY_URL="https://gateway.cymbal.com"
export AGY_LLM_GATEWAY_API_KEY="GATEWAY_API_KEY"
export AGY_LLM_GATEWAY_WIRE_PROTOCOL="genai"
export AGY_LLM_GATEWAY_CA_CERT="/etc/ssl/certs/cymbal-root-ca.pem"
export AGY_LLM_GATEWAY_HEADERS="X-Cost-Center: Platform-Engineering"
export AGY_LLM_GATEWAY_MODELS="gemini-3.8-flash,gemini-3.7-flash,gemini-3.1-pro-preview"

בדוגמה הזו:

‫AGY_LLM_GATEWAY_URL: מגדירה את נקודת הקצה (endpoint) מסוג HTTPS של שער הארגון (https://gateway.cymbal.com).
‫AGY_LLM_GATEWAY_API_KEY: מגדיר את מפתח ה-API‏ (GATEWAY_API_KEY) שנדרש לשער.
‫AGY_LLM_GATEWAY_WIRE_PROTOCOL: מגדיר את פרוטוקול ה-API ל-genai (ברירת המחדל) לפרוטוקול Gemini API, או ל-openai לפרוטוקול OpenAI Chat Completions.
‫AGY_LLM_GATEWAY_CA_CERT: מגדירה את הנתיב לחבילת אישורי ה-CA ברמה הבסיסית (root) של הארגון, כדי ש-Antigravity יסמוך על אישור ה-TLS של השער.
‫AGY_LLM_GATEWAY_HEADERS: מוסיף כותרת מותאמת אישית שהשער יכול להשתמש בה כדי לשייך את השימוש למרכז העלות של הצוות.
‫AGY_LLM_GATEWAY_MODELS: מגדיר את המודלים שאפשר לבחור. למידע נוסף על המודלים הזמינים, עיינו ברשימת המודלים הנתמכים.

כדי להחיל את השינויים, טוענים מחדש את פרופיל המעטפת:

source ~/.bashrc

מאגר Docker

בדוגמה הבאה, Dockerfile מגדיר את החיבור לשער לסביבות פיתוח בקונטיינרים ולמריצים אוטומטיים של CI/CD:

FROM ubuntu:24.04

# Install prerequisites and Antigravity CLI (v1.2.15 or later)
RUN apt-get update && apt-get install -y curl ca-certificates
RUN curl -fsSL https://antigravity.google/cli/install.sh -o /tmp/install.sh \
    && bash /tmp/install.sh \
    && rm -f /tmp/install.sh

# Copy corporate root CA certificate
COPY certs/cymbal-root-ca.pem /usr/local/share/ca-certificates/cymbal-root-ca.crt
RUN update-ca-certificates

# Configure gateway connection
ENV AGY_LLM_GATEWAY_URL="https://gateway.cymbal.com" \
    AGY_LLM_GATEWAY_WIRE_PROTOCOL="genai" \
    AGY_LLM_GATEWAY_CA_CERT="/etc/ssl/certs/cymbal-root-ca.pem" \
    AGY_LLM_GATEWAY_MODELS="gemini-3.8-flash,gemini-3.1-pro-preview"

# Provide API key securely at runtime using container secrets or runtime env
ENTRYPOINT ["agy"]

בדוגמה הזו:

קובץ האימג' של הקונטיינר מתקין את Antigravity CLI ומוסיף את אישור ה-CA הבסיסי של הארגון למאגר האישורים של המערכת.
הגדרות חיבור לא רגישות (AGY_LLM_GATEWAY_URL,‏ AGY_LLM_GATEWAY_WIRE_PROTOCOL,‏ AGY_LLM_GATEWAY_CA_CERT ו-AGY_LLM_GATEWAY_MODELS) מוגדרות כמשתני סביבה.
מפתח ה-API‏ (AGY_LLM_GATEWAY_API_KEY) לא מאוחסן בתמונה. במקום זאת, צריך לספק אותו בזמן הריצה באמצעות סודות של קונטיינרים או ארגומנטים של סביבה (לדוגמה, docker run -e AGY_LLM_GATEWAY_API_KEY=...).

סביבות פיתוח משולבות (IDE) של JetBrains

סביבות הפיתוח המשולבות (IDE) של JetBrains מתקשרות עם Antigravity דרך שרת Antigravity Agent Client Protocol‏ (ACP). מכיוון שסביבות פיתוח משולבות למחשב לא קוראות פרופילים של הפעלת מעטפת כמו ~/.bashrc, צריך להגדיר את הגדרות השער בהגדרות של סוכן סביבת הפיתוח המשולבת:

ב-~/.jetbrains/acp.json, מגדירים את שרת הסוכן של Antigravity עם משתני הסביבה של השער:

{
  "agent_servers": {
    "Antigravity": {
      "command": "PATH_TO_ACP_SERVER",
      "env": {
        "AGY_LLM_GATEWAY_URL": "https://gateway.cymbal.com",
        "AGY_LLM_GATEWAY_API_KEY": "GATEWAY_API_KEY",
        "AGY_LLM_GATEWAY_CA_CERT": "/etc/ssl/certs/cymbal-root-ca.pem",
        "AGY_LLM_GATEWAY_HEADERS": "X-Cost-Center: Platform-Engineering",
        "AGY_LLM_GATEWAY_MODELS": "gemini-3.8-flash,gemini-3.7-flash,gemini-3.1-pro-preview"
      }
    }
  }
}

מחליפים את PATH_TO_ACP_SERVER בנתיב לקובץ הבינארי של agy_acp_server.

ב-~/.gemini/antigravity-acp/settings.json (או ב-$GEMINI_HOME/antigravity-acp/settings.json אם GEMINI_HOME מוגדר), מפעילים את האימות של השער:
```
{
  "auth": {
    "type": "gateway"
  }
}
```
הערה: בניגוד ל-Antigravity CLI, הגדרת AGY_LLM_GATEWAY_URL לבד לא מפעילה את הניתוב של השער בשרת ACP. צריך להגדיר את "auth": { "type": "gateway" }.
מפעילים מחדש את JetBrains IDE.

Zed

‫Zed מתקשר עם Antigravity דרך שרת Antigravity Agent Client Protocol‏ (ACP). בגלל שסביבות פיתוח משולבות למחשב לא קוראות פרופילים של הפעלת מעטפת כמו ~/.bashrc, צריך לקבוע את הגדרות השער בקובץ ההגדרות של Zed:

בקובץ settings.json של Zed, מוסיפים את שרת הסוכן Antigravity עם משתני הסביבה של השער בקטע agent_servers:

{
  "agent_servers": {
    "Antigravity": {
      "command": "PATH_TO_ACP_SERVER",
      "env": {
        "AGY_LLM_GATEWAY_URL": "https://gateway.cymbal.com",
        "AGY_LLM_GATEWAY_API_KEY": "GATEWAY_API_KEY",
        "AGY_LLM_GATEWAY_CA_CERT": "/etc/ssl/certs/cymbal-root-ca.pem",
        "AGY_LLM_GATEWAY_HEADERS": "X-Cost-Center: Platform-Engineering",
        "AGY_LLM_GATEWAY_MODELS": "gemini-3.8-flash,gemini-3.7-flash,gemini-3.1-pro-preview"
      }
    }
  }
}

מחליפים את PATH_TO_ACP_SERVER בנתיב לקובץ הבינארי של agy_acp_server.

ב-~/.gemini/antigravity-acp/settings.json (או ב-$GEMINI_HOME/antigravity-acp/settings.json אם GEMINI_HOME מוגדר), מפעילים את האימות של השער:
```
{
  "auth": {
    "type": "gateway"
  }
}
```
הערה: בניגוד ל-Antigravity CLI, הגדרת AGY_LLM_GATEWAY_URL לבד לא מפעילה את הניתוב של השער בשרת ACP. צריך להגדיר את "auth": { "type": "gateway" }.
מפעילים מחדש את Zed.

אימות החיבור

אחרי שמגדירים את הסביבה, מוודאים ש-Antigravity מתחבר לשער הארגוני:

בודקים את אפליקציית Antigravity:
- בשורת הסטטוס התחתונה, מוודאים שסטטוס החיבור הוא Connected: Enterprise Gateway.
- בקטע Account Settings, מוודאים שמוצג הסטטוס Enterprise Gateway Mode Active.
בודקים את Antigravity CLI: מריצים הנחיה לבדיקה בטרמינל:
```
agy -p "Explain binary search in Go"
```
התשובה מוצגת בטרמינל בלי לפתוח חלון דפדפן או לבקש מכם להיכנס לחשבון Google .

אבטחת תחנות עבודה והרצה מקומית בארגז חול (sandbox)

ניתוב הבקשות דרך שער ארגוני לא משנה את האופן שבו Antigravity מגן על תחנת העבודה:

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

פתרון בעיות

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

הודעת השגיאה	מטרה	איך לפתור את הבעיה
`x509: certificate signed by unknown authority`	הסביבה שלכם לא נותנת אמון באישור ה-TLS של השער.	מגדירים את `AGY_LLM_GATEWAY_CA_CERT` לנתיב של חבילת ה-CA ברמה הבסיסית (root) של הארגון.
`401 Unauthorized`	שער התשלומים דחה את מפתח ה-API שלכם.	מוודאים שהמפתח `AGY_LLM_GATEWAY_API_KEY` תואם למפתח שקיבלתם מהאדמין.
`404 Not Found`	המודל שביקשתם לא זמין בשער הארגוני, או שהקלדתם מזהה מודל שגוי.	מוודאים שמזהה המודל ב-`AGY_LLM_GATEWAY_MODELS` תואם למודל נתמך שזמין בשער.
הודעות של Antigravity לכניסה באמצעות חשבון Google	כתובת ה-URL של השער לא מוגדרת במעטפת או בהגדרות ה-IDE הנוכחיות.	בסביבות פיתוח משולבות (IDE) שמשולבות ב-CLI ובסשנים של מסוף, ודאו שהמשתנה `AGY_LLM_GATEWAY_URL` מוגדר בסביבה הנוכחית. ב-JetBrains IDE או ב-Zed, מוודאים שהערך `AGY_LLM_GATEWAY_URL` מועבר בבלוק `env` של הסוכן, ושהערך `"auth": { "type": "gateway" }` מוגדר ב-`~/.gemini/antigravity-acp/settings.json`.
שגיאה באזכור של `AGY_LLM_GATEWAY_URL` ב-JetBrains או ב-Zed	המשתנה `auth.type` מוגדר כ-`gateway` בהגדרות של ACP, אבל ה-IDE לא העביר את המשתנה לשרת של הנציג.	מוסיפים את `AGY_LLM_GATEWAY_URL` לבלוק `env` של הסוכן ב-`~/.jetbrains/acp.json` (JetBrains) או ב-`settings.json` (Zed), ולא לפרופיל המעטפת, ומפעילים מחדש את ה-IDE.
`gateway.wireProtocol 'openai' is not supported by the ACP server`	בהגדרות של `AGY_LLM_GATEWAY_WIRE_PROTOCOL` או של האדמין צוין פרוטוקול התקשורת `openai`, שלא נתמך בשרת ה-ACP.	צריך להגדיר את `AGY_LLM_GATEWAY_WIRE_PROTOCOL="genai"` בסביבה שלך או לבקש מהאדמין להגדיר את פרוטוקול התקשורת `genai` למשתמשי JetBrains ו-Zed.

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

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