Dokumentasi ChatGPT
Bahasa Indonesia
Hubungi kami goolvyouyou@gmail.com

Menggunakan ChatGPT Work dan Codex dengan Amazon Bedrock

Konfigurasikan antarmuka lokal ChatGPT Work dan Codex agar menggunakan model OpenAI yang tersedia melalui Amazon Bedrock.

Konfigurasikan antarmuka lokal ChatGPT Work dan Codex agar menggunakan model OpenAI yang tersedia melalui Amazon Bedrock. Dalam penyiapan ini, klien lokal mengirimkan permintaan model ke Bedrock menggunakan autentikasi dan kontrol akses yang dikelola AWS.

Cara kerjanya

Saat Anda mengonfigurasi antarmuka lokal ChatGPT Work atau Codex dengan Amazon Bedrock sebagai penyedia model, Responses API yang di-host OpenAI tidak berada dalam jalur permintaan. Klien lokal mengirimkan permintaan model ke Amazon Bedrock, dan Bedrock menyediakan implementasi Responses API yang kompatibel dengan OpenAI untuk model OpenAI yang didukung.

Sebelum memulai

Pastikan Anda memiliki:

  • Akses ke model OpenAI yang didukung di Amazon Bedrock.
  • AWS Region tempat model yang dipilih tersedia.
  • Autentikasi untuk jalur Amazon Bedrock Mantle yang telah dikonfigurasi untuk akun AWS.

Mengonfigurasi penyedia

Tambahkan penyedia model amazon-bedrock untuk jalur Amazon Bedrock Mantle ke ~/.codex/config.toml. Aplikasi desktop ChatGPT, Codex CLI, ekstensi IDE, dan SDK membaca lapisan konfigurasi lokal yang sama. Menentukan model bersifat opsional. Pilih model yang didukung secara eksplisit bila diperlukan.

model_provider = "amazon-bedrock"

Opsi autentikasi

Antarmuka lokal ChatGPT Work dan Codex mendukung dua jalur autentikasi Bedrock. Keduanya diperiksa dalam urutan berikut:

  1. API key Bedrock.
  2. Rantai kredensial AWS SDK.

Opsi 1: API key Bedrock

Tetapkan API key Bedrock di lingkungan yang dibaca klien lokal. Anda harus menentukan Region saat menggunakan autentikasi API key.

export AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>
export AWS_REGION=us-east-2

Opsi 2: Kredensial AWS SDK

Gunakan jalur ini jika organisasi Anda mengelola akses Bedrock melalui rantai kredensial AWS SDK. Klien lokal dapat menggunakan sumber kredensial AWS SDK standar berikut:

File konfigurasi AWS bersama

Konfigurasikan file AWS bersama config dan credentials:

aws configure

Variabel lingkungan

Tetapkan variabel lingkungan kredensial AWS SDK standar:

export AWS_ACCESS_KEY_ID=<your-access-key-id>
export AWS_SECRET_ACCESS_KEY=<your-secret-access-key>
export AWS_SESSION_TOKEN=<your-session-token>

Kredensial AWS Management Console

Masuk dengan kredensial AWS Management Console:

aws login

AWS SSO atau profil bernama

Masuk dengan AWS SSO dan pilih profil bernama:

aws sso login --profile codex-bedrock
export AWS_PROFILE=codex-bedrock

Identitas terfederasi

Untuk SSO perusahaan atau federasi OIDC, konfigurasikan identitas terfederasi dengan credential_process di luar klien lokal dan biarkan AWS SDK menguraikan kredensial. Tempatkan proses masuk browser, pertukaran token, caching, dan penyegaran di pembantu credential_process milik profil AWS Anda.

Aplikasi desktop dan ekstensi IDE

Aplikasi desktop dan ekstensi IDE mungkin tidak mewarisi variabel lingkungan dari shell. Tempatkan nilai yang diperlukan di ~/.codex/.env, lalu mulai ulang aplikasi atau ekstensi.

export AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>
export AWS_REGION=us-east-2

Memverifikasi penyiapan

  • Di Codex CLI, buka /status dan pastikan Codex menggunakan penyedia model amazon-bedrock.
  • Di aplikasi desktop ChatGPT, pilih Work atau Codex dan mulai tugas baru setelah memulai ulang aplikasi.
  • Di ekstensi IDE, mulai sesi baru setelah memulai ulang ekstensi.
  • Pastikan model yang dipilih tersedia di AWS Region yang dikonfigurasi dan identitas AWS memiliki izin untuk mengaksesnya.

Model yang didukung

Gunakan ID model yang tepat:

openai.gpt-5.6-sol
openai.gpt-5.6-terra
openai.gpt-5.6-luna
openai.gpt-5.5
openai.gpt-5.4

Ketersediaan model berbeda-beda menurut AWS Region. Sebelum memilih model, lihat dukungan model menurut AWS Region.

Ketersediaan fitur

Konfigurasi ini mendukung alur kerja lokal ChatGPT Work dan Codex. ChatGPT Work yang di-host di web, cloud Codex, serta fitur yang bergantung pada layanan cloud yang di-host OpenAI, alat yang di-host, atau penemuan yang dikelola cloud saat ini tidak tersedia.

* Fitur saat ini terbatas hanya untuk region tertentu. Periksa dokumentasi masing-masing fitur untuk mempelajari lebih lanjut tentang pembatasan geografis.
† Bundel plugin lokal didukung jika kapabilitasnya tidak memerlukan autentikasi ChatGPT. Penemuan plugin yang dikurasi OpenAI dan fitur yang bergantung pada konektor atau berbagi melalui cloud tidak tersedia.

Pemecahan masalah

Jika penyiapan gagal, periksa hal berikut:

  • ID model sama persis dengan model yang didukung.
  • Anda menentukan AWS Region tempat model tersedia.
  • API key Bedrock atau kredensial AWS valid dan belum kedaluwarsa.
  • Identitas AWS memiliki izin untuk mengakses model Bedrock yang dipilih.
  • AWS_BEARER_TOKEN_BEDROCK tidak ditetapkan ke kunci yang kedaluwarsa atau tidak dimaksudkan.
  • Untuk penggunaan aplikasi desktop atau ekstensi IDE, variabel lingkungan yang diperlukan tersedia di ~/.codex/.env.

Batas dukungan

Dukungan OpenAI dapat membantu terkait penyiapan klien ChatGPT Work dan Codex, konfigurasi, perilaku CLI lokal, perilaku aplikasi desktop, perilaku ekstensi IDE, dan pengalaman produk lokal.

Untuk kredensial AWS, izin IAM, akses model Bedrock, kuota, penagihan, ketersediaan regional, kegagalan permintaan Bedrock, log layanan AWS, atau perilaku layanan Bedrock, hubungi administrator AWS pelanggan atau Dukungan AWS.