חיבור OpenAI Codex ל-Google Cloud

גרסת טרום-השקה (Preview) פרטית

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

אתם יכולים להגדיר את OpenAI Codex CLI ואת Codex Desktop App כך שינתבו את הבקשות למודל דרך הפרויקט שלכם ב- Google Cloud ב-Agent Platform.

‫Codex פועל באופן מקומי בתחנת העבודה שלכם לפיתוח, ומבצע אימות באמצעותGoogle Cloud ניהול זהויות והרשאות גישה (IAM) תוך שימוש במכסות המאושרות שלכם ב-Marketplace.

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

כדי להשתמש ב-OpenAI Codex עם Gemini Enterprise Agent Platform, צריך לבצע את השלבים הבאים. ‫Gemini Enterprise Agent Platform API‏ (aiplatform.googleapis.com) צריך להיות מופעל בפרויקט ב- Google Cloud .

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

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Gemini Enterprise Agent Platform API, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Gemini Enterprise Agent Platform API, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

1. משלימים את שלבי ההגדרה ב-OpenAI GPT Models, כולל רכישת המוצר דרך Google Cloud Marketplace והפעלת המודל ב-Model Garden.

2. אם המדיניות של הארגון מגבילה את הגישה למודל, צריך לאשר את המודל במדיניות הזו.

3. מתקינים את ה-CLI של Google Cloud ומגדירים את Application Default Credentials ‏(ADC):

   gcloud auth application-default login

4. מתקינים את OpenAI Codex CLI או את אפליקציית Codex למחשב בתחנת העבודה.

התפקידים הנדרשים

כדי לקבל את ההרשאות שנדרשות לחיבור Codex למודלים של שותפי OpenAI, צריך לבקש מהאדמין להקצות לכם את התפקיד משתמש בפלטפורמת Agent (roles/aiplatform.user) ב-IAM בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

הגדרה אינטראקטיבית

אתם יכולים להגדיר את Codex באופן אינטראקטיבי באמצעות תהליך הכניסה המובנה.

Codex CLI

1. מפעילים את codex בטרמינל:

   codex

2. בוחרים באפשרות Sign in another way ואז באפשרות Use Google Cloud (מוצגת בתור Use Google Cloud Vertex AI ב-CLI).

3. מזינים את מזהה הפרויקט ב- Google Cloud .

4. מזינים את המיקום או לוחצים על Enter כדי לאשר את global.

5. מקישים על Enter כדי להשתמש ב-Application Default Credentials במחשב, או מזינים נתיב מוחלט לקובץ JSON של פרטי כניסה לחשבון שירות.

אפליקציית Codex למחשב

1. פותחים את אפליקציית Codex למחשב.
2. לוחצים על כניסה בדרך אחרת ואז על שימוש ב-Google Cloud.
3. מזינים את מזהה הפרויקט ב- Google Cloud .
4. מזינים את המיקום או משאירים את השדה ריק כדי לאשר את global.
5. כדי להשתמש בפרטי כניסה של ברירת מחדל של אפליקציה, משאירים את נתיב פרטי הכניסה ריק. אחרת, בוחרים קובץ JSON של מפתח לחשבון שירות.
6. לוחצים על המשך ואז מאמתים את החיבור.

הגדרה ידנית של Codex

כדי להגדיר את Codex בלי ההנחיה האינטראקטיבית, מוסיפים את הגדרות הספק לקובץ ~/.codex/config.toml. מציבים את ההגדרה model_provider ברמה העליונה לפני כותרות הטבלה:

model_provider = "gcp"

[model_providers.gcp]
project_id = "PROJECT_ID"
location = "global"

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

• ‫<var>PROJECT_ID</var>: מזהה הפרויקט ב- Google Cloud (לדוגמה, my-project-123).

אם משתמשים בקובץ מפתח של חשבון שירות במקום ב-Application Default Credentials, מציינים את credential_file:

credential_file = "CREDENTIAL_FILE_PATH"

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

• ‫<var>CREDENTIAL_FILE_PATH</var>: הנתיב המוחלט לקובץ ה-JSON של המפתח של חשבון השירות שהורדתם (לדוגמה, /Users/myuser/.config/gcloud/sa-key.json).

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

משתני סביבה

אתם יכולים גם להשתמש במשתני סביבה במכונה המארחת של Codex כדי לקבוע או לשנות את ההגדרות:

• ‫GOOGLE_CLOUD_PROJECT: מגדיר את מזהה הפרויקט ב- Google Cloud , ומאפשר להשמיט את project_id מ-config.toml.
• ‫GOOGLE_CLOUD_LOCATION: משנה את מיקום נקודת הקצה (ברירת המחדל היא global).

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

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

1. מתחילים סשן חדש עם codex או יוצרים משימה חדשה ב-Codex Desktop.
2. מריצים את /model ב-CLI או פותחים את בורר המודלים ב-Codex Desktop.
3. בוחרים מודל שמופעל לעומס העבודה:
   • ‫gpt-6.1-sol: מודל הדגל של השותף לכתיבת קוד ולתהליכי עבודה מבוססי-סוכנים.
   • ‫gpt-6-luna: מודל שותף עם זמן אחזור קצר, שמיועד לעזרה אינטראקטיבית מהירה.
   • ‫gpt-6-astra: המודל הכי מתקדם של השותפים שלנו, שמיועד למשימות מורכבות שדורשות חשיבה רציונלית רב-שלבית.
   • ‫gpt-6.1-terra: מודל שותף מאוזן לאוטומציה עם תפוקה גבוהה.
4. שולחים הנחיה לבדיקה (למשל, "הצג את הקבצים בספרייה הנוכחית") כדי לוודא שהאימות ועיבוד הבקשה בוצעו בהצלחה.

תמיכה בתכונות ב-Codex

כשהוא מחובר ל-Agent Platform, ‏Codex משתמש ב-OpenAI Responses API. בטבלה הבאה מפורטות התכונות שנתמכות והתכונות שלא נתמכות:

תכונה	סטטוס התמיכה	תיאור
הרצה של מעטפת מקומית ו-Bash	נתמך	‫Codex מריץ פקודות מעטפת באופן מקומי במחשב הפיתוח שלכם, במסגרת גבולות הטרמינל שאושרו.
עריכה ותיקון של קבצים	נתמך	‫Codex קורא ומשנה קבצים באופן מקומי בתחנת העבודה שלכם.
‫Model Context Protocol‏ (MCP) מקומי	נתמך	שרתי MCP מקומיים שמוגדרים ב-~/.codex/config.toml פועלים בתחנת העבודה שלכם.
קריאה להפעלת פונקציות בצד הלקוח	נתמך	בקשות של כלים במודל נבדקות ומבוצעות באופן מקומי על ידי לקוח Codex.
חיפוש באינטרנט ובקבצים שמתארחים ב-Google	לא נתמך	כלי החיפוש של OpenAI שמתארחים ב-Agent Platform לא זמינים בנקודות הקצה של Agent Platform במהלך גרסת טרום-השקה (Preview) פרטית.
Hosted Code Interpreter	לא נתמך	ארגזי חול מרוחקים בענן שמתארחים ב-OpenAI לא זמינים. הרצת קוד מתבצעת באופן מקומי באמצעות כלים מקומיים.

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

• ב-Responses API אפשר למצוא מידע על שילוב SDK פרוגרמטי.
• בודקים את היכולות והמפרטים של המודל ב-OpenAI GPT Models.
• מידע נוסף על מעקב אחר התנהלות פוגעת ואפס שמירת נתונים