OpenAI
Halaman ini diterjemahkan oleh mesin. Lihat artikel asli dalam bahasa Inggris.

Menggunakan Daybreak di Codex CLI

Gunakan panduan ini untuk mengaktifkan Daybreak di Codex CLI, mengonfigurasinya untuk alur kerja otomatis dan integrasi SDK, serta mengatasi masalah akses atau penolakan. 

Diperbarui: 8 days ago

Untuk mengakses perubahan ini, Anda perlu memperbarui Codex CLI ke versi 0.163.0 atau yang lebih baru. Pembaruan CLI bersifat opsional: instalasi yang ada akan tetap berfungsi seperti sebelumnya sampai Anda memperbaruinya.

  • Jika otomatisasi Anda menginstal @openai/codex@latest, perubahan ini dapat diterapkan pada instalasi atau pembaruan berikutnya. Jika Anda menginstal Codex CLI secara global dengan npm, jalankan npm install -g @openai/codex@latest, lalu jalankan codex --version untuk memastikan pembaruan berhasil.

  • Untuk menunda perubahan ini, kunci versi ke @openai/codex@0.162.0. Instalasi satu kali menggunakan @latest tidak akan diperbarui secara otomatis. Alur kerja yang dikunci ke versi lama akan tetap berfungsi seperti sebelumnya.

  • Untuk integrasi TypeScript, perbarui @openai/codex-sdk beserta runtime yang disertakan. Untuk integrasi Python, perbarui openai-codex beserta runtime Codex-nya. Memperbarui CLI global saja belum tentu memperbarui runtime SDK. Jika Anda mengonfigurasi jalur file eksekusi khusus, perbarui juga file eksekusi tersebut.

ID model yang dikonfigurasi secara manual tetapi tidak tercantum dalam katalog yang tersedia akan tetap ditangani secara otomatis seperti sebelumnya di CLI dan Codex Desktop, meskipun Daybreak AKTIF. Tidak tercantumnya ID tersebut dalam katalog saja tidak menghalangi keberhasilan permintaan. 

Ketersediaan model siber di pemilih model dapat diluncurkan secara terpisah. Setelah diaktifkan, pengguna yang sudah menggunakan rilis yang didukung tidak perlu mengunduh lagi untuk melihat model yang baru tersedia. Buka kembali pemilih model atau mulai ulang Codex untuk menyegarkan daftar.

Mengaktifkan Daybreak di CLI interaktif

  1. Jalankan Codex dengan autentikasi yang biasa Anda gunakan.

  2. Untuk mengaktifkan Daybreak, masukkan /daybreak.

  3. Codex akan menampilkan Daybreak aktif. Berlaku untuk giliran baru.

  4. Pengaturan ini akan berlaku untuk utas aktif dan disimpan sebagai default untuk sesi baru.

  5. Untuk menonaktifkan Daybreak, jalankan kembali perintah yang sama (/daybreak).

Mengaktifkan Daybreak di CLI tanpa antarmuka

Alur kerja tanpa antarmuka berjalan tanpa UI interaktif, biasanya melalui codex exec dalam skrip, tugas terjadwal, atau CI. Tidak ada pesan interaktif “Aktifkan Daybreak” (/daybreak) di sini. Sebagai gantinya, Anda dapat:

  1. Mengaktifkan Daybreak untuk eksekusi CLI tertentu dengan menambahkan -c daybreak=true ke setiap perintah yang harus dijalankan dengan penolakan yang dikurangi. Misalnya, Anda dapat memasukkan:

codex exec -c daybreak=true "Review the changes in this repository."

  1. Pertahankan prompt dan opsi perintah lain yang sudah Anda gunakan. Tambahkan pengaturan ini pada setiap pemanggilan yang harus menggunakan Daybreak, termasuk perintah dalam skrip, tugas terjadwal, dan konfigurasi CI.

  2. Menjadikan Daybreak sebagai default untuk sesi dan eksekusi CLI baru dengan menambahkan daybreak=true ke file konfigurasi yang dimuat oleh Codex.

  3. Konfigurasi pengguna default berada di ~/.codex/config.toml. Jika otomatisasi Anda mengatur CODEX_HOME, gunakan $CODEX_HOME/config.toml sebagai gantinya. Letakkan pengaturan ini di tingkat teratas, di luar bagian seperti [features].

  4. Lakukan perubahan di lingkungan tempat otomatisasi benar-benar dijalankan. Memperbarui konfigurasi laptop Anda tidak memperbarui runner CI atau mesin jarak jauh.

  5. Pengaturan ini juga berlaku untuk sesi interaktif baru yang menggunakan konfigurasi yang sama. Sesi yang dilanjutkan dan sesi hasil percabangan tetap menggunakan pilihan Daybreak yang tersimpan; pengaturan default baru tidak menggantikannya.

  6. Perlu diketahui bahwa pengaturan baris perintah menimpa konfigurasi yang tersimpan untuk pemanggilan tersebut. Karena itu, Anda dapat tetap menyimpan daybreak = true dalam konfigurasi dan menggunakan -c daybreak=false untuk satu eksekusi tertentu.

Mengaktifkan Daybreak melalui SDK TypeScript

Teruskan pengaturan Daybreak melalui konfigurasi klien:

import { Codex } from "@openai/codex-sdk";

const codex = new Codex({

  config: { daybreak: true },

});

const thread = codex.startThread();

const result = await thread.run("Review the changes in this repository.");

console.log(result.finalResponse);

Gunakan daybreak: false untuk menonaktifkan Daybreak dan menerapkan perilaku penolakan normal. Pertahankan konfigurasi autentikasi yang sudah Anda gunakan.

Mengaktifkan Daybreak melalui server aplikasi atau SDK Python

1. Baca nilai availableAccessPrograms.cyber untuk model yang dipilih dari model/list, lalu atur cyberAccessProgram dalam parameter turn/start.

a. Untuk model utama dan akun dengan akses Daybreak Blue:

{ "cyberAccessProgram": "daybreakBlue" }

b. Untuk model siber dan akun dengan akses Daybreak Red:

{ "cyberAccessProgram": "daybreakRed" }

c. Untuk perilaku penolakan normal:

{ "cyberAccessProgram": "standard" }

2. Sertakan pilihan ini pada setiap giliran yang harus menggunakannya; jangan berasumsi bahwa menghilangkan parameter akan menonaktifkan Daybreak. Klien yang terhubung langsung ke server aplikasi harus mengaktifkan kapabilitas experimentalApi saat inisialisasi agar dapat menggunakan parameter ini.

3. CodexClient tingkat rendah pada SDK Python dapat meneruskan parameter yang sama:

from openai_codex.client import CodexClient

with CodexClient() as client:

client.initialize()

thread = client.thread_start()

turn = client.turn_start(

thread.thread.id,

"Review the changes in this repository.",

params={"cyberAccessProgram": "daybreakBlue"},

)

client.wait_for_turn_completed(turn.turn.id)

4. Contoh ini mengasumsikan bahwa Daybreak Blue tersedia untuk model yang dipilih. Klien Python mengaktifkan kapabilitas API eksperimental secara default. Preferensi utas yang tersimpan saja tidak menentukan program untuk giliran di server aplikasi.

Jika Anda menambahkan katalog model lokal sebelum perubahan ini

Jika sebelumnya model yang Anda harapkan tidak muncul saat masuk dengan kunci API, Anda mungkin telah menambahkan katalog lokal menggunakan model_catalog_json di config.toml. Codex menggunakan file lokal tersebut, bukan katalog otomatis, sehingga daftar model Anda bisa menjadi usang. Setelah dukungan katalog otomatis tersedia di lingkungan Anda, ikuti langkah-langkah berikut untuk beralih kembali:

  1. Buka config.toml. Untuk Codex CLI, buka ~/.codex/config.toml (atau $CODEX_HOME/config.toml jika Anda mengatur CODEX_HOME). Di Codex Desktop, buka Pengaturan > Konfigurasi, lalu pilih Buka config.toml.

  2. Nonaktifkan katalog lokal untuk sementara. Tambahkan # di awal baris model_catalog_json, simpan file, lalu mulai ulang Codex dengan akun atau kunci API yang sama. Biarkan URL katalog yang diwajibkan oleh organisasi Anda tetap terpasang.

  3. Verifikasi akses Anda. Di CLI, jalankan codex, lalu masukkan /daybreak dalam sesi tersebut. Di Desktop, buka pemilih model Lanjutan dan aktifkan Daybreak. Jika Anda memiliki akses Daybreak Red, pastikan model siber yang diharapkan muncul dan Anda dapat mengirim permintaan menggunakan model tersebut.

  4. Pertahankan konfigurasi yang berfungsi. Jika pemeriksaan berhasil, hapus baris yang Anda nonaktifkan dan simpan file. Jika gagal, hapus #, simpan, lalu mulai ulang Codex untuk memulihkan pengaturan sebelumnya.

Mengatasi penolakan di CLI

  • Jalankan tugas yang mewakili beban kerja Anda dengan kredensial, model, dan konfigurasi yang sama dengan yang digunakan oleh otomatisasi Anda.

  • Jika Daybreak tidak tersedia, pastikan bahwa:

    • Akun atau proyek API Anda memiliki akses Daybreak.

    • Model yang dipilih mendukung Daybreak.

  • Di CLI interaktif, pastikan Daybreak aktif. CLI interaktif dapat menampilkan pesan penolakan ketika Daybreak tersedia tetapi NONAKTIF: Daybreak saat ini nonaktif. Jika Anda melakukan pekerjaan keamanan yang diizinkan, aktifkan Daybreak dan coba kirim permintaan Anda lagi.

    • Pesan konfirmasi akan menanyakan Aktifkan Daybreak untuk permintaan Anda berikutnya? dan menawarkan pilihan Aktifkan Daybreak atau Jangan sekarang.

    • Pilih Aktifkan Daybreak untuk mengaktifkannya bagi permintaan berikutnya, lalu coba kirim permintaan tersebut lagi. Perlu diketahui bahwa permintaan yang ditolak tidak dicoba ulang secara otomatis; Anda harus mengirimkannya lagi. Beberapa permintaan mungkin tetap ditolak meskipun Daybreak AKTIF.

    • Pilih Jangan sekarang agar Daybreak tetap NONAKTIF.

  • Untuk otomatisasi, pastikan daybreak=true diteruskan ke proses Codex yang benar-benar dijalankan dan tidak ditimpa oleh pengaturan baris perintah lainnya.

Apakah artikel ini membantu?