Conecta OpenAI Codex a Cloud de Confiance by S3NS

Puedes configurar la CLI de OpenAI Codex y la app para computadoras de Codex para enrutar las solicitudes de modelos a través de tu proyecto de Cloud de Confiance en Agent Platform.

Codex se ejecuta de forma local en tu estación de trabajo de desarrollo mientras se autentica a través de Cloud de Confiance Identity and Access Management (IAM) y usa tus cuotas aprobadas de Marketplace.

Antes de comenzar

Para usar OpenAI Codex con Gemini Enterprise Agent Platform, debes completar los siguientes pasos. La API de Gemini Enterprise Agent Platform (aiplatform.googleapis.com) debe estar habilitada en tu proyecto de Cloud de Confiance .

1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance 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

2. Verify that billing is enabled for your Cloud de Confiance project.

3. 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

4. Completa los pasos de incorporación en Modelos de GPT de OpenAI, lo que incluye comprar el producto a través de Google Cloud Marketplace y habilitar el modelo en Model Garden.

5. Si la política de tu organización restringe el acceso al modelo, permite el modelo en esa política.

6. Instala la CLI de Cloud de Confiance y configura las credenciales predeterminadas de la aplicación (ADC):

   gcloud auth application-default login

7. Instala la CLI de OpenAI Codex o la app para computadoras de Codex en tu estación de trabajo.

Roles obligatorios

Para obtener los permisos que necesitas para conectar Codex a los modelos de socios de OpenAI, pídele a tu administrador que te otorgue el rol de IAM de usuario de la plataforma de agentes (roles/aiplatform.user) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Configuración interactiva

Puedes configurar Codex de forma interactiva con el flujo de acceso integrado.

CLI de Codex

1. Inicia codex en tu terminal:

   codex

2. Selecciona Acceder de otra manera y, luego, elige Usar Google Cloud (se muestra como Usar Google Cloud Vertex AI en la CLI).

3. Ingresa el ID de tu proyecto de Cloud de Confiance .

4. Ingresa la ubicación o presiona Intro para aceptar global.

5. Presiona Intro para usar las credenciales predeterminadas de la aplicación en tu computadora o ingresa una ruta de acceso absoluta a un archivo JSON de credenciales de cuenta de servicio.

App para computadoras de Codex

1. Abre la app de Codex para computadoras.
2. Selecciona Acceder de otra manera y, luego, Usar Google Cloud.
3. Ingresa el ID de tu proyecto de Cloud de Confiance .
4. Ingresa la ubicación o déjala en blanco para aceptar global.
5. Deja la ruta de acceso de la credencial en blanco para usar las credenciales predeterminadas de la aplicación o selecciona un archivo JSON de clave de cuenta de servicio.
6. Selecciona Continuar y, luego, verifica la conexión.

Configura Codex de forma manual

Para configurar Codex sin el mensaje interactivo, agrega la configuración del proveedor a ~/.codex/config.toml. Coloca el parámetro de configuración model_provider de nivel superior antes de cualquier encabezado de tabla:

model_provider = "gcp"

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

Reemplaza lo siguiente:

• <var>PROJECT_ID</var>: Es el ID del proyecto de Cloud de Confiance (por ejemplo, my-project-123).

Si usas un archivo de claves de cuenta de servicio en lugar de las credenciales predeterminadas de la aplicación, especifica credential_file:

credential_file = "CREDENTIAL_FILE_PATH"

Reemplaza lo siguiente:

• <var>CREDENTIAL_FILE_PATH</var>: Es la ruta de acceso absoluta al archivo JSON de la clave de la cuenta de servicio que descargaste (por ejemplo, /Users/myuser/.config/gcloud/sa-key.json).

Variables de entorno

También puedes usar variables de entorno en la máquina anfitrión de Codex para establecer o anular tu configuración:

• GOOGLE_CLOUD_PROJECT: Establece el ID del proyecto de Cloud de Confiance , lo que te permite omitir project_id de config.toml.
• GOOGLE_CLOUD_LOCATION: Anula la ubicación del extremo (el valor predeterminado es global).

Selecciona modelos y verifica el acceso

Después de la configuración, verifica la conexión y el acceso al modelo:

1. Inicia una nueva sesión con codex o crea una nueva tarea en Codex Desktop.
2. Ejecuta /model en la CLI o abre el selector de modelos en Codex Desktop.
3. Selecciona un modelo habilitado para tu carga de trabajo:
   • gpt-6.1-sol: Es el modelo de socio insignia para la programación y los flujos de trabajo de agentes.
   • gpt-6-luna: Es un modelo de socio de baja latencia para obtener asistencia interactiva rápida.
   • gpt-6-astra: Es el modelo de socio con mayor capacidad para el razonamiento complejo de varios pasos.
   • gpt-6.1-terra: Modelo de socio equilibrado para la automatización de alta capacidad de procesamiento.
4. Envía una instrucción de prueba (como "Enumera los archivos del directorio actual") para confirmar que la autenticación y el procesamiento de la solicitud se realizaron correctamente.

Compatibilidad de funciones en Codex

Cuando se conecta a Agent Platform, Codex usa la API de respuestas de OpenAI. En la siguiente tabla, se describen las funciones compatibles y no compatibles:

¿Qué sigue?

• Explora la integración programática del SDK en la API de Responses.
• Revisa las capacidades y especificaciones de los modelos en Modelos de GPT de OpenAI.
• Obtén más información sobre la supervisión de abusos y la retención de datos cero.