OpenAI Codex를 Cloud de Confiance by S3NS에 연결

Agent Platform의 Cloud de Confiance 프로젝트를 통해 모델 요청을 라우팅하도록 OpenAI Codex CLI 및 Codex 데스크톱 앱을 구성할 수 있습니다.

Codex는 개발 워크스테이션에서 로컬로 실행되며,Cloud de Confiance Identity and Access Management(IAM)를 통해 인증하고 승인된 Marketplace 할당량을 사용합니다.

시작하기 전에

Gemini Enterprise Agent Platform에서 OpenAI Codex를 사용하려면 다음 단계를 완료해야 합니다. Cloud de Confiance 프로젝트에서 Gemini Enterprise Agent Platform API(aiplatform.googleapis.com)를 사용 설정해야 합니다.

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. Google Cloud Marketplace를 통해 제품을 구매하고 Model Garden에서 모델을 사용 설정하는 등 OpenAI GPT 모델의 온보딩 단계를 완료합니다.

5. 조직의 정책에서 모델 액세스를 제한하는 경우 해당 정책에서 모델을 허용합니다.

6. Cloud de Confiance CLI를 설치하고 애플리케이션 기본 사용자 인증 정보(ADC)를 구성합니다.

   gcloud auth application-default login

7. 워크스테이션에 OpenAI Codex CLI 또는 Codex 데스크톱 앱을 설치합니다.

필요한 역할

Codex를 OpenAI 파트너 모델에 연결하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 에이전트 플랫폼 사용자(roles/aiplatform.user) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

대화형 설정

기본 제공 로그인 흐름을 사용하여 Codex를 대화형으로 구성할 수 있습니다.

Codex CLI

1. 터미널에서 codex를 시작합니다.

   codex

2. 다른 방법으로 로그인을 선택한 다음 Google Cloud 사용(CLI에서 Google Cloud Vertex AI 사용으로 표시됨)을 선택합니다.

3. Cloud de Confiance 프로젝트 ID를 입력합니다.

4. 위치를 입력하거나 Enter 키를 눌러 global를 수락합니다.

5. Enter 키를 눌러 컴퓨터에서 애플리케이션 기본 사용자 인증 정보를 사용하거나 서비스 계정 사용자 인증 정보 JSON 파일의 절대 경로를 입력합니다.

Codex 데스크톱 앱

1. Codex 데스크톱 앱을 엽니다.
2. 다른 방법으로 로그인을 선택한 다음 Google Cloud 사용을 선택합니다.
3. Cloud de Confiance 프로젝트 ID를 입력합니다.
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>: Cloud de Confiance 프로젝트 ID(예: my-project-123)

애플리케이션 기본 사용자 인증 정보 대신 서비스 계정 키 파일을 사용하는 경우 credential_file를 지정합니다.

credential_file = "CREDENTIAL_FILE_PATH"

다음을 바꿉니다.

• <var>CREDENTIAL_FILE_PATH</var>: 다운로드한 서비스 계정 키 JSON 파일의 절대 경로(예: /Users/myuser/.config/gcloud/sa-key.json)

환경 변수

Codex 호스트 머신에서 환경 변수를 사용하여 설정을 구성하거나 재정의할 수도 있습니다.

• GOOGLE_CLOUD_PROJECT: Cloud de Confiance 프로젝트 ID를 설정하여 config.toml에서 project_id를 생략할 수 있습니다.
• GOOGLE_CLOUD_LOCATION: 엔드포인트 위치를 재정의합니다(기본값: global).

모델 선택 및 액세스 확인

설정 후 연결 및 모델 액세스를 확인합니다.

1. codex님과 새 세션을 시작하거나 Codex Desktop에서 새 작업을 만드세요.
2. CLI에서 /model를 실행하거나 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를 사용합니다. 다음 표에는 지원되는 기능과 지원되지 않는 기능이 나와 있습니다.

다음 단계

• Responses API에서 프로그래매틱 SDK 통합을 살펴봅니다.
• OpenAI GPT 모델에서 모델 기능 및 사양을 검토합니다.
• 악용 모니터링 및 데이터 보관 없음에 대해 알아보세요.