Connetti OpenAI Codex a Google Cloud

Anteprima privata

Questo prodotto o questa funzionalità sono soggetti ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini di servizio specifici e ai Termini aggiuntivi per i prodotti in anteprima dell'AI generativa. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Puoi configurare l'interfaccia a riga di comando di OpenAI Codex e l'app desktop Codex per instradare le richieste del modello tramite il tuo progetto Google Cloud su Agent Platform.

Codex viene eseguito localmente sulla tua workstation di sviluppo durante l'autenticazione tramiteGoogle Cloud Identity and Access Management (IAM) e l'utilizzo delle quote del Marketplace approvate.

Prima di iniziare

Per utilizzare OpenAI Codex con Gemini Enterprise Agent Platform, devi completare i seguenti passaggi. L'API Gemini Enterprise Agent Platform (aiplatform.googleapis.com) deve essere abilitata nel tuo progetto Google Cloud .

Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei 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. Completa i passaggi di onboarding in Modelli OpenAI GPT, tra cui l'acquisto del prodotto tramite Google Cloud Marketplace e l'abilitazione del modello in Model Garden.

2. Se la policy della tua organizzazione limita l'accesso ai modelli, consenti il modello in questione.

3. Installa l'interfaccia a riga di comando Google Cloud e configura le Credenziali predefinite dell'applicazione (ADC):

   gcloud auth application-default login

4. Installa l'interfaccia a riga di comando di OpenAI Codex o l'app desktop Codex sulla tua workstation.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per connettere Codex ai modelli partner di OpenAI, chiedi all'amministratore di concederti il ruolo IAM Agent Platform User (roles/aiplatform.user) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Configurazione interattiva

Puoi configurare Codex in modo interattivo utilizzando il flusso di accesso integrato.

Interfaccia a riga di comando di Codex

1. Avvia codex nel terminale:

   codex

2. Seleziona Accedi in un altro modo, quindi scegli Utilizza Google Cloud (visualizzato come Utilizza Google Cloud Vertex AI nell'interfaccia a riga di comando).

3. Inserisci l'ID progetto Google Cloud .

4. Inserisci la località o premi Invio per accettare global.

5. Premi Invio per utilizzare le Credenziali predefinite dell'applicazione sul tuo computer o inserisci un percorso assoluto per un file JSON delle credenziali dell'account di servizio.

App desktop Codex

1. Apri l'app desktop Codex.
2. Seleziona Accedi in un altro modo, quindi scegli Utilizza Google Cloud.
3. Inserisci l'ID progetto Google Cloud .
4. Inserisci la località o lascia vuoto il campo per accettare global.
5. Lascia vuoto il percorso delle credenziali per utilizzare le Credenziali predefinite dell'applicazione o seleziona un file JSON della chiave del account di servizio.
6. Seleziona Continua e poi verifica la connessione.

Configura Codex manualmente

Per configurare Codex senza il prompt interattivo, aggiungi le impostazioni del provider a ~/.codex/config.toml. Inserisci l'impostazione model_provider di primo livello prima di qualsiasi intestazione di tabella:

model_provider = "gcp"

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

Sostituisci quanto segue:

• <var>PROJECT_ID</var>: l'ID progetto Google Cloud (ad esempio, my-project-123).

Se utilizzi un file della chiave del account di servizio anziché le credenziali predefinite dell'applicazione, specifica credential_file:

credential_file = "CREDENTIAL_FILE_PATH"

Sostituisci quanto segue:

• <var>CREDENTIAL_FILE_PATH</var>: il percorso assoluto del file JSON della chiave del account di servizio scaricato (ad esempio, /Users/myuser/.config/gcloud/sa-key.json).

Attenzione: le chiavi dei service account possono comportare rischi per la sicurezza se vengono compromesse. Se possibile, utilizza le Credenziali predefinite dell'applicazione o i token di breve durata anziché archiviare le chiavi dei account di servizio sulla tua workstation locale. Per ulteriori informazioni, consulta le best practice per la gestione delle chiavi degli account di servizio.

Variabili di ambiente

Puoi anche utilizzare le variabili di ambiente sulla macchina host Codex per configurare o eseguire l'override delle impostazioni:

• GOOGLE_CLOUD_PROJECT: imposta l'ID progetto Google Cloud , consentendoti di omettere project_id da config.toml.
• GOOGLE_CLOUD_LOCATION: esegue l'override della località dell'endpoint (il valore predefinito è global).

Seleziona i modelli e verifica l'accesso

Dopo la configurazione, verifica la connessione e l'accesso al modello:

1. Avvia una nuova sessione con codex o crea una nuova attività in Codex Desktop.
2. Esegui /model nell'interfaccia a riga di comando o apri il selettore di modelli in Codex Desktop.
3. Seleziona un modello abilitato per il tuo workload:
   • gpt-6.1-sol: modello partner di punta per la programmazione e gli Agentic Workflow.
   • gpt-6-luna: modello partner a bassa latenza per un'assistenza interattiva rapida.
   • gpt-6-astra: il modello partner più avanzato per ragionamenti complessi multi-step.
   • gpt-6.1-terra: modello di partner bilanciato per l'automazione ad alto throughput.
4. Invia un prompt di test (ad esempio "Elenca i file nella directory corrente") per confermare che l'autenticazione e l'elaborazione della richiesta siano andate a buon fine.

Supporto delle funzionalità in Codex

Quando è connesso ad Agent Platform, Codex utilizza l'API OpenAI Responses. La tabella seguente illustra le funzionalità supportate e non supportate:

Funzionalità	Stato del supporto	Descrizione
Esecuzione di shell e bash locali	Supportato	Codex esegue i comandi della shell localmente sulla tua macchina di sviluppo entro i limiti del terminale approvati.
Modifica e applicazione di patch ai file	Supportato	Codex legge e modifica i file localmente sulla tua workstation.
Model Context Protocol (MCP) locale	Supportato	I server MCP locali configurati in ~/.codex/config.toml vengono eseguiti sulla tua workstation.
Chiamata di funzione lato client	Supportato	Le richieste degli strumenti del modello vengono valutate ed eseguite localmente dal client Codex.
Ricerca web e ricerca file in hosting	Non supportata	Gli strumenti di ricerca OpenAI in hosting non sono disponibili sugli endpoint di Agent Platform durante l'anteprima privata.
Interprete codice in hosting	Non supportata	Le sandbox cloud remote ospitate da OpenAI non sono disponibili. L'esecuzione di codice viene eseguita localmente utilizzando strumenti locali.

Passaggi successivi

• Esplora l'integrazione dell'SDK di pubblicità programmatica nell'API Responses.
• Esamina le funzionalità e le specifiche del modello in Modelli OpenAI GPT.
• Scopri di più sul monitoraggio degli abusi e sulla conservazione dei dati pari a zero.