Menghubungkan OpenAI Codex ke Google Cloud

Pratinjau Pribadi

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan, dan Persyaratan Tambahan untuk Produk Pratinjau AI Generatif. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Anda dapat mengonfigurasi OpenAI Codex CLI dan Aplikasi Desktop Codex untuk merutekan permintaan model melalui project Google Cloud Anda di Agent Platform.

Codex berjalan secara lokal di workstation pengembangan Anda saat melakukan autentikasi melalui Google Cloud Identity and Access Management (IAM) dan menggunakan kuota Marketplace yang disetujui.

Sebelum memulai

Untuk menggunakan OpenAI Codex dengan Gemini Enterprise Agent Platform, Anda harus menyelesaikan langkah-langkah berikut. Gemini Enterprise Agent Platform API (aiplatform.googleapis.com) harus diaktifkan di project Google Cloud Anda.

Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

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. Selesaikan langkah-langkah aktivasi di Model GPT OpenAI, termasuk membeli produk melalui Google Cloud Marketplace dan mengaktifkan model di Model Garden.

2. Jika kebijakan organisasi Anda membatasi akses model, izinkan model dalam kebijakan tersebut.

3. Instal Google Cloud CLI dan konfigurasikan Kredensial Default Aplikasi (ADC):

   gcloud auth application-default login

4. Instal OpenAI Codex CLI atau Aplikasi Desktop Codex di workstation Anda.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk menghubungkan Codex ke model partner OpenAI, minta administrator untuk memberi Anda peran IAM Agent Platform User (roles/aiplatform.user) pada project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Penyiapan interaktif

Anda dapat mengonfigurasi Codex secara interaktif menggunakan alur login bawaan.

Codex CLI

1. Mulai codex di terminal Anda:

   codex

2. Pilih Sign in another way, lalu pilih Use Google Cloud (ditampilkan sebagai Use Google Cloud Vertex AI di CLI).

3. Masukkan project ID Google Cloud Anda.

4. Masukkan lokasi, atau tekan Enter untuk menerima global.

5. Tekan Enter untuk menggunakan Kredensial Default Aplikasi di komputer Anda, atau masukkan jalur absolut ke file JSON kredensial akun layanan.

Aplikasi Desktop Codex

1. Buka Aplikasi Desktop Codex.
2. Pilih Login dengan cara lain, lalu pilih Gunakan Google Cloud.
3. Masukkan project ID Google Cloud Anda.
4. Masukkan lokasi, atau kosongkan untuk menerima global.
5. Biarkan jalur kredensial kosong untuk menggunakan Kredensial Default Aplikasi, atau pilih file JSON kunci akun layanan.
6. Pilih Lanjutkan, lalu verifikasi koneksi.

Mengonfigurasi Codex secara manual

Untuk mengonfigurasi Codex tanpa perintah interaktif, tambahkan setelan penyedia ke ~/.codex/config.toml. Tempatkan setelan model_provider level teratas sebelum header tabel apa pun:

model_provider = "gcp"

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

Ganti kode berikut:

• <var>PROJECT_ID</var>: Project ID Google Cloud Anda (misalnya, my-project-123).

Jika Anda menggunakan file kunci akun layanan, bukan Kredensial Default Aplikasi, tentukan credential_file:

credential_file = "CREDENTIAL_FILE_PATH"

Ganti kode berikut:

• <var>CREDENTIAL_FILE_PATH</var>: Jalur absolut ke file JSON kunci akun layanan yang didownload (misalnya, /Users/myuser/.config/gcloud/sa-key.json).

Perhatian: Kunci akun layanan dapat menimbulkan risiko keamanan jika disusupi. Jika memungkinkan, gunakan Kredensial Default Aplikasi atau token berumur singkat, alih-alih menyimpan kunci akun layanan di workstation lokal Anda. Untuk informasi selengkapnya, lihat Praktik terbaik untuk mengelola kunci akun layanan.

Variabel lingkungan

Anda juga dapat menggunakan variabel lingkungan di mesin host Codex untuk mengonfigurasi atau mengganti setelan:

• GOOGLE_CLOUD_PROJECT: Menetapkan project ID Google Cloud Anda, sehingga Anda dapat menghilangkan project_id dari config.toml.
• GOOGLE_CLOUD_LOCATION: Mengganti lokasi endpoint (defaultnya adalah global).

Memilih model dan memverifikasi akses

Setelah penyiapan, verifikasi koneksi dan akses model Anda:

1. Mulai sesi baru dengan codex atau buat tugas baru di Codex Desktop.
2. Jalankan /model di CLI atau buka pemilih model di Codex Desktop.
3. Pilih model yang diaktifkan untuk workload Anda:
   • gpt-6.1-sol: Model partner unggulan untuk coding dan alur kerja agentic.
   • gpt-6-luna: Model partner berlatensi rendah untuk bantuan interaktif yang cepat.
   • gpt-6-astra: Model partner dengan kemampuan tertinggi untuk penalaran multi-langkah yang kompleks.
   • gpt-6.1-terra: Model partner yang seimbang untuk otomatisasi throughput tinggi.
4. Kirim perintah pengujian (seperti "List the files in the current directory") untuk mengonfirmasi bahwa autentikasi dan pemrosesan permintaan berhasil.

Dukungan fitur di Codex

Saat terhubung ke Agent Platform, Codex menggunakan OpenAI Responses API. Tabel berikut menguraikan fitur yang didukung dan tidak didukung:

Fitur	Status dukungan	Deskripsi
Eksekusi shell dan bash lokal	Didukung	Codex menjalankan perintah shell secara lokal di mesin pengembangan Anda dalam batas terminal yang disetujui.
Pengeditan dan patching file	Didukung	Codex membaca dan mengubah file secara lokal di workstation Anda.
Model Context Protocol (MCP) Lokal	Didukung	Server MCP lokal yang dikonfigurasi di ~/.codex/config.toml berjalan di workstation Anda.
Pemanggilan fungsi sisi klien	Didukung	Permintaan alat model dievaluasi dan dijalankan secara lokal oleh klien Codex.
Penelusuran web dan penelusuran file yang dihosting	Tidak didukung	Alat penelusuran OpenAI yang dihosting tidak tersedia di endpoint Agent Platform selama Pratinjau Pribadi.
Interpreter Kode yang Dihosting	Tidak didukung	Sandbox cloud jarak jauh yang dihosting oleh OpenAI tidak tersedia. Eksekusi kode berjalan secara lokal menggunakan alat lokal.

Langkah berikutnya

• Pelajari integrasi SDK terprogram di Responses API.
• Tinjau kemampuan dan spesifikasi model di Model GPT OpenAI.
• Pelajari Pemantauan penyalahgunaan dan Retensi data nol.